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