Docs Menu
Docs Home
/
MongoDB 매뉴얼
/

시계열 수집 제한 사항

이 페이지의 내용

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

Time Series 컬렉션은 일반적으로 일반 컬렉션처럼 작동하지만, 몇 가지 제한이 있습니다.

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

$merge 집계 단계는 다른 컬렉션의 데이터를 Time Series 컬렉션에 추가하는 데 사용할 수 없습니다. $out 집계 단계를 사용하여 문서를 Time Series 컬렉션에 씁니다.

$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을 그룹 키로 사용하여 고유 값당 문서 하나를 출력합니다.

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

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 컬렉션에 timeField 타임스탬프가 1970-01-01T00:00:00.000Z 이전 또는 2038-01-19T03:14:07.000Z 이후인 문서가 포함되어 있는 경우 timeField에 인덱스를 만들어 쿼리를 최적화합니다.

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

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

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

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

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

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

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

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

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

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 컬렉션을 다시 생성해도 전체 스냅샷 격리가 이루어지지 않습니다.

돌아가기

모범 사례