편집

다음을 통해 공유


Azure Cosmos DB에 MongoDB 애플리케이션 연결

적용 대상: MongoDB

MongoDB 연결 문자열을 사용하여 MongoDB 앱을 Azure Cosmos DB에 연결하는 방법에 대해 알아봅니다. 그런 다음 Azure Cosmos DB 데이터베이스를 MongoDB 앱의 데이터 저장소로 사용할 수 있습니다.

이 자습서에서는 연결 문자열 정보를 검색하는 다음 두 가지 방법을 제공합니다.

필수 조건

두 가지 필수 항목이 있습니다.

빠른 시작을 사용하여 MongoDB 연결 문자열 가져오기

다음 단계를 수행합니다.

  1. 인터넷 브라우저에서 Azure Portal에 로그인합니다.

  2. Azure Cosmos DB 창에서 API를 선택합니다.

  3. 계정 창의 왼쪽 창에서 빠른 시작을 선택합니다.

  4. 플랫폼(.NET, Node.js, MongoDB Shell, Java, Python)을 선택합니다. 드라이버나 도구가 목록에 없더라도 계속해서 더 많은 연결 코드 조각을 문서화하므로 걱정하지 마세요. 보고 싶은 항목에 대한 의견을 보내주세요. 사용자 고유의 연결을 만드는 방법을 알아보려면 계정 연결 문자열 정보 가져오기를 참조하세요.

  5. 코드 조각을 복사하여 MongoDB 앱에 붙여넣습니다.

사용자 지정할 MongoDB 연결 문자열 가져오기

다음 단계를 수행합니다.

  1. 인터넷 브라우저에서 Azure Portal에 로그인합니다.

  2. Azure Cosmos DB 창에서 API를 선택합니다.

  3. 계정 창의 왼쪽 창에서 연결 문자열을 선택합니다.

  4. 연결 문자열 창이 열립니다. 여기에는 미리 구성된 연결 문자열을 비롯해 MongoDB용 드라이버를 사용하여 계정에 연결하는 데 필요한 모든 정보가 있습니다.

    연결 문자열 요구 사항

    Important

    Azure Cosmos DB에는 엄격한 보안 요구 사항과 표준이 있습니다. Azure Cosmos DB 계정에는 TLS를 통한 인증 및 보안 통신이 필요합니다.

    Azure Cosmos DB는 두 가지 특정 요구 사항을 포함한 표준 MongoDB 연결 문자열 URI 형식을 지원합니다. Azure Cosmos DB 계정에는 인증 및 TLS을 통한 보안 통신이 필요합니다. 연결 문자열 형식은 다음과 같습니다.

    mongodb://username:password@host:port/[database]?ssl=true

    이 문자열의 값은 다음과 같습니다.

    • Username(필수): Azure Cosmos DB 계정 이름
    • Password(필수): Azure Cosmos DB 계정 암호
    • Host(필수): Azure Cosmos DB 계정의 FQDN
    • Port(필수): 10255
    • Database(선택): 연결에서 사용하는 데이터베이스. 제공된 데이터베이스가 없는 경우 기본 데이터베이스는 "test"입니다.
    • ssl=true(필수)

    예를 들어 연결 문자열 창에 표시된 계정을 사용하는 것이 좋습니다. 유효한 연결 문자열은 다음과 같습니다.

    mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true

    드라이버 요구 사항

    유선 프로토콜 버전 3.4 이상을 지원하는 모든 드라이버는 Azure Cosmos DB for MongoDB를 지원합니다.

    • 클라이언트 드라이버는 반드시 SNI(서비스 이름 식별) TLS 확장 및/또는 appName 연결 문자열 옵션을 지원해야 합니다.
    • appName 매개 변수가 제공되는 경우, 해당 매개 변수는 반드시 Azure Portal의 연결 문자열 값에 있는 것으로 포함되어야 합니다.