끼워 넣다

정의

insert

insert 명령은 하나 이상의 문서를 삽입하고 모든 삽입 상태가 포함된 문서를 반환합니다. MongoDB 드라이버에서 제공하는 삽입 메서드는 내부적으로 이 명령을 사용합니다.

팁

mongosh 에서 이 명령은 db.collection.insertOne() 및 db.collection.insertMany() 헬퍼 메서드를 통해서도 실행할 수 있습니다.

헬퍼 메서드는 mongosh 사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 못할 수 있습니다. 편의가 필요하지 않거나 추가 리턴 필드가 필요한 경우 데이터베이스 명령을 사용합니다.

명령은 다음과 같은 구문을 가집니다:

{
   insert: <collection>,
   documents: [ <document>, <document>, <document>, ... ],
   ordered: <boolean>,
   maxTimeMS: <integer>,
   writeConcern: { <write concern> },
   bypassDocumentValidation: <boolean>,
   comment: <any>
}

insert 명령은 다음 필드를 사용합니다.

필드	유형	설명
insert	문자열	대상 컬렉션의 이름입니다.
documents	배열	이름이 지정된 컬렉션에 삽입할 하나 이상의 문서 배열입니다.
ordered	부울	선택 사항입니다. true인 경우 문서 삽입이 실패하면 inserts 배열에 나열된 나머지 문서를 삽입하지 않고 반환합니다. false인 경우 문서 삽입에 실패하면 나머지 문서를 계속 삽입합니다. 기본값은 true입니다.
maxTimeMS	음수가 아닌 정수	선택 사항. 시간 제한을 밀리초 단위로 지정합니다. maxTimeMS에 값을 지정하지 않으면 작업이 시간 초과되지 않습니다. 0 값은 바인딩되지 않는 기본 동작을 명시적으로 지정합니다. MongoDB는 db.killOp()와 동일한 메커니즘을 사용하여 할당된 시간 제한을 초과하는 작업을 종료합니다. MongoDB는 지정된 중단 지점 중 하나에서만 작업을 종료합니다.
writeConcern	문서	선택 사항. insert 명령의 쓰기 고려를 표현하는 문서입니다. 기본값 쓰기 고려를 사용하려면 생략합니다. 트랜잭션에서 실행되는 경우 작업에 대한 쓰기 고려를 명시적으로 설정하지 마세요. 트랜잭션에 쓰기 고려를 사용하려면 트랜잭션 및 쓰기 고려를 참조하세요.
bypassDocumentValidation	부울	선택 사항입니다. 작업 중에 insert(이)가 문서 유효성 검사를 우회하도록 설정합니다. 이를 통해 유효성 검사 요구 사항을 충족하지 않는 문서를 삽입할 수 있습니다.
comment	어떤	선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다. mongod 로그 메시지( attr.command.cursor.comment 필드). 데이터베이스 프로파일러 출력의 command.comment 필드에 있습니다. currentOp{command.comment 5} 필드에 출력을 입력합니다. 댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다.

행동

예제

db.runCommand(
   {
      insert: "users",
      documents: [ { _id: 1, user: "abc123", status: "A" } ]
   }
)

{ "ok" : 1, "n" : 1 }

db.runCommand(
   {
      insert: "users",
      documents: [
         { _id: 2, user: "ijk123", status: "A" },
         { _id: 3, user: "xyz123", status: "P" },
         { _id: 4, user: "mop123", status: "P" }
      ],
      ordered: false,
      writeConcern: { w: "majority", wtimeout: 5000 }
   }
)

{ "ok" : 1, "n" : 3 }

db.createCollection("users", {
   validator:
      {
         status: {
            $in: [ "Unknown", "Incomplete" ]
         }
      }
})

db.runCommand({
      insert: "users",
      documents: [ {user: "123", status: "Active" } ]
})

{
   n: 0,
   writeErrors: [
      {
         index: 0,
         code: 121,
         errInfo: {
            failingDocumentId: ObjectId('6197a7f2d84e85d1cc90d270'),
            details: {
               operatorName: '$in',
               specifiedAs: { status: { '$in': [Array] } },
               reason: 'no matching value found in array',
               consideredValue: 'Active'
            }
         },
         errmsg: 'Document failed validation'
      }
   ],
   ok: 1
}

db.runCommand({
   insert: "users",
   documents: [ {user: "123", status: "Active" } ],
   bypassDocumentValidation: true
})

출력

반환된 문서에는 다음 필드의 하위 집합이 포함되어 있습니다.

insert.ok

명령의 상태입니다.

insert.n

삽입된 문서 수입니다.

insert.writeErrors

삽입 작업 중에 발생한 오류에 관한 정보가 포함된 문서 배열입니다. writeErrors 배열에는 오류가 발생한 각 삽입에 대한 오류 문서가 포함되어 있습니다.

각 오류 문서에는 다음과 같은 필드가 포함되어 있습니다.

insert.writeErrors.index

0부터 시작하는 인덱스를 사용하는 documents 배열에서 문서를 식별하는 정수입니다.

insert.writeErrors.code

오류를 식별하는 정수 값입니다.

insert.writeErrors.errmsg

오류에 대한 설명입니다.

insert.writeConcernError

쓰기 고려와 관련된 오류를 설명하고 다음 필드를 포함하는 문서:

insert.writeConcernError.code

쓰기 문제 오류의 원인을 식별하는 정수 값입니다.

insert.writeConcernError.errmsg

쓰기 관련 오류의 원인에 대한 설명입니다.

insert.writeConcernError.errInfo.writeConcern

해당 작업에 사용되는 쓰기 관련 개체입니다. 쓰기 문제 개체 필드에 대한 자세한 내용은 쓰기 문제 사양을 참조하세요.

쓰기 고려 개체에는 쓰기 문제의 원본을 나타내는 다음 필드도 포함될 수 있습니다.

insert.writeConcernError.errInfo.writeConcern.provenance

쓰기 문제가 발생한 위치를 나타내는 문자열 값입니다(쓰기 문제 provenance 라고도 함). 다음 표에는 이 필드에 사용할 수 있는 값과 그 의미가 나와 있습니다.

출처	설명
clientSupplied	쓰기 우려 사항은 애플리케이션에서 지정되었습니다.
customDefault	쓰기 고려는 사용자 정의된 기본값에서 비롯된 것입니다. setDefaultRWConcern을 참조하십시오.
getLastErrorDefaults	쓰기 고려는 복제본 세트의 settings.getLastErrorDefaults 필드에서 발생했습니다.
implicitDefault	쓰기 고려는 다른 모든 쓰기 고려 사양이 없는 상태에서 서버에서 발생했습니다.

다음은 단일 문서의 성공적인 insert에 대해 반환된 예시 문서입니다.

{ ok: 1, n: 1 }

다음은 insert 문서 두 개 중 하나는 성공적으로 삽입되었지만 다른 문서에서 오류가 발생한 경우 반환된 문서 예시입니다.

{
   "ok" : 1,
   "n" : 1,
   "writeErrors" : [
      {
         "index" : 1,
         "code" : 11000,
         "errmsg" : "insertDocument :: caused by :: 11000 E11000 duplicate key error index: test.users.$_id_  dup key: { : 1.0 }"
      }
   ]
}