ElasticSearch的routing

2020-12-18 16:35:43 编辑 1 阅读量:320

当你索引一个文档，它被存储在单独一个主分片上。Elasticsearch是如何知道文档属于哪个分片的呢？当你创建一个新文档，它是如何知道是应该存储在分片1还是分片2上的呢？
## 概述
进程不能是随机的，因为我们将来要检索文档。事实上，它根据一个简单的算法决定：
`shard = hash(routing) % number_of_primary_shards`
routing值是一个任意字符串，它默认是_id但也可以自定义。这个routing字符串通过哈希函数生成一个数字，然后除以主切片的数量得到一个余数(remainder)，余数的范围永远是0到number_of_primary_shards - 1，这个数字就是特定文档所在的分片。
这也解释了为什么主分片的数量只能在创建索引时定义且不能修改：如果主分片的数量在未来改变了，所有先前的路由值就失效了，文档也就永远找不到了。
所有的文档API（get、index、delete、bulk、update、mget）都接收一个routing参数，它用来自定义文档到分片的映射。自定义路由值可以确保所有相关文档——例如属于同一个人的文档——被保存在同一分片上。

## 使用
要使用Elasticsearch的routing参数很简单，有两种方法：
1. 最简单的一种是在索引文档的时候提供一个routingURL 参数（这里的routing参数可以由自己指定任意字符串，这里是`A`，可以用`rrr`等)。比如：
curl -XPUT  localhost:9200/documents/doc/1?routing=A -d '{ "title":"Document" }'
用这种方法时，可以不需要在建立索引时指定mappings包含`_routing`，我们只需要在添加索引数据时传`routing`参数即可，然后在查询时也指定同一个`routing`参数，这样集群会自动找对应的routing，我们可以不需要关系routing放在那个节点
2. 另外一种方式就是在创建文档时把\_routing域放进去：
curl -XPUT  localhost:9200/documents/doc/1 -d '{ "title":"Document","\_routing":"A" }'
然而这种方式只有在mapping中定义了\_routing域才会生效,所以在创建索引时需如下进行配置：
```html
"mappings":{  
    "doc": {  
        "_routing": {  
            "required": true,  
            "path":"_routing"  
        },  
        "properties": {  
            "title": {  
                "type":"string"  
            }  
        }  
    }  
}  
```
如果我们想在建索引时将相关的文档存放到一个分片下就可以这样做： 
```
curl- XPUT localhost: 9200 / documents / doc / 1 - d '  
{  
    "title": "Document No.1",  
    "_routing":"A"  
}'  
curl- XPUT localhost: 9200 / documents / doc / 2 - d '  
{  
    "title": "Document No.1",  
    "_routing":"A"  
}'  
curl- XPUT localhost: 9200 / documents / doc / 3 - d '  
{  
    "title": "Document No.1",  
    "_routing":"B"  
}'  
```
这样将id为1和2的文档将会存在统一个分片上去。

既然索引文档的时候使用了路由，那么肯定得在查询的时候利用了，在查询的时候使用routing参数将使得查询更加高效，如下：
```html
curl-XGET 'localhost:9200/documents/_search?pretty&q=*:*&routing=A'
```
但是，需要注意的是，路由可以限制查询时使用的节点数，但是**不能代替过滤**功能。因为路由只能确保在索引时拥有相同路由值的文档会索引到相同的节点上，但是一个给定的分片上可以有多个不同路由值的文档，所以无论一个查询有没有使用路由**都应该使用相同的过滤器！！**

---
参考：
- [1][路由功能浅谈](https://www.kancloud.cn/wizardforcel/mastering-elasticsearch/147145)
- [2][Elasticsearch模块功能之-路由（routing）](http://blog.csdn.net/changong28/article/details/38427311)
- [3][路由文档到分片](https://es.xiaoleilu.com/040_Distributed_CRUD/05_Routing.html)

ElasticSearch的routing

附件: