› › ›

日期纳秒字段类型

日期纳秒字段类型编辑

此数据类型是对 date 数据类型的补充。但是，两者之间存在重要区别。现有的 date 数据类型以毫秒分辨率存储日期。 date_nanos 数据类型以纳秒分辨率存储日期，这将其日期范围限制在 1970 年到 2262 年左右，因为日期仍然存储为表示自纪元以来的纳秒数的长整型。

对纳秒的查询在内部转换为对此长整型表示形式的范围查询，聚合和存储字段的结果将根据与该字段关联的日期格式转换回字符串。

日期格式可以自定义，但如果没有指定 format，则使用默认格式

    "strict_date_optional_time_nanos||epoch_millis"

例如

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

response = client.bulk(
  index: 'my-index-000001',
  refresh: true,
  body: [
    {
      index: {
        _id: '1'
      }
    },
    {
      date: '2015-01-01'
    },
    {
      index: {
        _id: '2'
      }
    },
    {
      date: '2015-01-01T12:10:30.123456789Z'
    },
    {
      index: {
        _id: '3'
      }
    },
    {
      date: 1_420_070_400_000
    }
  ]
)
puts response

response = client.search(
  index: 'my-index-000001',
  body: {
    sort: {
      date: 'asc'
    },
    runtime_mappings: {
      date_has_nanos: {
        type: 'boolean',
        script: "emit(doc['date'].value.nano != 0)"
      }
    },
    fields: [
      {
        field: 'date',
        format: 'strict_date_optional_time_nanos'
      },
      {
        field: 'date_has_nanos'
      }
    ]
  }
)
puts response

PUT my-index-000001
{
  "mappings": {
    "properties": {
      "date": {
        "type": "date_nanos" 
      }
    }
  }
}

PUT my-index-000001/_bulk?refresh
{ "index" : { "_id" : "1" } }
{ "date": "2015-01-01" } 
{ "index" : { "_id" : "2" } }
{ "date": "2015-01-01T12:10:30.123456789Z" } 
{ "index" : { "_id" : "3" } }
{ "date": 1420070400000 } 

GET my-index-000001/_search
{
  "sort": { "date": "asc"}, 
  "runtime_mappings": {
    "date_has_nanos": {
      "type": "boolean",
      "script": "emit(doc['date'].value.nano != 0)" 
    }
  },
  "fields": [
    {
      "field": "date",
      "format": "strict_date_optional_time_nanos" 
    },
    {
      "field": "date_has_nanos"
    }
  ]
}

	`date` 字段使用默认的 `format`。
	此文档使用纯日期。
	此文档包含时间。
	此文档使用自纪元以来的毫秒数。
	请注意，返回的 `sort` 值均为自纪元以来的纳秒数。
	在脚本中使用 `.nano` 返回日期的纳秒部分。
	您可以在使用 `fields` 参数获取数据时指定格式。使用 `strict_date_optional_time_nanos`，否则您将获得四舍五入的结果。

您还可以指定多个日期格式，用 || 分隔。可以使用与 date 字段相同的映射参数。

日期纳秒将接受带有小数点的数字，例如 {"date": 1618249875.123456}，但在某些情况下（#70085），我们会丢失这些日期的精度，因此应避免使用它们。

限制编辑

即使使用 date_nanos 字段，聚合仍然是毫秒分辨率。此限制也会影响转换。

合成 `_source`编辑

合成 _source 仅适用于 TSDB 索引（index.mode 设置为 time_series 的索引）。对于其他索引，合成 _source 处于技术预览阶段。技术预览版中的功能可能会在未来版本中更改或删除。Elastic 将努力解决任何问题，但技术预览版中的功能不受官方 GA 功能的支持 SLA 的约束。

在默认配置中，date_nanos 字段支持合成 _source。合成 _source 不能与 copy_to、设置为 true 的 ignore_malformed 或禁用的 doc_values 一起使用。

合成源始终对 date_nanos 字段进行排序。例如

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

response = client.index(
  index: 'idx',
  id: 1,
  body: {
    date: [
      '2015-01-01T12:10:30.000Z',
      '2014-01-01T12:10:30.000Z'
    ]
  }
)
puts response

PUT idx
{
  "mappings": {
    "_source": { "mode": "synthetic" },
    "properties": {
      "date": { "type": "date_nanos" }
    }
  }
}
PUT idx/_doc/1
{
  "date": ["2015-01-01T12:10:30.000Z", "2014-01-01T12:10:30.000Z"]
}

将变为

{
  "date": ["2014-01-01T12:10:30.000Z", "2015-01-01T12:10:30.000Z"]
}

« 日期字段类型密集向量字段类型 »

日期纳秒字段类型