_all field · Elasticsearch 5.4 中文文档

# _all field 原文链接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/mapping-all-field.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/mapping-all-field.html) 译文链接 : [http://www.apache.wiki/display/Elasticsearch/_all+field](http://www.apache.wiki/display/Elasticsearch/_all+field) 贡献者 : [朱彦安](/display/~zhuyanan)，[ApacheCN](/display/~apachecn)，[Apache中文网](/display/~apachechina) 该 **_all **字段是一个特殊的全能字段，它将所有其他字段的值连接成一个大字符串，使用空格作为分隔符，然后对其进行分词和索引，但不存储。这意味着它可以被检索，但不能取回。该 **_all **字段允许您在文档中搜索，并不需要知道哪个字段包含该值。这使得它成为开始使用新数据集时的有用选项。例如 : ``` curl -XPUT 'localhost:9200/my_index/user/1?pretty' -H 'Content-Type: application/json' -d' # 1 { "first_name": "John", "last_name": "Smith", "date_of_birth": "1970-10-24" } ' curl -XGET 'localhost:9200/my_index/_search?pretty' -H 'Content-Type: application/json' -d' { "query": { "match": { "_all": "john smith 1970" } } } ' ``` | 1 | 该 _all 字段包含项: [ "john", "smith", "1970", "10", "24" ] | 注意 : 所有值被视为字符串上述示例中的 **date_of_birth** 字段被视为 **date** 字段，因此将索引表示 **1970-10-24 00:00:00 UTC** 的单个项。然而，**_all** 字段将所有值视为字符串，因此日期值被索引成三个字符串项 : “**1970**”，“**24**”，“**10**”。注意，**_all** 字段将每个字段的原始值作为字符串组合。它不会组合来自每个字段的项。该 **_all** 字段是一个文本字段，并接受与其他字符串字段相同的参数，包括 **analyzer**，**term_vectors**，**index_options **和 **store**。该 **_all** 字段是有用的，特别是当使用简单的过滤来探索新的数据时。但是，通过将字段值连接成一个大字符串，**_all** 字段将丢失短字段（更相关）和长字段（较不相关）之间的区别。对于搜索相关性很重要的用例，最好专门查询各个字段。该 **_all** 字段并不轻量 : 它需要额外的 **CPU **并使用更多的磁盘空间。如果不需要，它可以完全禁用或个别字段定制。 ### 在查询中使用 _all 字段 **query_string** 和 **simple_query_string** 查询默认查询 **_all** 字段，除非指定了另一个字段 : ``` curl -XGET 'localhost:9200/_search?pretty' -H 'Content-Type: application/json' -d' { "query": { "query_string": { "query": "john smith 1970" } } } ' ``` 同样的在[URI搜索请求](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-uri-request.html)中 ?q= parameter（内部改写为query_string）: ``` GET _search?q=john+smith+1970 ``` 其他查询（如 [match](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-match-query.html) 和 [term](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-term-query.html) 查询）要求您按照 [第一个示例](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-all-field.html) 显式指定 **_all **字段。 ### 禁用 _all 字段通过将 **enabled **设置为 **false**，可以对 **_all **字段完全禁用： ``` curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "type_1": { # 1 "properties": {...} }, "type_2": { # 2 "_all": { "enabled": false }, "properties": {...} } } } ' ``` | 1 | type_1 中的 _all 字段已启用。 | | 2 | type_2 中的 _all 字段已完全禁用. | 如果 **_all** 字段被禁用，则 **URI **搜索请求和 **query_string **和 **simple_query_string **查询将无法将其用于查询（请参阅在查询中使用 **_all **字段）。您可以将它们配置为使用与 **index.query.default_field **设置不同的字段 : ``` curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "my_type": { "_all": { "enabled": false # 1 }, "properties": { "content": { "type": "text" } } } }, "settings": { "index.query.default_field": "content" # 2 } } ' ``` | 1 | _all字段对于my_type类型是禁用的。 | | 2 | query_string查询将默认查询此索引中的content字段。 | ### 排除 _all 的字段可以使用 [include_in_all](https://www.elastic.co/guide/en/elasticsearch/reference/current/include-in-all.html) 设置从 **_all** 字段中包含或排除各个字段。 ### 索引提升和 _all 字段使用 [boost](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-boost.html) 参数，索引时可以提升个别字段。 **_all** 字段考虑到这些提升 : ``` curl -XPUT 'localhost:9200/myindex?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "mytype": { "properties": { "title": { # 1 "type": "text", "boost": 2 }, "content": { # 2 "type": "text" } } } } } ' ``` | 1 2 | 当查询 **_all** 字段时，源于 **title** 字段的字符是源于 **content** 字段的字符的两倍相关。 | 警告 : 使用 **_all** 字段的在索引时 **boost** 对查询性能有显着的影响。通常更好的解决方案是单独查询字段，可在查询时 **boost**。 ### 自定义 _all 字段虽然每个索引只有一个 **_all** 字段，但 **copy_to **参数允许创建多个自定义 **_all **字段。例如，**first_name **和 **last_name **字段可以组合到 **full_name **字段中 : ``` curl -XPUT 'localhost:9200/myindex?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "mytype": { "properties": { "first_name": { "type": "text", "copy_to": "full_name" # 1 }, "last_name": { "type": "text", "copy_to": "full_name" # 2 }, "full_name": { "type": "text" } } } } } ' curl -XPUT 'localhost:9200/myindex/mytype/1?pretty' -H 'Content-Type: application/json' -d' { "first_name": "John", "last_name": "Smith" } ' curl -XGET 'localhost:9200/myindex/_search?pretty' -H 'Content-Type: application/json' -d' { "query": { "match": { "full_name": "John Smith" } } } ' ``` | 1 2 | **first_name** 和 **last_name** 值将复制到 **full_name** 字段。 | ### 高亮显示和 _all 字段如果原始字符串值可用，则字段只能用于 [高亮](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-highlighting.html) 显示，从 [_source](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-source-field.html) 字段或作为存储字段。 **_all** 字段不在 **_source **字段中，默认情况下不存储，因此无法高亮显示。有两个选项。存储[ _all ](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-all-field.html#all-field-store)字段或高亮显示 [原始字段 ](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-all-field.html#all-highlight-fields)。 ### 存储 _all 字段如果存储设置为 **true**，则可以检索原始字段值，并且可以高亮显示 : ``` curl -XPUT 'localhost:9200/myindex?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "mytype": { "_all": { "store": true } } } } ' curl -XPUT 'localhost:9200/myindex/mytype/1?pretty' -H 'Content-Type: application/json' -d' { "first_name": "John", "last_name": "Smith" } ' curl -XGET 'localhost:9200/_search?pretty' -H 'Content-Type: application/json' -d' { "query": { "match": { "_all": "John Smith" } }, "highlight": { "fields": { "_all": {} } } } ' ``` 当然，存储 **_all **字段将使用更多的磁盘空间，因为由于它是其他字段的组合，所以可能会导致奇怪的高亮显示结果。 **_all** 字段也接受 **term_vector **和 **index_options **参数，允许使用快速的矢量荧光笔和贴片荧光笔。 ### 高亮显示原始字段您可以查询 **_all** 字段，但使用原始字段进行高亮显示，如下所示 : ``` curl -XPUT 'localhost:9200/myindex?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "mytype": { "_all": {} } } } ' curl -XPUT 'localhost:9200/myindex/mytype/1?pretty' -H 'Content-Type: application/json' -d' { "first_name": "John", "last_name": "Smith" } ' curl -XGET 'localhost:9200/_search?pretty' -H 'Content-Type: application/json' -d' { "query": { "match": { "_all": "John Smith" # 1 } }, "highlight": { "fields": { "*_name": { # 2 "require_field_match": false # 3 } } } } ' ``` | 1 | 查询检查 **_all** 字段以查找匹配的文档。 | | 2 | 在 **_source** 可以使用的两个名称字段上执行高亮显示。 | | 3 | 该查询未针对 **name** 字段运行，因此将 **require_field_match** 设置为 **false**。 |