元数据字段 #

元数据字段是 Easysearch 为每个文档自动维护的内部字段，用于文档标识、分片路由、原始数据存储等系统功能。

元数据字段分类 #

字段	说明	可配置
_id	文档唯一标识符	✓
_index	文档所属索引名	-

字段	说明	可配置
_routing	自定义分片路由值	✓

字段	说明	可配置
_source	文档原始 JSON	✓
_meta	用户自定义元数据	✓

字段	说明	可配置
_ignored	被忽略的字段列表	-
_field_names	非空字段名列表	✓

每个文档都有一个唯一的 _id，可以在索引时指定或由系统自动生成。

PUT /my-index/_doc/my-custom-id
{
  "title": "Hello World"
}

查询时可以直接使用 _id：

GET /my-index/_doc/my-custom-id

_source 字段存储了文档索引时的原始 JSON，是搜索结果返回的数据来源。

可以在映射中配置是否存储或过滤 _source：

PUT /my-index
{
  "mappings": {
    "_source": {
      "enabled": true,
      "excludes": ["password", "internal_*"]
    }
  }
}

默认情况下，文档根据 _id 的哈希值分配到分片。使用自定义 _routing 可以控制相关文档存储在同一分片。

PUT /my-index/_doc/1?routing=user123
{
  "user": "user123",
  "message": "Hello"
}

使用场景：

_meta 字段用于存储与索引相关的自定义信息，如版本号、所有者等：

PUT /my-index
{
  "mappings": {
    "_meta": {
      "version": "1.0",
      "owner": "data-team",
      "description": "用户行为日志索引"
    }
  }
}