metaedit

附加到字段的元数据。此元数据对 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(零)。默认情况下,没有度量类型与字段关联。仅对数字字段有效。