Azure Cosmos DB에 MongoDB 애플리케이션 연결Connect a MongoDB application to Azure Cosmos DB

MongoDB 연결 문자열을 사용하여 MongoDB 앱을 Azure Cosmos DB에 연결하는 방법에 대해 알아봅니다.Learn how to connect your MongoDB app to an Azure Cosmos DB by using a MongoDB connection string. 그런 다음 Azure Cosmos 데이터베이스를 MongoDB 앱의 데이터 저장소로 사용할 수 있습니다.You can then use an Azure Cosmos database as the data store for your MongoDB app.

이 자습서에서는 연결 문자열 정보를 검색하는 다음 두 가지 방법을 제공합니다.This tutorial provides two ways to retrieve connection string information:

전제 조건Prerequisites

빠른 시작을 사용하여 MongoDB 연결 문자열 가져오기Get the MongoDB connection string by using the quick start

  1. 인터넷 브라우저에서 Azure Portal에 로그인합니다.In an Internet browser, sign in to the Azure portal.

  2. Azure Cosmos DB 블레이드에서 API를 선택합니다.In the Azure Cosmos DB blade, select the API.

  3. 계정 블레이드의 왼쪽 창에서 빠른 시작을 클릭합니다.In the left pane of the account blade, click Quick start.

  4. 플랫폼( .NET, Node.js, MongoDB Shell, Java, Python)을 선택합니다.Choose your platform (.NET, Node.js, MongoDB Shell, Java, Python). 드라이버나 도구가 목록에 없더라도 계속해서 더 많은 연결 코드 조각을 문서화하므로 걱정하지 마세요.If you don't see your driver or tool listed, don't worry--we continuously document more connection code snippets. 아래에 보고 싶은 항목에 대한 의견을 보내주세요.Please comment below on what you'd like to see. 사용자 고유의 연결을 만드는 방법을 알아보려면 계정 연결 문자열 정보 가져오기를 참조하세요.To learn how to craft your own connection, read Get the account's connection string information.

  5. 코드 조각을 복사하여 MongoDB 앱에 붙여넣습니다.Copy and paste the code snippet into your MongoDB app.

    빠른 시작 블레이드

사용자 지정할 MongoDB 연결 문자열 가져오기Get the MongoDB connection string to customize

  1. 인터넷 브라우저에서 Azure Portal에 로그인합니다.In an Internet browser, sign in to the Azure portal.

  2. Azure Cosmos DB 블레이드에서 API를 선택합니다.In the Azure Cosmos DB blade, select the API.

  3. 계정 블레이드의 왼쪽 창에서 연결 문자열을 클릭합니다.In the left pane of the account blade, click Connection String.

  4. 연결 문자열 블레이드가 열립니다.The Connection String blade opens. 여기에는 미리 구성된 연결 문자열을 비롯해 MongoDB용 드라이버를 사용하여 계정에 연결하는 데 필요한 모든 정보가 있습니다.It has all the information necessary to connect to the account by using a driver for MongoDB, including a preconstructed connection string.

    연결 문자열 블레이드

연결 문자열 요구 사항Connection string requirements

중요

Azure Cosmos DB에는 엄격한 보안 요구 사항과 표준이 있습니다.Azure Cosmos DB has strict security requirements and standards. Azure Cosmos DB 계정에는 SSL을 통한 인증 및 보안 통신이 필요합니다.Azure Cosmos DB accounts require authentication and secure communication via SSL.

Azure Cosmos DB는 두 가지 특정 요구 사항을 포함한 표준 MongoDB 연결 문자열 URI 형식을 지원합니다. Azure Cosmos DB 계정에는 인증 및 SSL을 통한 보안 통신이 필요합니다.Azure Cosmos DB supports the standard MongoDB connection string URI format, with a couple of specific requirements: Azure Cosmos DB accounts require authentication and secure communication via SSL. 따라서 연결 문자열 형식은 다음과 같습니다.So, the connection string format is:

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

이 문자열의 값은 위에 표시된 연결 문자열 블레이드에서 사용할 수 있습니다.The values of this string are available in the Connection String blade shown earlier:

  • Username (필수): Cosmos account name.Username (required): Cosmos account name.
  • 암호 (필수): Cosmos 계정 암호입니다.Password (required): Cosmos account password.
  • Host (필수): Cosmos 계정의 FQDN입니다.Host (required): FQDN of the Cosmos account.
  • Port(필수): 10255Port (required): 10255.
  • Database(선택): 연결에서 사용하는 데이터베이스.Database (optional): The database that the connection uses. 제공된 데이터베이스가 없는 경우 기본 데이터베이스는 "test"입니다.If no database is provided, the default database is "test."
  • ssl=true(필수)ssl=true (required)

예를 들어 연결 문자열 블레이드에 표시된 계정을 사용하는 것이 좋습니다.For example, consider the account shown in the Connection String blade. 유효한 연결 문자열은 다음과 같습니다.A valid connection string is:

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

다음 단계Next steps

  • Azure Cosmos DB의 API for MongoDB와 함께 Studio 3T를 사용하는 방법을 알아봅니다.Learn how to use Studio 3T with Azure Cosmos DB's API for MongoDB.
  • Azure Cosmos DB의 API for MongoDB와 함께 Robo 3T를 사용하는 방법을 알아봅니다.Learn how to use Robo 3T with Azure Cosmos DB's API for MongoDB.
  • Azure Cosmos DB의 MongoDB용 API를 사용하여 MongoDB 샘플을 살펴봅니다.Explore MongoDB samples with Azure Cosmos DB's API for MongoDB.