meta
editmeta
edit
附加到字段的元数据。此元数据对 Elasticsearch 是不透明的,它仅对在相同索引上工作的多个应用程序有用,以共享有关字段的元信息,例如单位。
response = client.indices.create( index: 'my-index-000001', body: { mappings: { properties: { latency: { type: 'long', meta: { unit: 'ms' } } } } } ) puts response
PUT my-index-000001 { "mappings": { "properties": { "latency": { "type": "long", "meta": { "unit": "ms" } } } } }
字段元数据最多强制执行 5 个条目,键的长度小于或等于 20,并且值的长度小于或等于 50。
可以通过提交映射更新来更新字段元数据。更新的元数据将覆盖现有字段的元数据。
对象或嵌套字段不支持字段元数据。
Elastic 产品对字段使用以下标准元数据条目。您可以遵循这些相同的元数据约定,以获得更好的开箱即用数据体验。
- unit
- 与数字字段关联的单位:
"percent"
、"byte"
或 时间单位。默认情况下,字段没有单位。仅对数字字段有效。百分比的约定是使用值1
来表示100%
。 - metric_type
- 数字字段的度量类型:
"gauge"
或"counter"
。量规是随时间推移可以上升或下降的单值测量值,例如温度。计数器是仅上升的单值累积计数器,例如 Web 服务器处理的请求数,或重置为 0(零)。默认情况下,没有度量类型与字段关联。仅对数字字段有效。