2013-08-28 19:24:34 -04:00
|
|
|
[[analysis-standard-analyzer]]
|
2020-06-26 10:17:01 -04:00
|
|
|
=== Standard analyzer
|
|
|
|
++++
|
|
|
|
<titleabbrev>Standard</titleabbrev>
|
|
|
|
++++
|
2013-08-28 19:24:34 -04:00
|
|
|
|
2016-05-11 08:17:56 -04:00
|
|
|
The `standard` analyzer is the default analyzer which is used if none is
|
|
|
|
specified. It provides grammar based tokenization (based on the Unicode Text
|
|
|
|
Segmentation algorithm, as specified in
|
|
|
|
http://unicode.org/reports/tr29/[Unicode Standard Annex #29]) and works well
|
|
|
|
for most languages.
|
|
|
|
|
2020-07-23 12:42:33 -04:00
|
|
|
[discrete]
|
2016-05-11 08:17:56 -04:00
|
|
|
=== Example output
|
|
|
|
|
2019-09-09 13:38:14 -04:00
|
|
|
[source,console]
|
2016-05-11 08:17:56 -04:00
|
|
|
---------------------------
|
|
|
|
POST _analyze
|
|
|
|
{
|
|
|
|
"analyzer": "standard",
|
|
|
|
"text": "The 2 QUICK Brown-Foxes jumped over the lazy dog's bone."
|
|
|
|
}
|
|
|
|
---------------------------
|
|
|
|
|
2016-05-19 13:42:23 -04:00
|
|
|
/////////////////////
|
|
|
|
|
2019-09-06 09:22:08 -04:00
|
|
|
[source,console-result]
|
2016-05-19 13:42:23 -04:00
|
|
|
----------------------------
|
|
|
|
{
|
|
|
|
"tokens": [
|
|
|
|
{
|
|
|
|
"token": "the",
|
|
|
|
"start_offset": 0,
|
|
|
|
"end_offset": 3,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 0
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "2",
|
|
|
|
"start_offset": 4,
|
|
|
|
"end_offset": 5,
|
|
|
|
"type": "<NUM>",
|
|
|
|
"position": 1
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "quick",
|
|
|
|
"start_offset": 6,
|
|
|
|
"end_offset": 11,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 2
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "brown",
|
|
|
|
"start_offset": 12,
|
|
|
|
"end_offset": 17,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 3
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "foxes",
|
|
|
|
"start_offset": 18,
|
|
|
|
"end_offset": 23,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 4
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "jumped",
|
|
|
|
"start_offset": 24,
|
|
|
|
"end_offset": 30,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 5
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "over",
|
|
|
|
"start_offset": 31,
|
|
|
|
"end_offset": 35,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 6
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "the",
|
|
|
|
"start_offset": 36,
|
|
|
|
"end_offset": 39,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 7
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "lazy",
|
|
|
|
"start_offset": 40,
|
|
|
|
"end_offset": 44,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 8
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "dog's",
|
|
|
|
"start_offset": 45,
|
|
|
|
"end_offset": 50,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 9
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "bone",
|
|
|
|
"start_offset": 51,
|
|
|
|
"end_offset": 55,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 10
|
|
|
|
}
|
|
|
|
]
|
|
|
|
}
|
|
|
|
----------------------------
|
|
|
|
|
|
|
|
/////////////////////
|
|
|
|
|
|
|
|
|
2016-05-11 08:17:56 -04:00
|
|
|
The above sentence would produce the following terms:
|
|
|
|
|
|
|
|
[source,text]
|
|
|
|
---------------------------
|
|
|
|
[ the, 2, quick, brown, foxes, jumped, over, the, lazy, dog's, bone ]
|
|
|
|
---------------------------
|
|
|
|
|
2020-07-23 12:42:33 -04:00
|
|
|
[discrete]
|
2016-05-11 08:17:56 -04:00
|
|
|
=== Configuration
|
|
|
|
|
|
|
|
The `standard` analyzer accepts the following parameters:
|
|
|
|
|
|
|
|
[horizontal]
|
|
|
|
`max_token_length`::
|
|
|
|
|
|
|
|
The maximum token length. If a token is seen that exceeds this length then
|
|
|
|
it is split at `max_token_length` intervals. Defaults to `255`.
|
|
|
|
|
|
|
|
`stopwords`::
|
|
|
|
|
|
|
|
A pre-defined stop words list like `_english_` or an array containing a
|
2019-04-15 08:09:46 -04:00
|
|
|
list of stop words. Defaults to `_none_`.
|
2016-05-11 08:17:56 -04:00
|
|
|
|
|
|
|
`stopwords_path`::
|
|
|
|
|
|
|
|
The path to a file containing stop words.
|
|
|
|
|
|
|
|
See the <<analysis-stop-tokenfilter,Stop Token Filter>> for more information
|
|
|
|
about stop word configuration.
|
|
|
|
|
|
|
|
|
2020-07-23 12:42:33 -04:00
|
|
|
[discrete]
|
2016-05-11 08:17:56 -04:00
|
|
|
=== Example configuration
|
|
|
|
|
|
|
|
In this example, we configure the `standard` analyzer to have a
|
|
|
|
`max_token_length` of 5 (for demonstration purposes), and to use the
|
|
|
|
pre-defined list of English stop words:
|
|
|
|
|
2019-09-09 13:38:14 -04:00
|
|
|
[source,console]
|
2016-05-11 08:17:56 -04:00
|
|
|
----------------------------
|
2020-07-27 15:58:26 -04:00
|
|
|
PUT my-index-000001
|
2016-05-11 08:17:56 -04:00
|
|
|
{
|
|
|
|
"settings": {
|
|
|
|
"analysis": {
|
|
|
|
"analyzer": {
|
|
|
|
"my_english_analyzer": {
|
|
|
|
"type": "standard",
|
|
|
|
"max_token_length": 5,
|
|
|
|
"stopwords": "_english_"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-07-27 15:58:26 -04:00
|
|
|
POST my-index-000001/_analyze
|
2016-05-11 08:17:56 -04:00
|
|
|
{
|
|
|
|
"analyzer": "my_english_analyzer",
|
|
|
|
"text": "The 2 QUICK Brown-Foxes jumped over the lazy dog's bone."
|
|
|
|
}
|
|
|
|
----------------------------
|
|
|
|
|
2016-05-19 13:42:23 -04:00
|
|
|
/////////////////////
|
|
|
|
|
2019-09-06 09:22:08 -04:00
|
|
|
[source,console-result]
|
2016-05-19 13:42:23 -04:00
|
|
|
----------------------------
|
|
|
|
{
|
|
|
|
"tokens": [
|
|
|
|
{
|
|
|
|
"token": "2",
|
|
|
|
"start_offset": 4,
|
|
|
|
"end_offset": 5,
|
|
|
|
"type": "<NUM>",
|
|
|
|
"position": 1
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "quick",
|
|
|
|
"start_offset": 6,
|
|
|
|
"end_offset": 11,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 2
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "brown",
|
|
|
|
"start_offset": 12,
|
|
|
|
"end_offset": 17,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 3
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "foxes",
|
|
|
|
"start_offset": 18,
|
|
|
|
"end_offset": 23,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 4
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "jumpe",
|
|
|
|
"start_offset": 24,
|
|
|
|
"end_offset": 29,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 5
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "d",
|
|
|
|
"start_offset": 29,
|
|
|
|
"end_offset": 30,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 6
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "over",
|
|
|
|
"start_offset": 31,
|
|
|
|
"end_offset": 35,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 7
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "lazy",
|
|
|
|
"start_offset": 40,
|
|
|
|
"end_offset": 44,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 9
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "dog's",
|
|
|
|
"start_offset": 45,
|
|
|
|
"end_offset": 50,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 10
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"token": "bone",
|
|
|
|
"start_offset": 51,
|
|
|
|
"end_offset": 55,
|
|
|
|
"type": "<ALPHANUM>",
|
|
|
|
"position": 11
|
|
|
|
}
|
|
|
|
]
|
|
|
|
}
|
|
|
|
----------------------------
|
|
|
|
|
|
|
|
/////////////////////
|
|
|
|
|
2016-05-11 08:17:56 -04:00
|
|
|
The above example produces the following terms:
|
|
|
|
|
|
|
|
[source,text]
|
|
|
|
---------------------------
|
|
|
|
[ 2, quick, brown, foxes, jumpe, d, over, lazy, dog's, bone ]
|
|
|
|
---------------------------
|
2018-05-14 18:40:54 -04:00
|
|
|
|
2020-07-23 12:42:33 -04:00
|
|
|
[discrete]
|
2018-05-14 18:40:54 -04:00
|
|
|
=== Definition
|
|
|
|
|
|
|
|
The `standard` analyzer consists of:
|
|
|
|
|
|
|
|
Tokenizer::
|
|
|
|
* <<analysis-standard-tokenizer,Standard Tokenizer>>
|
|
|
|
|
|
|
|
Token Filters::
|
|
|
|
* <<analysis-lowercase-tokenfilter,Lower Case Token Filter>>
|
|
|
|
* <<analysis-stop-tokenfilter,Stop Token Filter>> (disabled by default)
|
|
|
|
|
|
|
|
If you need to customize the `standard` analyzer beyond the configuration
|
|
|
|
parameters then you need to recreate it as a `custom` analyzer and modify
|
|
|
|
it, usually by adding token filters. This would recreate the built-in
|
|
|
|
`standard` analyzer and you can use it as a starting point:
|
|
|
|
|
2019-09-09 13:38:14 -04:00
|
|
|
[source,console]
|
2018-05-14 18:40:54 -04:00
|
|
|
----------------------------------------------------
|
2019-01-18 03:34:11 -05:00
|
|
|
PUT /standard_example
|
2018-05-14 18:40:54 -04:00
|
|
|
{
|
|
|
|
"settings": {
|
|
|
|
"analysis": {
|
|
|
|
"analyzer": {
|
|
|
|
"rebuilt_standard": {
|
|
|
|
"tokenizer": "standard",
|
|
|
|
"filter": [
|
|
|
|
"lowercase" <1>
|
|
|
|
]
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
----------------------------------------------------
|
|
|
|
// TEST[s/\n$/\nstartyaml\n - compare_analyzers: {index: standard_example, first: standard, second: rebuilt_standard}\nendyaml\n/]
|
|
|
|
<1> You'd add any token filters after `lowercase`.
|