构建父-子文档索引

为父文档创建索引与为普通文档创建索引没有区别。父文档并不需要知道它有哪些子文档。

  1. POST /company/branch/_bulk
  2. { "index": { "_id": "london" }}
  3. { "name": "London Westminster", "city": "London", "country": "UK" }
  4. { "index": { "_id": "liverpool" }}
  5. { "name": "Liverpool Central", "city": "Liverpool", "country": "UK" }
  6. { "index": { "_id": "paris" }}
  7. { "name": "Champs Élysées", "city": "Paris", "country": "France" }

创建子文档时，用户必须要通过 parent 参数来指定该子文档的父文档 ID：

  1. PUT /company/employee/1?parent=london <1>
  2. {
  3.   "name":  "Alice Smith",
  4.   "dob":   "1970-10-24",
  5.   "hobby": "hiking"
  6. }

<1> 当前 employee 文档的父文档 ID 是 london 。

父文档 ID 有两个作用：创建了父文档和子文档之间的关系，并且保证了父文档和子文档都在同一个分片上。

在 routing-value 中，我们解释了 Elasticsearch 如何通过路由值来决定该文档属于哪一个分片，路由值默认为该文档的 _id 。分片路由的计算公式如下：

  1.     shard = hash(routing) % number_of_primary_shards

如果指定了父文档的 ID，那么就会使用父文档的 ID 进行路由，而不会使用当前文档 _id 。也就是说，如果父文档和子文档都使用相同的值进行路由，那么父文档和子文档都会确定分布在同一个分片上。

在执行单文档的请求时需要指定父文档的 ID，单文档请求包括：通过 GET 请求获取一个子文档；创建、更新或删除一个子文档。而执行搜索请求时是不需要指定父文档的ID，这是因为搜索请求是向一个索引中的所有分片发起请求，而单文档的操作是只会向存储该文档的分片发送请求。因此，如果操作单个子文档时不指定父文档的 ID，那么很有可能会把请求发送到错误的分片上。

父文档的 ID 应该在 bulk API 中指定

  1. POST /company/employee/_bulk
  2. { "index": { "_id": 2, "parent": "london" }}
  3. { "name": "Mark Thomas", "dob": "1982-05-16", "hobby": "diving" }
  4. { "index": { "_id": 3, "parent": "liverpool" }}
  5. { "name": "Barry Smith", "dob": "1979-04-01", "hobby": "hiking" }
  6. { "index": { "_id": 4, "parent": "paris" }}
  7. { "name": "Adrien Grand", "dob": "1987-05-11", "hobby": "horses" }

WARNING: 如果你想要改变一个子文档的 parent 值，仅通过更新这个子文档是不够的，因为新的父文档有可能在另外一个分片上。因此，你必须要先把子文档删除，然后再重新索引这个子文档。