적용 대상: MongoDB vCore
MongoDB 셸(mongosh
)은 MongoDB 배포와 상호 작용하기 위한 JavaScript 및 Node.js 환경입니다. 쿼리를 테스트하고 Azure Cosmos DB for MongoDB 데이터베이스의 데이터와 상호 작용하는 데 널리 사용되는 커뮤니티 도구입니다.
필수 조건
기존 Azure Cosmos DB for MongoDB(vCore 아키텍처) 클러스터입니다.
커뮤니티 사이트에서 설치된 MongoDB Shell 버전입니다.
운영 체제에 필요한 설치 후 환경 변수를 설정합니다.
컴퓨터를 연결할 수 있도록 하는 방화벽 설정입니다. Azure Cosmos DB에 대한 방화벽을 구성하기 위한 지침을 따릅니다.
현재 IP 주소의 요청, 클라우드 서비스의 요청 또는 가상 머신(특정 IP 범위)의 요청을 허용하도록 선택할 수 있습니다.
실수로 모든 포트를 열면 변경 내용을 저장하기 전에 경고가 표시됩니다.
MongoDB 셸을 사용하여 연결
Azure Cosmos DB 클러스터를 MongoDB Shell에 추가하려면 다음 단계를 수행합니다.
다음 지침을 사용하여 Azure Cosmos DB for MongoDB(vCore) 인스턴스에 대한 연결 정보를 검색합니다.
다음 방법 중 하나를 사용하여 연결합니다.
Mongo Shell 프롬프트에 암호를 입력합니다. 연결 문자열 다음 예제와 같습니다.
"mongodb+srv://<username>@<servername>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"
이 명령은 다음 예제와 같습니다.
mongosh "mongodb+srv://testuser@mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000
암호를 제공하고 성공적으로 인증되면 다음 경고가 나타납니다. "이 서버 또는 서비스는 MongoDB의 에뮬레이션으로 나타납니다." 무시해도 됩니다. 이 경고는 연결 문자열 포함되어 있기 때문에 생성됩니다
cosmos.azure
. Azure Cosmos DB는 네이티브 Azure PaaS(Platform as a Service) 제품입니다.암호를 연결 문자열 일부로 제공합니다. 형식은 다음 예제와 같습니다.
mongosh "mongodb+srv://<SERVERNAME>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "<USER>" -password "<PASSWORD>"
이 명령은 다음 예제와 같습니다.
mongosh "mongodb+srv://mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "testuser" -password "******"