别名字段类型

Alias 别名字段类型 #

别名字段类型为现有字段创建另一个名称。您可以在搜索和字段功能的 API 操作中使用别名字段，但存在一些例外情况。要设置别名，必须在 path 参数中指定原始字段名称。

参考代码 #

PUT movies
{
  "mappings" : {
    "properties" : {
      "year" : {
        "type" : "date"
      },
      "release_date" : {
        "type" : "alias",
        "path" : "year"
      }
    }
  }
}

参数说明 #

  • path：指向原始字段的完整路径，包括所有父对象。例如，parent.child.field_name。此参数为必填项。

别名（Alias）字段 #

别名（Alias）字段必须遵循以下规则：

  1. 一个别名字段只能引用一个原始字段。
  2. 在嵌套对象中，别名必须与原始字段位于相同的嵌套层级。

要更改别名引用的字段，需要更新映射配置。但请注意，之前存储的 Percolator 查询中的别名仍会继续引用原始字段，不会自动更新为新的字段引用。

原始字段 #

别名的原始字段必须遵守以下规则：

  1. 原始字段必须在别名字段创建之前定义。
  2. 原始字段不能是对象类型，也不能是另一个别名字段。

可以使用别名字段的搜索 API #

您可以在以下搜索 API 的只读操作中使用别名：

  • 查询 (Queries)
  • 排序 (Sorts)
  • 聚合 (Aggregations)
  • 存储字段 (stored_fields)
  • 文档值字段 (docvalue_fields)
  • 建议 (Suggestions)
  • 高亮显示 (Highlights)
  • 访问字段值的脚本 (Scripts)

也可以在字段功能 API 操作中使用别名 #

要在字段功能 API 中使用别名，请将其指定在 fields 参数中。

GET movies/_field_caps?fields=release_date

例外情况 #

别名不能用于以下场景：

  • 写入请求（如更新请求）。
  • 多字段（multi-fields）或 copy_to 的目标字段。
  • 作为 _source 参数用于结果过滤。
  • 接受字段名称的 API（如词向量 term vectors）。
  • terms、more_like_this 和 geo_shape 这类查询不支持别名字段，因为别名字段在检索文档时无法使用。

通配符（Wildcards） #

在搜索和字段功能的通配符(Wildcards)查询中，原始字段和别名都会与通配符模式匹配。

GET movies/_field_caps?fields=release*
©INFINI.LTD, All Rights Reserved.