Docs Menu
Docs Home
/
MongoDB 매뉴얼
/

시계열 수집 제한 사항

이 페이지의 내용

  • 지원되지 않는 기능
  • 집계 $merge
  • distinct 명령
  • 지리공간 쿼리
  • 문서 크기
  • 확장 날짜 범위
  • Updates
  • Time Series 보조 인덱스
  • 고정 사이즈 컬렉션
  • 컬렉션 유형 수정
  • timeFieldmetaField수정
  • 세분성
  • 버킷 크기
  • 버킷 매개변수 수정하기
  • 샤딩
  • 샤딩 관리 명령
  • 샤드 키 필드
  • 리샤딩
  • 트랜잭션
  • 조회수
  • 스냅샷 격리

시계열 컬렉션 은 일반적으로 일반 컬렉션처럼 작동하지만 몇 가지 제한 사항이 있습니다.

MongoDB 는 time series 컬렉션에서 다음 기능을 지원 하지 않습니다.

$merge 집계 단계를 사용하여 다른 컬렉션 의 데이터를 time series 컬렉션 에 추가할 수 없습니다. $out 집계 단계를 사용하여 time series 컬렉션 에 문서를 쓰기 (write) .

$merge 를 사용하여 time series 컬렉션 에서 다른 컬렉션 으로 데이터를 이동할 수 있습니다.

Time Series 컬렉션의 고유한 데이터 구조로 인해 MongoDB 는 고유한 값에 대해 이를 효율적으로 인덱스 할 수 없습니다. time series 컬렉션에 distinct 명령 또는 db.collection.distinct() 헬퍼 메서드를 사용하지 않도록 합니다. 대신 $group 집계 을 사용하여 고유 값을 기준으로 문서를 그룹 합니다.

예를 예시 meta.project = 10 인 문서에서 고유한 meta.type 값을 쿼리 하려면 다음 대신 사용할 수 있습니다.

db.foo.distinct("meta.type", {"meta.project": 10})

다음을 사용하세요.

db.foo.createIndex({"meta.project":1, "meta.type":1})
db.foo.aggregate([{$match: {"meta.project": 10}},
{$group: {_id: "$meta.type"}}])

이는 다음과 같이 작동합니다:

  1. meta.projectmeta.type복합 인덱스 를 생성하고 집계 을 지원합니다.

  2. $match 단계는 meta.project = 10 인 문서를 필터링합니다.

  3. $group 단계에서는 meta.type 를 그룹 키로 사용하여 고유 값당 하나의 문서 를 출력합니다.

시계열 컬렉션은 2dsphere 인덱스에 대한 쿼리에서 $geoNear 지리 공간적 데이터 를 정렬하기 위한 집계 단계만 지원 합니다. time series $nearSphere 컬렉션에는 및 $near 연산자를 사용할 수 없습니다.

time series 컬렉션 내 문서의 최대 크기는 4 MB입니다.

시계열 컬렉션에 1970-01-01T00:00:00.000Z 이전 또는 2038-01-19T03:14:07.000Z 이후에 timeField 타임스탬프가 있는 문서가 포함된 경우 TTL " time to live " 기능을 사용하여 컬렉션에서 문서를 삭제하지 않습니다.

TTL 삭제에 대한 자세한 내용은 TTL을 설정하여 컬렉션에서 데이터 만료하기를 참조하세요.

time series 컬렉션 에 1970-01-01T00:00:00.000Z 이전 또는 2038-01-19T03:14:07.000Z 이후에 timeField 타임스탬프가 있는 문서가 포함된 경우 timeField 에 인덱스 를 생성하여 쿼리를 최적화합니다.

업데이트 명령은 다음 요구 사항을 충족해야 합니다.

  • metaField 필드 값에 대해서만 일치시킬 수 있습니다.

  • metaField 필드 값만 수정할 수 있습니다.

  • 업데이트 문서에는 업데이트 연산자 표현식만 포함될 수 있습니다.

  • 업데이트 명령은 업데이트할 문서 수를 제한하지 않아야 합니다. multi: true를 설정하거나 updateMany() 메서드를 사용하세요.

  • 업데이트 명령에서 업서트: true를 설정해서는 안 됩니다.

오래된 데이터를 자동으로 삭제하려면 자동 삭제(TTL)를 설정하세요.

MongoDB 는 시계열 컬렉션에서 다음 인덱스를 부분적으로 지원합니다.

MongoDB 는 시계열 컬렉션에서 다음 인덱스 유형을 지원 하지 않습니다.

