문서

필드 이름

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

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

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

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

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

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

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

MongoDB 쿼리 언어는 필드 이름이 중복된 문서를 지원 하지 않습니다.

• 일부 BSON 빌더 는 필드 이름이 중복된 BSON 문서 생성을 지원 수 있지만, 삽입이 성공하거나 성공한 것처럼 보이더라도 이러한 문서를 MongoDB 에 삽입하는 것은 지원되지 않습니다.

• 예를 예시 , 필드 이름이 중복된 BSON 문서 를 MongoDB 운전자 를 통해 삽입하면 운전자 가 삽입 전에 중복 값을 조용히 삭제하거나 중복 필드가 포함된 유효하지 않은 문서 가 삽입될 수 있습니다. 이러한 문서를 쿼리하면 일관되지 않은 결과가 나타납니다.

• 필드 이름이 중복된 문서의 업데이트는 업데이트 가 성공했거나 성공한 것처럼 보이더라도 지원되지 않습니다.

MongoDB 부터 문서 에 6.1 중복된 필드 이름이 있는지 validate 확인하려면 full 필드 를(으)로 설정하다 한 상태에서 명령을 true 사용합니다. 모든 MongoDB 버전에서 $objectToArray 집계 연산자 를 사용하여 문서 에 중복된 필드 이름이 있는지 확인합니다.

배열

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 에서 표준 컬렉션 에 저장된 각 문서 에는 기본 키 역할을 하는 고유한 _id 필드 가 필요합니다. 삽입된 문서 에서 _id 필드 가 생략된 경우, MongoDB 운전자 는 _id 필드 에 대한 ObjectId를 자동으로 생성합니다.

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

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

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

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

• _id에 하위 필드가 포함된 경우 하위 필드 이름은 ($) 기호로 시작할 수 없습니다.

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

  경고

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

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

• ObjectId를 사용합니다.

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

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

• 애플리케이션 코드에서 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>, ...  }