Docs Menu
Docs Home
/ /

시계열 컬렉션 만들기 및 쿼리Create and Query a Time Series Collection

이 페이지에서는 time series 컬렉션 만들고 쿼리 방법을 보여 줍니다. 제공된 코드 예제는 시간, 온도 및 센서 정보가 포함된 샘플 날씨 데이터를 생성하고 작업합니다.

중요

기능 호환성 버전 요구 사항

featureCompatibilityVersion이 5.0 이상으로 설정된 시스템에서만 time series 컬렉션을 만들 수 있습니다.

time series 컬렉션에는 다음 필드가 포함됩니다.

필드
유형
설명

timeseries.timeField

문자열

필수입니다. 각 time series 문서에서 날짜를 포함하는 필드의 이름입니다. time series 컬렉션의 문서에는 timeField 값으로 유효한 BSON 날짜가 있어야 합니다.

timeseries.metaField

문자열

선택 사항. 각 time series 문서에 메타데이터가 포함된 필드의 이름입니다. 지정된 필드의 메타데이터는 고유한 문서 시리즈에 레이블을 지정하는 데 사용되는 데이터여야 합니다. 메타데이터는 거의 변경되지 않아야 합니다. 지정된 필드의 이름은 _id이(가) 아니거나 timeseries.timeField 이름과 같지 않을 수 있습니다. 필드는 모든 데이터 유형이 가능합니다.

metaField 필드는 선택 사항이지만 메타데이터를 사용하면 쿼리 최적화를 개선할 수 있습니다. 예를 들어 MongoDB는 새 컬렉션에 대해 metaFieldtimeField 필드에 복합 인덱스를 자동으로 생성합니다 . 이 필드에 값을 제공하지 않으면 데이터는 시간을 기준으로만 버킷됩니다.

timeseries.granularity

integer

선택 사항입니다. bucketRoundingSecondsbucketMaxSpanSeconds 을 설정한 경우에는 사용하지 마십시오.

가능한 값은 seconds (기본값), minuteshours입니다.

연속적으로 들어오는 타임스탬프 사이의 시간과 가장 근접하게 일치하는 값으로 granularity 를 설정합니다. 이렇게 하면 MongoDB가 컬렉션에 데이터를 저장하는 방법을 최적화하여 성능이 향상됩니다.

세분 수준 및 버킷 간격에 대한 자세한 내용은 Time Series 데이터의 세부 수준 설정을 참조하세요.

timeseries.bucketMaxSpanSeconds

integer

선택 사항입니다. bucketRoundingSeconds와 함께 granularity의 대안으로 사용합니다. 같은 버킷에 있는 타임스탬프 사이의 최대 시간을 설정합니다.

가능한 값은 1-31536000입니다.

버전 6.3에 추가.

timeseries.bucketRoundingSeconds

integer

선택 사항. bucketMaxSpanSeconds와 함께 granularity의 대안으로 사용합니다. bucketMaxSpanSeconds와 같아야 합니다.

문서에 새 버킷이 필요한 경우 MongoDB는 문서의 타임스탬프 값을 이 간격으로 반올림하여 버킷의 최소 시간을 설정합니다.

버전 6.3에 추가.

expireAfterSeconds

integer

선택 사항입니다. 문서가 만료되기 전까지의 시간(초)을 지정하여 Time Series 컬렉션 문서를 자동으로 삭제할 수 있습니다. MongoDB는 만료된 문서를 자동으로 삭제합니다. 자세한 내용은 Time Series(TTL)에 대한 자동 제거 설정하기를 참조하세요.

Time Series 컬렉션에 국한되지 않는 다른 허용 옵션은 다음과 같습니다.

  • storageEngine

  • indexOptionDefaults

  • collation

  • writeConcern

  • comment

돌아가기

생성 및 구성

이 페이지의 내용