Meta 参数 #
meta 参数允许为字段附加自定义元数据。这些元数据不影响搜索或索引行为，仅用于记录字段的业务含义或管理信息。
相关指南 #
示例 #
PUT my-index
{
"mappings": {
"properties": {
"latency": {
"type": "long",
"meta": {
"unit": "ms",
"description": "接口响应延迟"
}
},
"cpu_usage": {
"type": "float",
"meta": {
"unit": "percent",
"metric_type": "gauge"
}
}
}
}
}
典型用途 #
| 场景 | 示例 meta 键值 |
|---|---|
| 标注计量单位 | "unit": "ms", "unit": "bytes" |
| 标记指标类型 | "metric_type": "counter", "metric_type": "gauge" |
| 记录字段用途 | "description": "用户最后登录时间" |
| 标记数据来源 | "source": "nginx_access_log" |
| 团队归属信息 | "owner": "data-team" |
通过 API 查看 #
字段元数据会在 Get Mapping API 的响应中返回：
GET my-index/_mapping
响应中可以看到 meta 信息原样返回。
约束 #
| 约束 | 说明 |
|---|---|
| 键数量 | 最多 5 个键 |
| 键长度 | 最长 20 个字符 |
| 值类型 | 仅支持字符串 |
| 值长度 | 最长 50 个字符 |
注意事项 #
meta纯粹是描述性的，不会被索引、搜索或聚合- 可以通过 Update Mapping API 修改已有字段的
meta，无需重建索引 - 适合配合 Kibana/INFINI Console 等可视化工具，为字段提供人类可读的附加信息