WARNING: Version 2.3 of Elasticsearch has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
search_analyzer
editsearch_analyzer
editUsually, the same analyzer should be applied at index time and at search time, to ensure that the terms in the query are in the same format as the terms in the inverted index.
Sometimes, though, it can make sense to use a different analyzer at search
time, such as when using the edge_ngram
tokenizer for autocomplete.
By default, queries will use the analyzer
defined in the field mapping, but
this can be overridden with the search_analyzer
setting:
PUT /my_index { "settings": { "analysis": { "filter": { "autocomplete_filter": { "type": "edge_ngram", "min_gram": 1, "max_gram": 20 } }, "analyzer": { "autocomplete": { "type": "custom", "tokenizer": "standard", "filter": [ "lowercase", "autocomplete_filter" ] } } } }, "mappings": { "my_type": { "properties": { "text": { "type": "string", "analyzer": "autocomplete", "search_analyzer": "standard" } } } } } PUT my_index/my_type/1 { "text": "Quick Brown Fox" } GET my_index/_search { "query": { "match": { "text": { "query": "Quick Br", "operator": "and" } } } }
Analysis settings to define the custom |
|
The |
|
This field is indexed as the terms: [ |
|
The query searches for both of these terms: [ |
See Index time search-as-you- type for a full explanation of this example.
The search_analyzer
setting must have the same setting for fields of
the same name in the same index. Its value can be updated on existing fields
using the PUT mapping API.