문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

Time Series 컬렉션 샤드

이 페이지의 내용

  • 전제 조건
  • 절차
  • 추가 정보

버전 5.1에 추가되었습니다.

이 튜토리얼을 사용하여 신규 또는 기존 time series 컬렉션을 샤딩합니다.

중요

이 튜토리얼을 완료하기 전에 time series 컬렉션에 대한 샤딩 제한 사항 을 검토하세요.

전제 조건

Time Series 컬렉션을 샤딩하려면 Time Series 컬렉션이 포함된 데이터베이스를 호스팅 할 샤드 클러스터를 배포 해야 합니다.

절차

새 Time Series 컬렉션 샤딩

1

샤드 클러스터에 연결합니다.

mongosh 를 샤드 클러스터의 mongos 에 연결합니다. mongos 이(가) 실행 중인 host 및 port 을(를) 지정합니다.

mongosh --host <hostname> --port <port>
2

데이터베이스에서 샤딩이 활성화되어 있는지 확인합니다.

sh.status() 를 실행하여 데이터베이스에서 샤딩이 활성화되어 있는지 확인합니다.

sh.status()

이 명령은 샤딩 정보를 반환합니다.

--- Sharding Status ---
   sharding version: {
      "_id" : 1,
      "minCompatibleVersion" : 5,
      "currentVersion" : 6,
...
3

컬렉션을 만듭니다.

shardCollection() timeseries 옵션과 함께 메서드를 사용합니다.

예를 들면 다음과 같습니다.

sh.shardCollection(
   "test.weather",
   { "metadata.sensorId": 1 },
   {
      timeseries: {
         timeField: "timestamp",
         metaField: "metadata",
         granularity: "hours"
      }
   }
)

이 예에서 sh.shardCollection() 는 다음과 같습니다.

  • test 데이터베이스에 이름이 weather 인 새 time series 컬렉션을 샤드합니다.

  • metadata.sensorId 필드를 샤드 키로 지정합니다.

  • granularity 시간을 지정합니다.

다음 문서에는 컬렉션에 대한 적절한 메타데이터가 포함되어 있습니다.

db.weather.insertOne( {
   "metadata": { "sensorId": 5578, "type": "temperature" },
   "timestamp": ISODate("2021-05-18T00:00:00.000Z"),
   "temp": 12
} )

기존 Time Series 컬렉션 샤딩

1

샤드 클러스터에 연결합니다.

mongosh 를 샤드 클러스터의 mongos 에 연결합니다. mongos 가 실행 중인 host 및 port 를 지정합니다.

mongosh --host <hostname> --port <port>
2

데이터베이스에서 샤딩이 활성화되어 있는지 확인합니다.

sh.status() 를 실행하여 데이터베이스에서 샤딩이 활성화되어 있는지 확인합니다.

sh.status()

이 명령은 샤딩 정보를 반환합니다.

--- Sharding Status ---
   sharding version: {
      "_id" : 1,
      "minCompatibleVersion" : 5,
      "currentVersion" : 6,
...
3

컬렉션에 해시된 인덱스를 만듭니다.

샤드 키를 지원하는 인덱스를 생성하여 컬렉션에서 샤딩을 활성화합니다.

다음 속성을 가진 time series 컬렉션을 가정해 보겠습니다.

db.createCollection(
   "deliverySensor",
   {
      timeseries: {
         timeField: "timestamp",
         metaField: "metadata",
         granularity: "minutes"
      }
   }
)

컬렉션의 샘플 문서는 다음과 같습니다.

db.deliverySensor.insertOne( {
   "metadata": { "location": "USA", "vehicle": "truck" },
   "timestamp": ISODate("2021-08-21T00:00:10.000Z"),
   "speed": 50
} )

다음 명령을 실행하여 metadata.location 필드에 해시 인덱스를 생성합니다.

db.deliverySensor.createIndex( { "metadata.location" : "hashed" } )
4

컬렉션을 샤딩합니다.

shardCollection() 메서드를 사용하여 컬렉션을 샤딩합니다.

이전 단계에서 설명한 deliverySensor 컬렉션을 샤딩하려면 다음 명령을 실행합니다.

sh.shardCollection( "test.deliverySensor", { "metadata.location": "hashed" } )

이 예에서 sh.shardCollection() 는 다음과 같습니다.

  • test 데이터베이스에 이름이 deliverySensor 인 기존 time series 컬렉션을 샤드합니다.

  • metadata.location 필드를 샤드 키로 지정합니다. location 은 컬렉션 metaField 의 하위 필드입니다.

sh.shardCollection() 에 지정한 컬렉션이 time series 컬렉션인 경우 timeseries 옵션을 지정할 필요가 없습니다.

추가 정보

← Time Series 위에 구체화된 뷰 빌드하기
Time Series 컬렉션 모범 사례 →

이 페이지의 내용