_parent,_routing 元字段

_parent

用于创建两个映射类型之间的父子关系。

_routing

将文档路由到特定分片的自定义路由值。

_parent field

通过使一个映射类型成为另一个映射类型的父类,可以在同一索引中的文档之间建立父子关系 :

curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d'
{
  "mappings": {
    "my_parent": {},
    "my_child": {
      "_parent": {
        "type": "my_parent" # 1
      }
    }
  }
}
'
curl -XPUT 'localhost:9200/my_index/1/1?pretty' -H 'Content-Type: application/json' -d' # 2
{
  "text": "This is a parent document"
}

'
curl -XPUT 'localhost:9200/my_index/my_child/2?parent=1&pretty' -H 'Content-Type: application/json' -d' # 2
{
  "text": "This is a child document"
}
'
curl -XPUT 'localhost:9200/my_index/my_child/3?parent=1&refresh=true&pretty' -H 'Content-Type: application/json' -d' # 4
{
  "text": "This is another child document"
}
'
curl -XGET 'localhost:9200/my_index/my_parent/_search?pretty' -H 'Content-Type: application/json' -d'
{
  "query": {
    "has_child": { # 5
      "type": "my_child",
      "query": {
        "match": {
          "text": "child document"
        }
      }
    }
  }
}
'

1

my_parent类型是my_child类型的parent(父节)。

2

索引parent文档。

3 , 4

索引两个子文档,指定父文档的ID

5

查找具有与查询匹配的子项的所有父文档。

通过使一个映射类型成为另一个映射类型的父类,可以在同一索引中的文档之间建立父子关系 :

有关更多信息,请参阅has_childarrow-up-righthas_parentarrow-up-right查询,children aggregationarrow-up-rightinner hitsarrow-up-right

_parent 字段的值可以在aggregations(聚合)和scripts(脚本)中访问,并且可以使用 parent_idarrow-up-right查询进行查询

1

查询_parent字段的id(参考has_parentarrow-up-right查询和has_childarrow-up-right查询)

2

_parent字段上的聚合(参考children aggregationarrow-up-right

3

在脚本中访问_parent字段

Parent-child restrictionsedit (父子限制)

  • 父类和子类型必须不同 - 不能在相同类型的文档之间建立父子关系。

  • _parent.type设置只能指向不存在的类型。 这意味着类型在创建后不能成为父类型。

  • 父文档和子文档必须在相同的分片上索引。 父ID用作子节点的路由值,以确保子节点与父节点在同一分片上进行索引。 这意味着在获取,删除或更新子文档时需要提供相同的parent值。

Global ordinals (全局序列)

父子使用 全局序列arrow-up-right来加快连接。 在对分片进行任何更改之后,需要重建全局序列。 分片中存储的父ID值越多,重建 _parent 字段的全局序列所需的时间越长。

默认情况下,全局序列是高效的:如果索引已更改,则 _parent 字段的全局序列将作为刷新的一部分进行重新构建。 这会增加刷新时间。 然而,大多数时候,这是正确的选择,否则,当使用第一个 parent-child query(父子查询)或aggregation(聚合)时,全局序列将被重建。 这可能会为您的用户带来较大的延迟,并且通常会更糟,因为在发生许多写入时,可能会在单个刷新间隔内重新创建 _parent 字段的多个全局序列。

parent/child不频繁使用时,写入频繁发生,最好禁用预加载 :

可以检查全局序列使用的堆数量,如下所示 :

_routing field

使用以下公式将文档路由到索引中的特定分片:

用于 _routing 的默认值是文档的_id或文档的_parent ID(如果存在)。

可以通过为每个文档指定自定义路由值来实现自定义路由模式。 例如:

1

此文档使用user1作为其routingvalue(路由值),而不是其ID

2

gettingarrow-up-right(获取),deletingarrow-up-right(删除)或updatingarrow-up-right(更新)文档时需要提供相同的路由值。

_routing 字段的值可以在查询中访问 :

1

在_routing字段上查询(也可以参见ids queryarrow-up-right

Searching with custom routing(使用自定义路由搜索)

自定义路由可以减少搜索的影响。 搜索请求不必分散到索引中的所有分片,而是将该请求发送到与特定路由值(或值)匹配的分片 :

1

该搜索请求仅会在与user1和user2路由值相关联的分片上执行。

Making a routing value required(路由值的要求)

当使用自定义路由时,重要的是在indexingarrow-up-right(索引), gettingarrow-up-right(获取), deletingarrow-up-right(删除)或 updatingarrow-up-right(更新)文档时提供路由值。

忘记路由值可能导致文档被索引在多个分片上。 作为保护措施,可以将 _routing 字段配置为使所有CRUD操作都需要指定路由值 :

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 来完成的。随着分区大小的增加,数据的分布越均匀,必须以每个请求搜索更多的分片为代价。

当存在此设置时,计算分片的公式为:

也就是说,_routing 字段用于计算索引中的一组分片,然后使用 _id 来选择该组内的分片。

要启用此功能,index.routing_partition_size 应具有大于1且小于 index.number_of_shards 的值。

一旦启用,分区索引将具有以下限制 :

  • 具有父子关系的映射无法在其中创建。

  • 索引中的所有映射必须设置

    _routing 字段。

Last updated

Was this helpful?