版本字段类型

version 字段类型是 keyword 字段的专门化，用于处理软件版本值并支持针对它们的专门优先级规则。优先级遵循 语义版本控制 中概述的规则定义，例如，这意味着主版本、次版本和修订版本部分按数字排序（即“2.1.0” < “2.4.1” < “2.11.2”），预发布版本在发布版本之前排序（即“1.0.0-alpha” < “1.0.0”）。

您可以按如下方式索引 version 字段

response = client.indices.create(
  index: 'my-index-000001',
  body: {
    mappings: {
      properties: {
        my_version: {
          type: 'version'
        }
      }
    }
  }
)
puts response

PUT my-index-000001
{
  "mappings": {
    "properties": {
      "my_version": {
        "type": "version"
      }
    }
  }
}

该字段提供与常规关键字字段相同的搜索功能。例如，可以使用 match 或 term 查询搜索完全匹配项，并支持前缀和通配符搜索。主要好处是 range 查询将遵循 Semver 排序，因此“1.0.0”和“1.5.0”之间的 range 查询将包括“1.2.3”版本，但不包括“1.11.2”版本，例如。请注意，这与使用常规 keyword 字段进行索引时的排序不同，在常规 keyword 字段中，排序是按字母顺序的。

软件版本应遵循 语义版本控制规则 模式和优先级规则，但有一个显著的例外，即允许三个以上或三个以下的主要版本标识符（即“1.2”或“1.2.3.4”符合有效版本，而它们在严格的 Semver 规则下则不符合）。在 Semver 定义下无效的版本字符串（例如“1.2.alpha.4”）仍然可以被索引和检索为完全匹配项，但是它们将全部出现在任何具有常规字母顺序的有效版本之后。空字符串“”被认为是无效的，并且在所有有效版本之后但其他无效版本之前排序。

版本字段的参数编辑

version 字段接受以下参数

限制编辑

此字段类型未针对大量的通配符、正则表达式或模糊搜索进行优化。虽然这些类型的查询在此字段中有效，但如果您强烈依赖这些类型的查询，您应该考虑使用常规的 keyword 字段。

response = client.indices.create(
  index: 'idx',
  body: {
    mappings: {
      _source: {
        mode: 'synthetic'
      },
      properties: {
        versions: {
          type: 'version'
        }
      }
    }
  }
)
puts response

response = client.index(
  index: 'idx',
  id: 1,
  body: {
    versions: [
      '8.0.0-beta1',
      '8.5.0',
      '0.90.12',
      '2.6.1',
      '1.3.4',
      '1.3.4'
    ]
  }
)
puts response

PUT idx
{
  "mappings": {
    "_source": { "mode": "synthetic" },
    "properties": {
      "versions": { "type": "version" }
    }
  }
}
PUT idx/_doc/1
{
  "versions": ["8.0.0-beta1", "8.5.0", "0.90.12", "2.6.1", "1.3.4", "1.3.4"]
}

{
  "versions": ["0.90.12", "1.3.4", "2.6.1", "8.0.0-beta1", "8.5.0"]
}