MongoDB 호환 DocumentDB 1.0이 정식 출시됐다

DocumentDB 1.0이 정식 출시됐다. MIT 라이선스의 PostgreSQL 기반 문서 데이터베이스로, MongoDB 와이어 프로토콜을 사용하고 네이티브 BSON을 저장한다. 대부분의 MongoDB 드라이버와 도구, 쿼리를 변경 없이 사용할 수 있다고 프로젝트는 설명한다.

이번 버전은 기능을 크게 늘리기보다 기존 동작의 정확성과 부하 상황에서의 안전성을 다듬는 안정화 릴리스다. 권한 검사와 비밀번호 검증을 보완했고, 일부 연산자와 인덱스에서 발생하던 충돌·교착 상태를 수정했다. 오류가 발생할 때 게이트웨이가 구체적인 재시도 가능 오류 코드를 반환하도록 바뀌었다. 전체 변경 사항은 릴리스 변경 기록에서 확인할 수 있다.

Collation은 기본적으로 꺼져 있으며 documentdb_core.enableCollation을 켜면 지원되는 연산자가 늘어난다. 다만 distinct, findAndModify, update는 아직 지원하지 않는다. 관련 제한은 알려진 문제에 정리돼 있다.

DocumentDB 1.0은 Linux·macOS·Windows용 Docker 이미지로 제공되며 PostgreSQL 15~18 태그를 사용할 수 있다. latest 태그는 PostgreSQL 17을 가리킨다. Ubuntu 24.04와 EL9용 Linux 패키지는 PostgreSQL 17 또는 18, amd64 또는 arm64 환경에서 제공된다. Docker 빠른 시작과 설치 안내에서 방법을 확인할 수 있다. Visual Studio Code 확장과 Kubernetes Operator도 1.0 버전으로 제공된다.

Docker 이미지 documentdb-local은 1.0부터 이미지 버전, 운영체제, CPU 아키텍처 정보를 시작 시 한 번, 이후 매시간 전송한다. 데이터·쿼리·이름·인증 정보는 보내지 않지만, 수신처인 Scarf는 요청의 네트워크 주소를 확인하므로 익명이라고 간주해서는 안 된다. 전송을 끄려면 Docker 실행 때 -e DOCUMENTDB_USAGE_TELEMETRY=false 또는 -e DO_NOT_TRACK=1을 지정한다. Linux 패키지와 확장, 게이트웨이는 사용량 정보를 수집하지 않는다. 자세한 내용은 개인정보 보호 안내를 참고하면 된다.

Linux 패키지는 v0.116 또는 v0.117에서 전체 스택을 함께 업그레이드할 수 있다. 반면 기존 데이터 볼륨에 1.0 컨테이너를 실행해도 데이터베이스 스키마는 갱신되지 않으므로, 새 볼륨에서 시작해 데이터를 다시 적재해야 한다. 릴리스 후보(RC)에서 정식 버전으로 바로 업그레이드하는 경로도 없어 새로 설치해야 한다. 버전별 절차와 제한은 1.0 릴리스 노트와 컨테이너 이미지 업그레이드 안내에서 확인할 수 있다.

프로젝트는 1.0 출시 이후 장기 지원 트랙과 1.1 이후 개발 트랙을 운영하는 방안을 제안했으며, 정책은 아직 논의 중이다.