문서

필드 이름

필드 이름은 문자열입니다.

문서 의 필드 이름에는 다음과 같은 제한 사항이 있습니다.

• 필드 이름 _id는 프라이머리 키로 사용하기 위해 예약되어 있으며, 이 값은 컬렉션에서 고유해야 하고 변경할 수 없으며 배열 이외의 모든 유형이 될 수 있습니다. _id가 하위 필드를 포함하는 경우, 하위 필드 이름은 ($) 기호로 시작할 수 없습니다.

• 필드 이름에는 null 문자를 포함 할 수 없습니다.

• 서버는 점(.)과 달러 기호($)가 포함된 필드 이름의 저장을 허용합니다.

• MongoDB 5.0은 필드 이름에 ($) 및 (.)를 사용에 대한 지원을 개선했습니다.몇 가지 제한 사항이 있습니다. 자세한 내용은 필드 이름 고려 사항을 참조하십시오.

• 각 필드 이름은 문서 내에서 고유해야 합니다. 문서에 중복 필드가 있는 경우 MongoDB CRUD 작업이 예기치 않게 작동할 수 있으므로 중복 필드가 있는 문서를 저장해서는 안 됩니다.

MongoDB 쿼리 언어는 필드 이름이 중복된 문서를 지원하지 않습니다. 일부 BSON 빌더는 필드 이름이 중복된 BSON 문서 생성을 지원할 수 있지만, 삽입이 성공했거나 성공한 것처럼 보이더라도 이러한 문서를 MongoDB에 삽입하는 것은 지원되지 않습니다. 예를 들어, 필드 이름이 중복된 BSON 문서를 MongoDB 드라이버를 통해 삽입하면 드라이버가 삽입 전에 중복 값을 조용히 삭제하거나 중복 필드가 포함된 유효하지 않은 문서가 삽입되는 결과를 초래할 수 있습니다. 이러한 문서에 대해 쿼리를 수행하면 임의적이고 일관성 없는 결과가 나올 수 있습니다.

필드 값 제한

MongoDB 2.6 - fCV(featureCompatibilityVersion)가 "4.0" 이전으로 설정된 MongoDB 버전

인덱싱된 컬렉션의 경우 인덱싱된 필드의 값은 최대 인덱스 키 길이를 갖습니다. 자세한 내용은 Maximum Index Key Length(최대 인덱스 키 길이)를 참조하세요.

배열

0부터 시작하는 인덱스 위치로 배열의 요소를 지정하거나 액세스하려면 배열 이름을 점(.) 및 0부터 시작하는 인덱스 위치와 연결하고 따옴표로 묶으십시오.

"<array>.<index>"

예를 들어 문서에 다음과 같은 필드가 있다고 가정해 보겠습니다.

{
   ...
   contribs: [ "Turing machine", "Turing test", "Turingery" ],
   ...
}

contribs 배열의 세 번째 요소를 지정하려면 점 표기법 "contribs.2"을 사용합니다.

배열을 쿼리하는 예제는 다음을 참조하세요.

• 배열 쿼리

• 임베디드 문서 배열 쿼리하기

포함된 문서

점 표기법으로 포함된 문서의 필드를 지정하거나 액세스하려면 포함된 문서 이름과 점(.) 및 필드 이름을 연결하고 따옴표로 묶습니다:

"<embedded document>.<field>"

예를 들어 문서에 다음과 같은 필드가 있다고 가정해 보겠습니다.

{
   ...
   name: { first: "Alan", last: "Turing" },
   contact: { phone: { type: "cell", number: "111-222-3333" } },
   ...
}

• name 필드에 last로 명명된 필드를 지정하려면 점 표기법 "name.last"을 사용합니다.

• phone 문서의 contact 필드에 number를 지정하려면 점 표기법 "contact.phone.number"를 사용하세요.

포함된 문서를 쿼리하는 예제는 다음을 참조하세요.

• 내장된 또는 중첩된 문서에 대한 쿼리

• 임베디드 문서 배열 쿼리하기

문서 크기 제한

최대 BSON 문서 크기는 16메가바이트입니다.

