-
Notifications
You must be signed in to change notification settings - Fork 25.6k
Glossary update, Closes Issue #16891 #29127
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 1 commit
9d28ba1
d28152e
a14b6c7
6d091ff
f57cb47
69a9fc3
2c40605
b5024e8
5bc957a
3813c91
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -61,6 +61,16 @@ | |
| `object`. The mapping also allows you to define (amongst other things) | ||
| how the value for a field should be analyzed. | ||
|
|
||
| [[glossary-filter]] filter :: | ||
|
|
||
| A filter is kind of query known as a "non-scoring" query. It does not give a score, | ||
| it is only concerned about answering the question - "Does this document match?". | ||
| The answer is always a simple, binary yes|no. This kind of query is said to be made | ||
|
||
| in a "filtering" context, hence it is called a filter. Filtering queries/Filters are | ||
|
||
| simple checks for set inclusion/exclusion. The goal of filtering is to reduce the | ||
|
||
| number of documents that have to be examined, as it is in the case of | ||
| <<glossary-query,scoring queries>>. | ||
|
||
|
|
||
| [[glossary-index]] index :: | ||
|
|
||
| An index is like a _table_ in a relational database. It has a | ||
|
|
@@ -105,6 +115,19 @@ | |
| + | ||
| See also <<glossary-routing,routing>> | ||
|
|
||
| [[glossary-query]] query :: | ||
|
|
||
| Query refers to all queries which not only determine if a document matches, | ||
|
||
| but also calculate how well the document matches. This calculation is refered | ||
| to as scoring, hence these queries are also known as "scoring queries". | ||
| A scoring query calculates how relevant each document is to the query, and assigns | ||
|
||
| it a relevance _score, which is later used to sort matching documents by relevance. | ||
|
||
| This concept of relevance is well suited to full-text search, where there is seldom a | ||
|
||
| completely “correct” answer. These queries are more heavier than | ||
|
||
| <<glossary-filter,filters/non scoring queries>> and their query results are not cacheable. | ||
|
||
| As a general rule, use query clauses for full-text search or for any condition that should | ||
| affect the relevance score, and use filters for everything else. | ||
|
||
|
|
||
| [[glossary-replica-shard]] replica shard :: | ||
|
|
||
| Each <<glossary-primary-shard,primary shard>> can have zero or more | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is correct, but could you make it clearer from the beginning that a "filter" is a normal query, just one that doesn't score? You already say this, but in the current order the definition isn't as clear as it could be. I think this just needs a little rephrasing.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
also: "is a kind" if you leave that part in anywhere.