db.createCollection()

선택 사항입니다. 각 time series 문서에 메타데이터가 포함된 필드의 이름입니다. 지정된 필드의 메타데이터는 고유한 문서 시리즈에 레이블을 지정하는 데 사용되는 데이터여야 합니다. 메타데이터는 거의 변경되지 않아야 합니다.

지정한 필드의 이름이 _id이거나 timeseries.timeField와 같지 않을 수 있습니다. 필드는 배열을 제외한 모든 유형이 가능합니다.

선택사항. bucketRoundingSeconds 및 bucketMaxSpanSeconds를 설정하는 경우 사용하지 마세요. 가능한 값은 seconds(기본값), minutes, hours입니다.

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

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

선택 사항. granularity 대신 bucketRoundingSeconds와 함께 사용됩니다. 같은 버킷에 있는 타임스탬프 사이의 최대 시간을 설정합니다. 가능한 값은 1-31536000입니다. bucketMaxSpanSeconds를 설정하는 경우 bucketRoundingSeconds를 동일한 값으로 설정해야 합니다.

MongoDB 6.3 이하로 다운그레이드하려면 해당 granularity 값을 사용하도록 컬렉션을 수정하거나 제거해야 합니다. 자세한 내용은 collMod 를 참조하세요.

선택 사항, granularity 대신 bucketMaxSpanSeconds 와 함께 사용됩니다. MongoDB가 새 버킷에 대한 최소 타임스탬프를 설정하다 반내림할 시간(초)을 설정합니다. bucketMaxSpanSeconds와 같아야 합니다.

예를 들어 두 매개변수를 모두 1800으로 설정하면 새 버킷이 가장 가까운 30분으로 반올림됩니다. 시간이 2023-03-27T18:24:35Z인 문서가 기존 버킷에 맞지 않는 경우, MongoDB는 최소 시간이 2023-03-27T18:00:00Z이고 최대 시간이 2023-03-27T18:30:00Z인 새 버킷을 생성합니다.

선택 사항입니다. time series 컬렉션 또는 클러스터형 컬렉션의 문서가 만료되는 시간(초)을 지정합니다. MongoDB는 만료된 문서를 자동으로 삭제합니다.

클러스터형 컬렉션의 경우 문서는 클러스터형 인덱스 키 _id에 따라 자동으로 삭제되며 값은 날짜 유형이어야 합니다. TTL 인덱스를 참조하세요.

MongoDB 5.3부터 클러스터형 인덱스를 사용하여 컬렉션을 생성할 수 있습니다. 클러스터형 인덱스는 컬렉션과 동일한 WiredTiger 파일에 저장됩니다. 결과 컬렉션을 클러스터형 컬렉션이라고 합니다.

clusteredIndex 필드의 구문은 다음과 같습니다.

clusteredIndex: {
   key: <object>,
   unique: <boolean>,
   name: <string>
}

key

필수 사항입니다. 클러스터형 인덱스 키 필드입니다. { _id: 1 }(으)로 설정해야 합니다. _id 필드의 기본값은 자동으로 생성된 고유 객체 식별자이지만, 클러스터형 인덱스 키 값을 직접 설정할 수 있습니다.

unique

필수입니다. true(으)로 설정해야 합니다. 고유 인덱스는 클러스터된 인덱스 키 값이 인덱스의 기존 값과 일치하는 경우 collection에서 삽입 또는 업데이트된 문서를 허용하지 않음을 나타냅니다.

name

선택 사항. 클러스터된 인덱스를 고유하게 식별하는 이름입니다.

선택 사항.

MongoDB 6.0부터는 변경 스트림 이벤트를 사용하여 문서의 변경 전후 버전(문서의 전후 이미지)을 출력할 수 있습니다.

• 사전 이미지는 문서가 교체, 업데이트 또는 삭제되기 전의 문서입니다. 삽입된 문서에는 사전 이미지가 없습니다.

• 사후 이미지는 문서가 삽입, 교체, 업데이트된 후의 문서입니다. 삭제된 문서에 대한 사후 이미지가 없습니다.

• db.createCollection(), create 또는 collMod(을)를 사용하여 컬렉션의 changeStreamPreAndPostImages(을)를 활성화합니다.

changeStreamPreAndPostImages 의 구문은 다음과 같습니다:

changeStreamPreAndPostImages: {
   enabled: <boolean>
}

컬렉션의 변경 스트림 사전 및 사후 이미지를 활성화하려면 enabled를 true로 설정합니다.

변경 스트림s 출력에 대한 전체 예시는 전후 이미지를 포함하는 문서의 변경 스트림s를 참조하세요.

이 페이지의 db.createCollection() 예시는 문서의 변경 스트림 사전 및 사후 이미지가 있는 컬렉션 만들기를 참조하세요.

선택 사항. WiredTiger 스토리지 엔진에서만 사용할 수 있습니다.

