# _routing field 原文链接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/mapping-routing-field.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/mapping-routing-field.html) 译文链接 : [http://www.apache.wiki/display/Elasticsearch/_routing+field](http://www.apache.wiki/display/Elasticsearch/_routing+field) 贡献者 : [朱彦安](/display/~zhuyanan)，[ApacheCN](/display/~apachecn)，[Apache中文网](/display/~apachechina) 使用以下公式将文档路由到索引中的特定分片： ``` shard_num = hash(_routing) % num_primary_shards ``` 用于 **_routing **的默认值是文档的_id或文档的_parent ID（如果存在）。 可以通过为每个文档指定自定义路由值来实现自定义路由模式。 例如： ``` curl -XPUT 'localhost:9200/my_index/my_type/1?routing=user1&refresh=true&pretty' -H 'Content-Type: application/json' -d' # 1 { "title": "This is a document" } ' curl -XGET 'localhost:9200/my_index/my_type/1?routing=user1&pretty' # 2 ``` | 1 | 此文档使用 **user1** 作为其 **routing** **value**（路由值），而不是其 **ID**。 | | 2 | 在 **[getting](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/docs-get.html)**（获取）， **[deleting](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/docs-delete.html)**（删除）或 **[updating](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/docs-update.html)**（更新）文档时需要提供相同的路由值。 | 该 **_routing**字段的值可以在查询中访问 :  ``` curl -XGET 'localhost:9200/my_index/_search?pretty' -H 'Content-Type: application/json' -d' # 1 { "query": { "terms": { "_routing": [ "user1" ] } } } ' ``` | 1 | 在_routing字段上查询（也可以参见 **[ids query](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/query-dsl-ids-query.html)**） | ### Searching with custom routing（使用自定义路由搜索） 自定义路由可以减少搜索的影响。 搜索请求不必分散到索引中的所有分片，而是将该请求发送到与特定路由值（或值）匹配的分片 :  ``` curl -XGET 'localhost:9200/my_index/_search?routing=user1,user2&pretty' -H 'Content-Type: application/json' -d' # 1 { "query": { "match": { "title": "document" } } } ' ``` | 1 | 该搜索请求仅会在与user1和user2路由值相关联的分片上执行。 | ### Making a routing value required（路由值的要求） 当使用自定义路由时，重要的是在** [indexing](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/docs-index_.html)**（索引）， **[getting](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/docs-get.html)**（获取）， **[deleting](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/docs-delete.html)**（删除）或 **[updating](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/docs-update.html)**（更新）文档时提供路由值。 忘记路由值可能导致文档被索引在多个分片上。 作为保护措施，可以将 **_routing **字段配置为使所有CRUD操作都需要指定路由值 :  ``` curl -XPUT 'localhost:9200/my_index2?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "my_type": { "_routing": { "required": true # 1 } } } } ' curl -XPUT 'localhost:9200/my_index2/my_type/1?pretty' -H 'Content-Type: application/json' -d' # 2 { "text": "No routing value provided" } ' ``` | 1 | **my_type** 文档需要路由。 | | 2 | 此索引请求会引发一个 **routing_missing_exception**。 | ### Unique IDs with custom routing（具有自定义路由的唯一ID） 在索引指定自定义 **_routing **的文档时，**_id **的唯一性不能保证在索引中的所有分片。 事实上，如果使用不同的 **_routing **值进行索引，那么具有相同 **_id **的文档可能会在不同的分片上出现。 由用户确定 **ID **在索引中是唯一的。 ### Routing to an index partition（路由到索引分区） 可以配置索引，使得自定义路由值将转到分片的子集，而不是单个分片。这有助于减轻最终产生不平衡群集的风险，同时还可以减少搜索的影响。 这是通过在索引创建时提供索引级别设置 _**index.routing_partition_size **_来完成的。随着分区大小的增加，数据的分布越均匀，必须以每个请求搜索更多的分片为代价。 当存在此设置时，计算分片的公式为： ``` shard_num = (hash(_routing) + hash(_id) % routing_partition_size) % num_primary_shards ``` 也就是说，**_routing **字段用于计算索引中的一组分片，然后使用 **_id **来选择该组内的分片。 要启用此功能，_**index.routing_partition_size **_应具有大于1且小于 _**index.number_of_shards **_的值。 一旦启用，分区索引将具有以下限制 :  * 具有父子关系的映射无法在其中创建。 * 索引中的所有映射必须设置 **_routing **字段。