Format 매핑 파라미터

Format 매핑 파라미터

format 매핑 파라미터는 date 필드가 인덱싱 중 받아들일 수 있는 내장 날짜 형식들을 지정해요. 기대하는 날짜 형식을 정의하면 날짜 값이 올바르게 파싱되고 저장되어 정확한 검색과 집계가 가능해져요.

출처: 문서

본문

format 매핑 파라미터는 date 필드가 인덱싱 중 받아들일 수 있는 내장 날짜 형식들을 지정합니다. 기대하는 날짜 형식을 정의하면 날짜 값이 올바르게 파싱되고 저장되어 정확한 검색 및 집계 연산을 지원합니다.

예제: 맞춤형 날짜 형식 정의하기

event_date 필드가 맞춤형 yyyy-MM-dd HH:mm:ss 날짜 형식으로 구성된 events 인덱스를 만듭니다.

PUT events
{
  "mappings": {
    "properties": {
      "event_date": {
        "type": "date",
        "format": "yyyy-MM-dd HH:mm:ss"
      }
    }
  }
}

event_date 필드에 지정된 형식을 사용해 문서를 인덱싱합니다.

PUT events/_doc/1
{
  "event_name": "Conference",
  "event_date": "2025-03-26 15:30:00"
}

예제: 여러 날짜 형식 사용하기

맞춤형 yyyy-MM-dd HH:mm:ss 날짜 형식과 epoch_millis 형식을 모두 허용하는 log_timestamp 필드를 포함하는 인덱스를 만듭니다.

PUT logs
{
  "mappings": {
    "properties": {
      "log_timestamp": {
        "type": "date",
        "format": "yyyy-MM-dd HH:mm:ss||epoch_millis"
      }
    }
  }
}

첫 번째 문서를 맞춤형 형식으로 인덱싱합니다.

PUT logs/_doc/1
{
  "message": "System rebooted",
  "log_timestamp": "2025-03-26 08:45:00"
}

두 번째 문서를 밀리초 형식으로 인덱싱합니다.

PUT logs/_doc/2
{
  "message": "System updated",
  "log_timestamp": 1711442700000
}

내장 날짜 형식

내장 날짜 형식의 전체 목록은 Built-in formats를 참고하세요.

더 알아보기 (Learn more)