필드 이름에 달러 사인($)이나 마침표(.)를 사용하지 마십시오. MongoDB는 필드 이름에 이러한 문자를 사용하는 문서를 저장합니다. 하지만 다음과 같은 이유로 이를 권장하지 않습니다.
쿼리 성능. 이러한 필드는 인덱스 할 수 없으므로 쿼리 효율성이 떨어질 수 있습니다. 이러한 필드에서 사용할 수 없는 다른 기능을 학습 보려면 일반 제한 사항을 참조하세요.
필드 이름 유효성 검사 규칙은 모든 유형의 스토리지 작업에 대해 동일하지 않습니다.
일반 제한 사항
달러($)로 시작하는 필드 이름이나 마침표(.)가 포함된 필드 이름을 사용할 때에는 몇 가지 일반적인 제한 사항이 있습니다. 이러한 필드는 다음과 같은 경우에 사용할 수 없습니다.
인덱스 생성
샤드 키의 일부로 사용
(으)로 유효성을 검사
$jsonSchema이스케이프 시퀀스를 사용한 수정
필드 레벨 암호화와 함께 사용
_id문서에서 하위 필드로 사용필드 이름에 마침표로 구분된 단어가 255 개 이상 포함된 경우
(
$-접두사만) 필드 이름이 MongoDB가 내부 문서 메타데이터를 위해 예약한 필드 이름과 충돌하는 경우 문서의 루트 수준에서 사용할 수 있습니다.
MongoDB는 내부 문서 메타데이터용 $접두어가 붙은 필드 이름 세트를 예약합니다. 데이터의 루트 수준 필드 이름이 예약된 이름 중 하나와 충돌하는 경우 MongoDB는 필드를 유지하거나 쿼리에 반환하지 않을 수 있으며, 간호히 결과에서 필드를 제거합니다. 이러한 예약된 이름은 내부적이며 릴리즈 간에 변경될 수 있으므로 루트 수준 $접두어가 붙은 필드 이름에 데이터를 저장하거나 다시 읽을 수 있다는 사실에 의지하지 마십시오.
경고
달러 기호($) 및 마침표(.)로 인한 데이터 손실 가능성
달러($) 접두사가 붙은 필드 이름 또는 마침표(.)가 포함된 필드 이름을 사용할 때 MongoDB 5.0 이전 서버에서 이러한 필드 이름이 승인되지 않은 쓰기(쓰기 고려 w=0)와 함께 사용되는 경우 데이터가 손실될 가능성이 적습니다.
insert, update 및 findAndModify 명령을 실행할 때 5.0 호환 드라이버는 필드 이름 앞에 달러($)가 붙거나 마침표(.)가 포함된 문서 사용에 대한 제한을 제거합니다. 이러한 필드 이름은 이전 드라이버 버전에서 클라이언트 사이드 오류를 발생시켰습니다.
드라이버가 연결된 서버 버전에 관계없이 제한이 제거됩니다. 5.0 드라이버가 이전 서버로 문서를 보내는 경우 오류를 보내지 않고 문서가 거부됩니다.
경고
달러 기호($) 및 마침표(.)를 사용한 가져오기 및 내보내기 관련 문제
MongoDB 부터 5.0 문서 필드 이름에 달러()$ 접두사를 붙일 수 있으며 마침표()를 포함할 수. 있습니다. 그러나mongoimport 및 mongoexport 는 이러한 문자를 사용하는 필드 이름이 있는 일부 상황에서 예상대로 작동하지 않을 수 있습니다.
MongoDB 확장 JSON v2는 유형 래퍼와 유형 래퍼와 이름이 같은 필드를 구분할 수 없습니다. 해당 BSON 표현에 달러($) 접두사가 붙은 키가 포함될 수 있는 상황에서는 확장 JSON 형식을 사용하지 않도록 합니다. DBRef 메커니즘에는 해당 일반 규칙이 적용되지 않습니다.
필드 이름에 마침표()가 있는 및 를 사용하는 것도 mongoimport 제한됩니다. CSV 파일은 mongoexport .. 마침표()를 사용하여 데이터 계층 구조를 나타내므로 필드. 이름에 마침표()가 있으면 중첩 수준으로 잘못 해석됩니다.
자세히 알아보기
마침표와 달러 기호가 포함된 필드 이름을 처리하는 방법에 대한 예는 다음 페이지를 참조하세요.