Elasticsearch中时间字段格式用法详解

Elasticsearch中时间字段格式用法详解

攻城狮Jozz关注IP属地: 北京
2024.03.18 16:27:51字数 758阅读 2,571
Elasticsearch（简称ES）是一个基于Lucene构建的开源、分布式、RESTful搜索引擎。它提供了全文搜索、结构化搜索以及分析等功能，广泛应用于各种场景。在ES中，时间字段是一种非常紧张的数据类型，用于存储和查询与时间相干的数据。本文将具体先容在原生ES和Spring Data JPA ES中时间字段格式的用法。
一、原生Elasticsearch中的时间字段格式用法
在原生ES中，时间字段通常利用date类型举行界说。ES支持多种日期格式，但最常见的是ISO8601格式，如"yyyy-MM-dd'T'HH:mm:ss.SSSZ"。为了正确解析和存储时间数据，我们需要在创建索引时指定日期的格式。

• 创建索引时指定日期格式
  

在创建索引时，我们可以在mapping中界说date字段，并指定其格式。例如：

1. PUT /my_index
2. {
3.   "mappings": {
4.     "properties": {
5.       "my_date": {
6.         "type":   "date",
7.         "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
8.       }
9.     }
10.   }
11. }

复制代码

在上面的示例中，我们创建了一个名为my_index的索引，并界说了一个名为my_date的日期字段。format属性指定了日期字段可以继承的格式，这里我们利用了多种格式的分隔符||，体现可以继承其中的任意一种。

• 插入和查询时间数据
  

当插入数据时，我们需要确保日期字段的值符合指定的格式。例如：

1. POST /my_index/_doc/1
2. {
3.   "my_date": "2023-09-17 14:30:00"
4. }

复制代码

在查询时，我们可以利用range查询来检索特定时间范围内的数据。例如：

1. GET /my_index/_search
2. {
3.   "query": {
4.     "range": {
5.       "my_date": {
6.         "gte": "2023-09-01",
7.         "lte": "2023-09-30"
8.       }
9.     }
10.   }
11. }

复制代码

二、Spring Data JPA Elasticsearch中的时间字段格式用法
在Spring Data JPA ES中，我们同样需要处理时间字段。Spring Data JPA ES为我们提供了更高级的抽象和便利的操纵，但基本的时间字段处理原则与原生ES类似。

• 实体类中的日期字段
  

在实体类中，我们通常利用java.util.Date、java.time.LocalDateTime等类型来体现日期字段。例如：

1. import org.springframework.data.annotation.Id;
2. import org.springframework.data.elasticsearch.annotations.Document;
3. import org.springframework.data.elasticsearch.annotations.Field;
4. import org.springframework.data.elasticsearch.annotations.FieldType;
5. import java.time.LocalDateTime;
7. @Document(indexName = "my_index")
8. public class MyEntity {
9.     @Id
10.     private String id;
12.     @Field(type = FieldType.Date, format = "yyyy-MM-dd HH:mm:ss")
13.     private LocalDateTime myDate;
14.    
15.     // getters and setters
16. }

复制代码

在上面的示例中，我们界说了一个名为MyEntity的实体类，并利用@Document注解指定了索引名。myDate字段利用了@Field注解，并指定了类型为date和格式为"yyyy-MM-dd HH:mm:ss"。

• 插入和查询时间数据
  

利用Spring Data JPA ES插入和查询时间数据相对简朴。我们只需要像操纵普通实体一样操纵包罗日期字段的实体即可。Spring Data JPA ES会自动处理日期字段的序列化和反序列化。
例如，插入数据：

1. MyEntity entity = new MyEntity();
2. entity.setId("1");
3. entity.setMyDate(LocalDateTime.now());
4. myEntityRepository.save(entity);

复制代码

查询数据：

1. List<MyEntity> entities = myEntityRepository.findByMyDateBetween(LocalDateTime.of(2023, 9, 1, 0, 0), LocalDateTime.of(2023, 9, 30, 23, 59));

复制代码

需要注意的是，当利用Spring Data JPA ES时，我们需要确保实体类中的日期字段类型与索引中的日期字段类型相匹配，并正确设置日期格式











参考文献
https://www.jianshu.com/p/a3f00edce737




免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。