최대 문서 크기는 단일 문서가 과도한 양의 RAM을 사용하거나 전송 중에 과도한 대역폭을 사용하지 않도록 하는 데 도움이 됩니다. 최대 크기보다 큰 문서를 저장하기 위해 MongoDB는 GridFS API를 제공합니다. GridFS에 대한 자세한 내용은 mongofiles 및 해당 드라이버 설명서를 참조하세요.

문서 필드 정렬

JavaScript 객체와 달리 BSON 문서의 필드는 정렬되어 있습니다.

_id 필드

MongoDB에서 collection에 저장된 각 문서에는 기본 키 역할을 하는 고유한 _id 필드가 필요합니다. 삽입된 문서에서 _id 필드가 생략된 경우, MongoDB 드라이버는 _id 필드에 대한 객체 ID를 자동으로 생성합니다.

이는 upsert: true를 사용하여 업데이트 작업을 통해 삽입된 문서에도 적용됩니다.

_id 필드에는 다음과 같은 동작 및 제약 조건이 있습니다:

• 기본적으로 MongoDB는 _id 필드 생성 중에 고유 인덱스를 생성합니다.

• _id 필드는 항상 문서에서 첫 번째 필드입니다. 서버가 _id 필드가 없는 문서를 먼저 수신하면 서버는 필드를 앞으로 이동시킵니다.

_id에 하위 필드가 포함된 경우 하위 필드 이름을 시작할 수 없습니다.

($) 기호로 표시합니다.

• _id 필드에는 배열, 정규식 또는 정의되지 않은 이외의 모든 BSON 데이터 유형의 값이 포함될 수 있습니다.

  경고

  복제가 제대로 작동하도록 하려면 BSON 정규 표현식 유형의 값을 _id 필드에 저장하지 않습니다.

다음은 _id의 값을 저장하는 일반적인 옵션입니다.

• 객체 ID를 사용합니다.

• 가능한 경우 자연 고유 식별자를 사용합니다. 이렇게 하면 공간이 절약되고 추가 인덱스가 필요하지 않습니다.

• 자동 증가 숫자를 생성합니다.

• 애플리케이션 코드에서 UUID를 생성합니다. collection 및 _id 인덱스에 UUID 값을 보다 효율적으로 저장하려면 UUID를 BSON BinData 유형의 값으로 저장합니다.

  BinData 유형의 인덱스 키는 다음과 같은 경우 인덱스에 더 효율적으로 저장됩니다.

  • 이진 하위 유형 값은 0~7 또는 128~135 범위 내에 있습니다.

  • 바이트 배열의 길이는 0, 1, 2, 3, 4, 5, 6, 7, 8, 10, 12, 14, 16, 20, 24 또는 32입니다.

• 드라이버의 BSON UUID 기능을 사용하여 UUID를 생성합니다. 드라이버 구현은 UUID 직렬화 및 역직렬화 로직을 다르게 구현할 수 있으며, 이는 다른 드라이버와 완전히 호환되지 않을 수 있습니다. UUID 상호 운용성에 관한 자세한 내용은 드라이버 설명서 를 참조하세요.

쿼리 필터 문서

쿼리 필터 문서는 읽기, 업데이트, 삭제 작업을 위해 어떤 기록을 선택할지 결정하는 조건을 지정합니다.

<field>:<value> 표현식을 사용하여 같음 조건과 쿼리 연산자 표현식을 지정할 수 있습니다.

{
  <field1>: <value1>,
  <field2>: { <operator>: <value> },
  ...
}

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

• 문서 쿼리

• 내장된 또는 중첩된 문서에 대한 쿼리

• 배열 쿼리

• 임베디드 문서 배열 쿼리하기

업데이트 사양 문서

업데이트 사양 문서는 업데이트 연산자를 사용하여 업데이트 작업 중에 특정 필드에 대해 수행할 데이터 수정을 지정합니다.

{
  <operator1>: { <field1>: <value1>, ... },
  <operator2>: { <field2>: <value2>, ... },
  ...
}

예를 보려면 업데이트 사양을 참조하세요.

인덱스 사양 문서

인덱스 사양 문서는 인덱스할 필드와 인덱스 유형을 정의합니다.

{ <field1>: <type1>, <field2>: <type2>, ...  }