사용자가 컬렉션을 생성할 때 컬렉션별로 스토리지 엔진에 대한 구성을 지정할 수 있습니다. storageEngine 옵션의 값은 다음과 같은 형식이어야 합니다.

{ <storage-engine-name>: <options> }

collection을 생성할 때 지정한 스토리지 엔진 구성은 다른 스토리지 엔진을 사용하는 멤버가 있는 복제본 세트를 지원하기 위해 복제 중에 유효성을 검사하고 oplog에 기록합니다.

MongoDB 7.2 부터는 db.createCollection() 으로 컬렉션을 생성할 때 wiredTiger 스토리지 엔진 암호화 옵션을 지정할 수 없습니다. WiredTiger 스토리지 엔진에 대한 암호화를 구성하려면 미사용 데이터 암호화를 참조하세요 .

자세한 내용은 스토리지 엔진 옵션 지정을 참조하십시오.

선택 사항. 사용자가 컬렉션에 대한 유효성 검사 규칙 또는 표현식을 지정할 수 있습니다.

validator 옵션은 유효성 검사 규칙 또는 표현식을 지정하는 문서를 사용합니다. $near, $nearSphere, $text, $where을(를) 제외하고 쿼리 연산자와 동일한 연산자를 사용하여 표현식을 지정할 수 있습니다.

스키마 유효성 검사를 사용하여 collection을 생성하는 방법을 자세히 알아보려면 JSON Schema 유효성 검사 지정을 참조하세요.

선택 사항입니다. 업데이트 중에 MongoDB가 기존 문서에 유효성 검사 규칙을 얼마나 엄격하게 적용하는지 결정합니다.

"off"

삽입 또는 업데이트에 대한 유효성 검사가 없습니다.

"strict"

기본값 모든 삽입 및 모든 업데이트에 유효성 검사 규칙을 적용합니다.

"moderate"

기존의 유효한 문서에 대한 삽입 및 업데이트에 유효성 검사 규칙을 적용합니다. 기존의 유효하지 않은 문서에 대한 업데이트에는 규칙을 적용하지 마세요.

validationLevel 사용 예시는 기존 문서에 대한 유효성 검사 수준 지정을 참조하세요.

선택 사항. 유효하지 않은 문서를 error로 처리할지, 아니면 유효하지 않은 문서를 삽입할 수 있도록 허용하되 위반 사항에 대해 warn으로 처리할지 여부를 결정합니다.

중요: 문서 유효성 검사는 validationLevel 규정에 따라 결정된 문서에만 적용됩니다.

validationAction 사용 예시는 유효하지 않은 문서 처리 방법 선택을 참조하세요.

선택 사항. 사용자가 컬렉션을 생성할 때 인덱스에 대한 기본 구성을 지정할 수 있습니다.

indexOptionDefaults 옵션은 storageEngine 문서를 허용하며, 그 형식은 다음과 같아야 합니다.

{ <storage-engine-name>: <options> }

인덱스를 만들 때 지정한 스토리지 엔진 구성은 다른 스토리지 엔진을 사용하는 멤버가 있는 복제본 세트를 지원하기 위해 복제 중에 유효성이 검사되고 oplog에 기록됩니다.

컬렉션의 기본 데이터 정렬을 지정합니다.

데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다.

데이터 정렬 옵션의 구문은 다음과 같습니다:

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

데이터 정렬을 지정할 때 locale 필드는 필수이고, 다른 데이터 정렬 필드는 모두 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요.

컬렉션 수준에서 데이터 정렬을 지정하는 경우:

• 인덱스 생성 작업에서 명시적으로 다른 데이터 정렬을 지정하지 않는 한 해당 컬렉션의 인덱스는 해당 데이터 정렬로 생성됩니다.

• 해당 컬렉션에 대한 작업은 명시적으로 다른 데이터 정렬을 지정하지 않으면 컬렉션의 기본 데이터 정렬을 사용합니다.

  한 연산에 대해 여러 데이터 정렬을 지정할 수 없습니다. 예를 들어 필드별로 서로 다른 데이터 정렬을 지정할 수 없으며 정렬과 함께 찾기를 수행하는 경우 찾기 와 정렬에서 각각 다른 데이터 정렬을 사용하는 것은 허용되지 않습니다.

컬렉션 또는 연산에 대한 데이터 정렬이 지정되지 않은 경우, MongoDB는 이전 버전에서 문자열 비교에 사용된 간단한 이진 비교를 사용합니다.

collection의 경우 collection 생성 중에만 데이터 정렬을 지정할 수 있습니다. 일단 설정하면 collection의 기본 데이터 정렬을 수정할 수 없습니다.

예시는 데이터 정렬 지정을 참조하세요.

선택 사항입니다. 작업에 대한 쓰기 고려를 표현하는 문서입니다. 기본값 쓰기 고려를 사용하려면 생략합니다.

샤딩된 클러스터에서 실행되는 경우 mongos는 create 명령의 쓰기 고려와 해당 헬퍼 db.createCollection()을 "majority"로 변환합니다.