Time Series 컬렉션 에 세컨더리 인덱스 가 있고 기능 호환성 버전(fCV)을 다운그레이드해야 하는 경우, 먼저 다운그레이드된 fCV와 호환되지 않는 세컨더리 인덱스를 모두 삭제해야 합니다. 자세한 내용은 를 setFeatureCompatibilityVersion 참조하세요.

time series 컬렉션은 고정 사이즈 컬렉션으로 만들 수 없습니다.

컬렉션을 만들 때만 컬렉션 유형을 설정할 수 있습니다:

  • 기존 컬렉션 을 time series 컬렉션 으로 변환할 수 없습니다.

  • time series 컬렉션 은 다른 컬렉션 유형으로 변환할 수 없습니다.

기존 컬렉션에서 Time Series 컬렉션으로 데이터를 이동하려면 데이터를 Time Series 컬렉션으로 마이그레이션합니다.

컬렉션을 생성할 때 컬렉션의 timeFieldmetaField 매개변수만 설정할 수 있습니다. 이러한 매개변수는 나중에 수정할 수 없습니다.

세분성 매개변수 구성의 경우 버킷의 최대 크기는 측정값 1000 또는 데이터 125KB 중 더 작은 값입니다. 또한 MongoDB는 고유값이 많은 높은 카디널리티 데이터에 대해 더 낮은 최대 크기를 적용하여, 버킷 작업 세트가 WiredTiger 캐시에 맞도록 할 수 있습니다.

컬렉션의 granularity 또는 사용자 지정 버킷 매개변수 bucketMaxSpanSecondsbucketRoundingSeconds 를 설정하다 하면 버킷이 적용되는 기간을 늘릴 수는 있지만 줄일 수는 없습니다. collMod 명령을 사용하여 매개변수를 수정합니다. 예를 예시 다음과 같습니다.

db.runCommand({
collMod: "timeseries",
timeseries: { bucketMaxSpanSeconds: 3600, bucketRoundingSeconds: 3600 }
})

참고

bucketMaxSpanSecondsbucketRoundingSeconds는 같아야 합니다. 한 매개변수를 수정하면 다른 매개변수도 동일한 값으로 설정해야 합니다.

Time series 컬렉션에는 몇 가지 샤딩 제한이 있습니다.

샤딩된 time series 컬렉션에서는 샤딩 관리 명령을 실행할 수 없습니다.

시계열 컬렉션을 샤딩할 때 샤드 키에 다음 필드만 지정할 수 있습니다.

  • metaField

  • 하위 필드 metaField

  • timeField

샤드 키에 이러한 필드의 조합을 지정할 수 있습니다. 샤드 키 패턴에는 _id를 포함한 다른 필드가 허용되지 않습니다.

샤드 키를 지정하는 경우:

분할 키로 timeField 지정하지 마세요. timeField단조롭게 증가하기 때문에 클러스터 내의 단일 청크에 모든 쓰기가 표시될 수 있습니다. 이상적으로는 데이터가 여러 청크에 고르게 분산되어 있는 것이 좋습니다.

분할 키를 가장 잘 선택하는 방법을 알아보려면 다음을 참조하세요.

MongoDB 8.0 부터는 time series 컬렉션 에서 샤드 키 timeField 를 사용하는 것이 더 이상 사용되지 않습니다.

샤딩된 time series 컬렉션은 다시 샤딩할 수 없습니다. 하지만 샤드 키를 세분화할 수 있습니다.

트랜잭션에서 time series 컬렉션에 쓸 수 없습니다.

참고

MongoDB 는 트랜잭션의 time series 컬렉션에서 읽기를 지원합니다.

  • 시계열 컬렉션은 쓰기 가능한 비실체화 뷰입니다. time series 컬렉션에는 보기 제한이 적용됩니다.

  • time-series 컬렉션 네임스페이스(즉, system.buckets 접두사가 붙은 컬렉션)에서는 뷰를 만들 수 없습니다.

읽기 고려 "snapshot"이 있는 Time Series 컬렉션에 대한 읽기 작업은 읽기 작업에서 컬렉션에 대한 동시 제거 또는 이름 변경 작업이 없는 경우에만 스냅샷 격리를 보장합니다. 동일한 네임스페이스에서 세분성 설정이 다른 Time Series 컬렉션을 다시 생성해도 전체 스냅샷 격리가 이루어지지 않습니다.

돌아가기

모범 사례