create
정의
create
컬렉션 또는 뷰를 명시적으로 만듭니다.
참고
이 명령으로 생성된 뷰는 구체화된 뷰를 참조하지 않습니다. 온디맨드 구체화된 뷰에 대한 설명은
$merge
를 대신 참조하세요.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
참고
이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원 에 대한 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
create
명령의 구문은 다음과 같습니다.
db.runCommand( { create: <collection or view name>, capped: <true|false>, timeseries: { timeField: <string>, metaField: <string>, granularity: <string> }, expireAfterSeconds: <number>, clusteredIndex: <document>, // Added in MongoDB 5.3 changeStreamPreAndPostImages: <document>, // Added in MongoDB 6.0 autoIndexId: <true|false>, size: <max_size>, max: <max_documents>, storageEngine: <document>, validator: <document>, validationLevel: <string>, validationAction: <string>, indexOptionDefaults: <document>, viewOn: <source>, pipeline: <pipeline>, collation: <document>, writeConcern: <document>, encryptedFields: <document>, comment: <any> }
명령 필드
create
명령에는 다음과 같은 필드가 있습니다.
필드 | 유형 | 설명 | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
create | 문자열 | 새 컬렉션 또는 뷰의 이름입니다. 이름 지정 제한 사항을 참조하세요. | ||||||||||||||||
capped | 부울 | |||||||||||||||||
timeseries.timeField | 문자열 | time series 컬렉션을 만들 때 필요합니다. 각 time-series 문서에서 날짜를 포함하는 필드의 이름입니다. time series 컬렉션의 문서에는 timeField 의 값으로 유효한 BSON 날짜가 있어야 합니다. | ||||||||||||||||
timeseries.metaField | 문자열 | 선택 사항입니다. 각 time series 문서에 메타데이터가 포함된 필드의 이름입니다. 지정된 필드의 메타데이터는 고유한 문서 시리즈에 레이블을 지정하는 데 사용되는 데이터여야 합니다. 메타데이터는 거의 변경되지 않아야 합니다. 지정한 필드의 이름이 | ||||||||||||||||
timeseries.granularity | 문자열 | 선택 사항. 가능한 값은 "seconds" (기본값), "minutes" 및 "hours" 입니다. 연속적으로 수신되는 측정값 사이의 시간 범위와 가장 가까운 값으로 세분성을 설정합니다. granularity 매개변수를 설정하면 Time Series 컬렉션의 데이터가 내부적으로 저장되는 방식이 최적화되어 성능이 정확하게 향상됩니다. | ||||||||||||||||
expireAfterSeconds | 숫자 | 선택 사항입니다. time series 컬렉션 또는 클러스터형 컬렉션의 문서가 만료되는 시간(초)을 지정합니다. MongoDB는 만료된 문서를 자동으로 삭제합니다. | ||||||||||||||||
문서 | MongoDB 5.3부터는 클러스터형 컬렉션을 사용하여 컬렉션을 만들 수 있습니다. 클러스터형 인덱스를 사용하여 만든 컬렉션을 클러스터형 인덱스라고 합니다. 클러스터형 컬렉션을 참조하세요.
버전 5.3에 추가. | |||||||||||||||||
문서 | 선택 사항. MongoDB 6.0부터는 변경 스트림 이벤트를 사용하여 문서의 변경 전후 버전(문서의 전후 이미지)을 출력할 수 있습니다.
컬렉션의 변경 스트림 사전 및 사후 이미지를 활성화하려면 변경 스트림s 출력에 대한 전체 예시는 전후 이미지를 포함하는 문서의 변경 스트림s를 참조하세요. 이 페이지의 버전 6.0에 추가. | |||||||||||||||||
autoIndexId | 부울 | 선택 사항. 중요MongoDB 4.0부터 버전 3.2부터 더 이상 사용되지 않습니다. | ||||||||||||||||
size | integer | 선택 사항. 고정 사이즈 컬렉션의 최대 크기를 바이트 단위로 지정합니다. 고정 사이즈 컬렉션이 최대 크기에 도달하면 MongoDB는 새 문서를 위한 공간을 확보하기 위해 이전 문서를 제거합니다. 고정 사이즈 컬렉션의 경우 size 필드는 필수이며 다른 컬렉션의 경우 무시됩니다. | ||||||||||||||||
max | integer | 선택 사항입니다. 고정 사이즈 컬렉션에 허용되는 최대 문서 수입니다. size 제한이 이 제한보다 우선합니다. 고정 사이즈 컬렉션이 최대 문서 수에 도달하기 전에 size 제한에 도달하면 MongoDB는 오래된 문서를 제거합니다. max 제한을 사용하는 것을 선호하는 경우, 고정 사이즈 컬렉션에 필요한 size 제한이 최대 문서 수를 포함하기에 충분한지 확인합니다. | ||||||||||||||||
storageEngine | 문서 | 선택 사항. WiredTiger 스토리지 엔진에서만 사용할 수 있습니다. 사용자가 컬렉션을 생성할 때 컬렉션별로 스토리지 엔진에 대한 구성을 지정할 수 있습니다.
collection을 생성할 때 지정한 스토리지 엔진 구성은 다른 스토리지 엔진을 사용하는 멤버가 있는 복제본 세트를 지원하기 위해 복제 중에 유효성을 검사하고 oplog에 기록합니다. 자세한 내용은 스토리지 엔진 옵션 지정을 참조하세요. | ||||||||||||||||
validator | 문서 | 선택 사항. 사용자가 collection에 대한 유효성 검사 규칙이나 표현식 을 지정할 수 있습니다. 자세한 내용은 스키마 유효성 검사를 참조하세요.
| ||||||||||||||||
validationLevel | 문자열 | 선택 사항입니다. 업데이트 중에 MongoDB가 기존 문서에 유효성 검사 규칙을 얼마나 엄격하게 적용하는지 결정합니다.
| ||||||||||||||||
validationAction | 문자열 | 선택 사항. 유효하지 않은 문서를 문서 유효성 검사는
| ||||||||||||||||
indexOptionDefaults | 문서 | 선택 사항. 사용자가 컬렉션을 생성할 때 인덱스에 대한 기본 구성을 지정할 수 있습니다.
인덱스를 만들 때 지정한 스토리지 엔진 구성은 다른 스토리지 엔진을 사용하는 멤버가 있는 복제본 세트를 지원하기 위해 복제 중에 유효성이 검사되고 oplog에 기록됩니다. | ||||||||||||||||
viewOn | 문자열 | 뷰를 생성할 소스 컬렉션 또는 뷰의 이름입니다. 이 이름은 컬렉션 또는 뷰의 전체 네임스페이스가 아니며, 즉 데이터베이스 이름을 포함하지 않고 만들려는 뷰와 동일한 데이터베이스를 의미합니다. 소스 컬렉션과 동일한 데이터베이스에 뷰를 생성해야 합니다.
| ||||||||||||||||
pipeline | 배열 | 집계 파이프라인 단계로 구성된 배열입니다. 보기 정의 뷰 정의는 공개입니다. 즉, 뷰에 대한
| ||||||||||||||||
collation | 컬렉션 또는 뷰의 기본 데이터 정렬을 지정합니다. 데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다. 데이터 정렬 옵션의 구문은 다음과 같습니다:
데이터 정렬을 지정할 때 컬렉션 수준에서 데이터 정렬을 지정하는 경우:
컬렉션 또는 연산에 대한 데이터 정렬이 지정되지 않은 경우, MongoDB는 이전 버전에서 문자열 비교에 사용된 간단한 이진 비교를 사용합니다. 뷰의 경우 데이터 정렬이 지정되지 않았으면 뷰의 기본 데이터 정렬은 "simple" 이진 비교 데이터 정렬기입니다. 컬렉션에 대한 뷰의 경우, 뷰는 컬렉션의 데이터 정렬 설정을 상속하지 않습니다. 다른 뷰에 대한 뷰의 경우 만들려는 뷰에 동일한 데이터 정렬 설정을 지정해야 합니다. 컬렉션 또는 뷰를 만든 후에는 기본 데이터 정렬을 업데이트할 수 없습니다. 컬렉션 생성 시 기본 데이터 정렬을 지정하는 예시는 데이터 정렬 지정을 참조합니다. | |||||||||||||||||
writeConcern | 문서 | 선택 사항입니다. 작업에 대한 쓰기 고려를 표현하는 문서입니다. 기본값 쓰기 고려를 사용하려면 생략합니다. 샤딩된 클러스터에서 실행하는 경우 | ||||||||||||||||
encryptedFields | 문서 | 선택 사항입니다. 생성 중인 컬렉션에 대해 쿼리 가능한 암호화를 구성하는 문서입니다. 컬렉션에서 암호화된 필드를 사용하려면 새 구성 옵션을 지정합니다. 이 구성을 만들거나 편집하려면 컬렉션을 생성하고 수정할 수 있는 권한이 있어야 합니다. 구성에는 필드 목록과 해당 키 식별자, 유형 및 지원되는 쿼리가 포함됩니다.
자세한 내용은 빠른 시작을 참조하세요. | ||||||||||||||||
comment | any | 선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.
댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다. 버전 4.4에 추가되었습니다. |
db.createCollection()
메서드와 db.createView()
메서드는 create
명령을 래핑합니다.
행동
리소스 잠금
버전 4.2에서 변경되었습니다.
create
은 작업 기간에 지정된 컬렉션 또는 뷰에 대한 배타적 잠금을 얻습니다. 컬렉션에 이루어진 모든 후속 작업은 반드시 create
이 잠금을 해제할 때까지 기다려야 합니다. create
은 일반적으로 이 잠금을 짧은 시간 동안 유지합니다.
뷰를 만들려면 데이터베이스의 system.views
컬렉션에 대한 추가 배타 락을 얻어야 합니다. 이 잠금은 명령이 완료될 때까지 데이터베이스의 뷰 생성 또는 수정을 차단합니다.
트랜잭션
버전 4.4에서 변경되었습니다.
트랜잭션이 교차 샤드 쓰기 트랜잭션(write transaction)인 이 아닌 경우 분산 트랜잭션 내에서 컬렉션과 인덱스를 생성할 수 있습니다.
트랜잭션에서 create
를 사용하려면 트랜잭션에서 읽기 고려 "local"
를 사용해야 합니다. "local"
이외의 읽기 고려 수준을 지정하면 트랜잭션이 실패합니다.
Stable API
버전 5.0에서 변경됨
stable API V1를 사용하는 경우 create
명령에 다음 필드를 지정할 수 없습니다.
autoIndexId
capped
indexOptionDefaults
max
size
storageEngine
액세스 제어
배포서버에서 인증/권한 부여를 시행하는 경우 create
에 다음 권한이 필요합니다.
작업 | 필수 권한 |
---|---|
비고정 사이즈 컬렉션 생성하기 | 데이터베이스의
|
고정 사이즈 컬렉션 생성 |
|
뷰 만들기 |
그러나 사용자에게 데이터베이스에 대한 |
이 데이터베이스에 대해 readWrite
기본 제공 역할이 있는 사용자에게는 나열된 연산을 실행하는 데 필요한 권한이 있습니다. 필요한 역할이 있는 사용자 생성을 실행하거나 기존 사용자에게 역할 허용을 실행하세요.
예시
고정 사이즈 컬렉션 생성
64킬로바이트로 제한된 고정 사이즈 컬렉션을 만들려면 다음 형식의 명령을 실행하세요.
db.runCommand( { create: "collection", capped: true, size: 64 * 1024 } )
Time Series 컬렉션 만들기
지난 24시간 동안의 날씨 데이터를 캡처하는 time series 컬렉션을 생성하려면 다음 명령을 실행합니다.
db.createCollection( "weather24h", { timeseries: { timeField: "timestamp", metaField: "data", granularity: "hours" }, expireAfterSeconds: 86400 } )
참고
이 예시에서는 expireAfterSeconds
를 86400
으로 지정했는데, 이는 문서가 timestamp
값 이후 86400
초 후에 만료된다는 의미입니다. Time Series Collections (TTL) 자동 제거 설정을 참조하세요.
클러스터형 컬렉션 생성
다음 create
예시에서는 products
라고 명명된 클러스터형 컬렉션 을 추가합니다.
db.runCommand( { create: "products", clusteredIndex: { "key": { _id: 1 }, "unique": true, "name": "products clustered key" } } )
다음 예시에서는 clusteredIndex이(가) 지정됩니다.
"key": { _id: 1 }
,_id
필드에 클러스터형 인덱스 키 값이 설정됩니다."unique": true
, 클러스터형 인덱스 키 값이 고유해야 함을 표시합니다."name": "products clustered key"
, 클러스터형 인덱스 이름을 설정합니다.
문서에 대한 변경 스트림 전후 이미지를 사용하여 collection 생성하기
MongoDB 6.0부터는 변경 스트림 이벤트를 사용하여 문서의 변경 전후 버전(문서의 전후 이미지)을 출력할 수 있습니다.
사전 이미지는 문서가 교체, 업데이트 또는 삭제되기 전의 문서입니다. 삽입된 문서에는 사전 이미지가 없습니다.
사후 이미지는 문서가 삽입, 교체, 업데이트된 후의 문서입니다. 삭제된 문서에 대한 사후 이미지가 없습니다.
db.createCollection()
,create
또는collMod
를 사용하는 컬렉션에 대해changeStreamPreAndPostImages
를 활성화합니다.
다음 예시에서는 changeStreamPreAndPostImages가 활성화된 collection을 생성합니다.
db.runCommand( { create: "temperatureSensor", changeStreamPreAndPostImages: { enabled: true } } )
이미지가 다음과 같은 경우 변경 스트림 이벤트에 사전 및 사후 이미지를 사용할 수 없습니다.
문서 업데이트 또는 삭제 작업 시 collection에서 활성화되지 않았습니다.
expireAfterSeconds
에서 전후 이미지 보존 시간 설정 이후에 제거됩니다.다음 예시에서는 전체 클러스터에서
expireAfterSeconds
를100
초로 설정합니다.use admin db.runCommand( { setClusterParameter: { changeStreamOptions: { preAndPostImages: { expireAfterSeconds: 100 } } } } ) 다음 예시에서는
expireAfterSeconds
등 현재changeStreamOptions
설정을 반환합니다.db.adminCommand( { getClusterParameter: "changeStreamOptions" } ) expireAfterSeconds
를off
로 설정하면 기본 보존 정책이 사용되며, 해당 변경 스트림 이벤트가 oplog에서 제거될 때까지 사전 및 사후 이미지가 보존됩니다.변경 스트림 이벤트가 oplog에서 제거되면
expireAfterSeconds
사전 및 사후 이미지 보존 시간에 관계없이 해당 사전 및 사후 이미지도 삭제됩니다.
추가 고려 사항
전후 이미지를 활성화하면 저장 공간이 소모되고 처리 시간이 늘어납니다. 필요한 경우에만 전후 이미지를 활성화하세요.
변경 스트림 이벤트 크기를 16메가바이트 미만으로 제한합니다. 이벤트 크기를 제한하려면 다음을 수행하면 됩니다.
문서 크기를 8메가바이트로 제한합니다.
updateDescription
과 같은 다른 변경 스트림 이벤트 필드가 크지 않은 경우 변경 스트림 출력에서 사전 및 사후 이미지를 동시에 요청할 수 있습니다.updateDescription
과 같은 다른 변경 스트림 이벤트 필드가 크지 않은 경우 최대 16메가바이트 문서에 대해 변경 스트림 출력에서 사후 이미지만 요청합니다.다음과 같은 경우 최대 16메가바이트의 문서에 대해 변경 스트림 출력에서 사전 이미지만 요청합니다.
문서 업데이트가 문서 구조나 내용의 작은 부분에만 영향을 미칩니다. 그리고
replace
변경 이벤트를 발생시키지 않습니다.replace
이벤트에는 항상 후이미지가 포함됩니다.
사전 이미지를 요청하려면
db.collection.watch()
에서fullDocumentBeforeChange
를required
또는whenAvailable
로 설정합니다. 사후 이미지를 요청하려면 동일한 방법으로fullDocument
를 설정합니다.사전 이미지가
config.system.preimages
컬렉션에 기록됩니다.config.system.preimages
collection은 커질 수 있습니다. collection 크기를 제한하려면 앞서 표시된 대로 사전 이미지에 대해expireAfterSeconds
시간을 설정할 수 있습니다.사전 이미지는 백그라운드 프로세스가 비동기적으로 제거합니다.
중요
이전 버전과 호환되지 않는 기능
MongoDB 6.0부터는 변경 스트림에 문서 사전 및 사후 이미지를 사용하는 경우 이전 MongoDB 버전으로 다운그레이드하기 전에 collMod
명령을 사용하여 각 collection에 대해 changeStreamPreAndPostImages를 비활성화해야 합니다.
팁
다음도 참조하세요.
변경 스트림 이벤트 및 출력에 대해서는 변경 이벤트를 참조하세요.
컬렉션에서 변경 사항을 확인하려면
db.collection.watch()
를 참조하세요.변경 스트림s 출력에 대한 전체 예시는 전후 이미지를 포함하는 문서의 변경 스트림s를 참조하세요.
뷰 만들기
참고
이 명령으로 생성된 뷰는 구체화된 뷰를 참조하지 않습니다. 온디맨드 구체화된 뷰에 대한 설명은 $merge
를 참조하세요.
버전 4.2에서 변경되었습니다.
보기 정의 pipeline
에는 $out
또는 $merge
단계를 포함할 수 없습니다. 이 제한은 $lookup
단계 또는 $facet
단계에서 사용되는 파이프라인과 같은 임베디드 파이프라인에도 적용됩니다.
명령을 사용하여 뷰 create
를 만들려면 다음 구문을 사용합니다.
db.runCommand( { create: <view>, viewOn: <source>, pipeline: <pipeline> } )
또는 데이터 정렬을 지정하는 경우:
db.runCommand( { create: <view>, viewOn: <source>, pipeline: <pipeline>, collation: <collation> } )
예를 들어, 다음 문서를 사용하여 survey
컬렉션을 만듭니다.
db.survey.insertMany( [ { _id: 1, empNumber: "abc123", feedback: { management: 3, environment: 3 }, department: "A" }, { _id: 2, empNumber: "xyz987", feedback: { management: 2, environment: 3 }, department: "B" }, { _id: 3, empNumber: "ijk555", feedback: { management: 3, environment: 4 }, department: "A" } ] )
다음 작업은 _id
, feedback.management
및 department
필드가 있는 managementRatings
뷰를 만듭니다:
db.runCommand ( { create: "managementFeedback", viewOn: "survey", pipeline: [ { $project: { "management": "$feedback.management", department: 1 } } ] } )
중요
뷰 정의는 공개입니다. 즉, 뷰에 대한 db.getCollectionInfos()
및 explain
작업에는 뷰를 정의하는 파이프라인이 포함됩니다. 따라서 뷰 정의에 민감한 필드와 값을 직접 참조하지 않는 것이 좋습니다.
데이터 정렬 지정
데이터 정렬은 collection 또는 보기 수준에서 지정할 수 있습니다. 예를 들어 다음 연산은 collection에 대한 데이터 정렬을 지정하여 collection을 만듭니다(데이터 정렬 필드에 대한 설명은 데이터 정렬 문서 참조).
db.runCommand ( { create: "myColl", collation: { locale: "fr" } });
이 데이터 정렬은 다른 데이터 정렬을 명시적으로 지정하지 않는 한 데이터 정렬을 지원하는 인덱스 및 작업에서 사용됩니다. 예를 들어 myColl
에 다음 문서를 삽입합니다.
{ _id: 1, category: "café" } { _id: 2, category: "cafe" } { _id: 3, category: "cafE" }
다음 작업은 컬렉션의 데이터 정렬을 사용합니다.
db.myColl.find().sort( { category: 1 } )
이 작업은 다음 순서로 문서를 반환합니다.
{ "_id" : 2, "category" : "cafe" } { "_id" : 3, "category" : "cafE" } { "_id" : 1, "category" : "café" }
단순 이진 데이터 정렬을 사용하는 collection에 대한 동일한 작업(즉, 특정 데이터 정렬 세트 없음)은 다음 순서로 문서를 반환합니다.
{ "_id" : 3, "category" : "cafE" } { "_id" : 2, "category" : "cafe" } { "_id" : 1, "category" : "café" }
스토리지 엔진 옵션 지정하기
db.createCollection()
을(를) 사용하여 컬렉션을 생성할 때 컬렉션별 스토리지 엔진 구성 옵션을 지정할 수 있습니다. 다음 작업을 고려하세요:
db.runCommand( { create: "users", storageEngine: { wiredTiger: { configString: "<option>=<setting>" } } } )
이 작업은 MongoDB가 wiredTiger
스토리지 엔진에 전달할 특정 구성 문자열을 사용하여 users
라는 새 컬렉션을 생성합니다. 특정 wiredTiger
옵션에 대해서는 컬렉션 수준 옵션에 대한 WiredTiger 설명서를 참조하세요.