빠른 시작: Azure Data Studio를 사용하여 MongoDB용 Azure Cosmos DB API 연결 및 쿼리(미리 보기)

중요

Azure Data Studio는 2026년 2월 28일에 사용 중지됩니다. Visual Studio Code용 MSSQL 확장을 사용하는 것이 좋습니다. Visual Studio Code로 마이그레이션하는 방법에 대한 자세한 내용은 Azure Data Studio에 무슨 일이 일어나고 있는지 확인하세요.

이 빠른 시작에서는 Azure Data Studio를 사용하여 MongoDB용 Azure Cosmos DB API에 연결하는 방법을 보여줍니다.

참고

Microsoft Entra ID는 Azure AD(Azure Active Directory)의 새 이름이지만, 기존 환경의 중단을 방지하기 위해 UI 필드, 연결 공급자, 오류 코드 및 cmdlet과 같은 일부 하드 코딩된 요소에는 여전히 Azure AD가 남아 있습니다. 이 문서에서는 두 이름을 혼용할 수 있습니다.

필수 조건

이 빠른 시작을 완료하려면 Azure Data Studio와 Azure Cosmos DB API 계정이 필요합니다.

• Azure Data Studio를 설치합니다.
• Azure Data Studio에 대한 MongoDB 확장용 Azure Cosmos DB API를 설치합니다.
• Azure Cosmos DB API for MongoDB 계정을 생성하십시오.

Azure Cosmos DB for MongoDB 계정에 연결

API for MongoDB(RU 기반)

1. Azure Data Studio를 시작합니다.

2. Azure Data Studio를 처음으로 시작하면 연결 대화 상자가 열립니다. 연결 대화 상자가 열리지 않으면 서버 페이지에서 새 연결 아이콘을 선택합니다.

   

3. 표시되는 대화 상자에서 찾아보기를 선택한 다음, + 아이콘을 선택하여 Azure에 로그인합니다.

   

4. Azure에 로그인한 후에는 이 테이블의 세부 정보를 사용하여 필드에서 연결 세부 정보에 액세스하거나 입력하려는 Azure Cosmos DB 계정을 선택합니다.

   설정	값	설명
   연결 형식	Mongo 계정	이 값을 Mongo 계정으로 설정하여 MongoDB용 Azure Cosmos DB API와 함께 사용합니다.
   Mongo 계정	[cosmos-account-name]	Azure Cosmos DB 계정의 이름입니다.
   인증 유형	Azure Active Directory - MFA가 지원되는 유니버설	Microsoft Entra ID 또는 기본 인증 옵션 중에서 선택합니다.
   계정	[current-aad-user-name]	Microsoft Entra 인증을 사용하는 경우에만 표시됩니다. 인증에 사용할 Microsoft Entra 계정을 선택합니다.
   Microsoft Entra 테넌트		Microsoft Entra 인증을 사용하는 경우에만 표시됩니다. MongoDB 인스턴스가 있는 Microsoft Entra 테넌트 선택
   사용자 이름		기본 인증을 사용하는 경우에만 표시됩니다. 인증을 위한 사용자 이름을 입력합니다.
   연결 문자열		기본 인증을 사용하는 경우에만 표시됩니다. 인증을 위해 연결 문자열을 입력합니다.
   서버 그룹	<기본값>
   이름(선택 사항)		서버 사이드바에 사용할 고유한 이름을 입력합니다.

   

5. 연결을 선택합니다.

   중요

   Microsoft Entra 인증을 선택했다면 연결에 사용할 MongoDB 연결 문자열 값을 선택하라는 메시지가 표시될 수 있습니다.

성공적으로 연결되면 서버가 서버 사이드바에서 열립니다.

API for MongoDB(vCore)

1. Azure Portal에서 새 Azure Cosmos DB for MongoDB(vCore) 계정을 엽니다.

2. "설정" > "연결 문자열"로 이동하고 표시된 "연결 문자열"을 복사합니다.

   

3. Azure Data Studio를 시작합니다.

4. Azure Data Studio를 처음으로 시작하면 연결 대화 상자가 열립니다. 연결 대화 상자가 열리지 않으면 서버 페이지에서 새 연결 아이콘을 선택합니다.

   

5. 표시되는 대화 상자에서 Mongo 계정>연결 문자열을 선택합니다. Azure Portal의 연결 문자열 필드에서 복사한 연결 문자열을 붙여넣습니다. 문자열 내의 사용자 및 암호 토큰을 관리 사용자 이름 및 암호(Azure Portal에 있음)로 바꿔야 합니다.

   

6. 연결을 선택합니다.

데이터베이스 및 컬렉션 만들기

다음 단계에서는 SourceDatabase라는 데이터베이스와 People이라는 컬렉션을 만듭니다.

1. 계정에 대한 바로 가기 메뉴를 열고 데이터베이스 만들기를 선택합니다.

   

2. 데이터베이스 및 컬렉션 팝업 대화 상자에서 이 표의 세부 정보를 사용합니다.

   명령어	값
   데이터베이스 이름	SourceDatabase
   컬렉션 이름	사람

3. 작업이 완료되면 새 데이터베이스가 데이터베이스 목록에 표시됩니다.

   팁

   데이터베이스가 목록에 표시되지 않으면 새로 고침을 선택합니다.

4. 서버 사이드바에서 SourceDatabase 및 People 노드를 확장합니다.

   

샘플 컬렉션 만들기

다음 단계에서는 People 컬렉션을 샘플 데이터 세트로 채웁니다.

1. 데이터베이스를 선택하여 계정의 데이터베이스 목록으로 이동합니다.

   

2. 데이터베이스 목록에서 SourceDatabase 항목을 선택합니다.

   

3. 헤더 메뉴에서 샘플 데이터 가져오기를 선택합니다. 확인 대화 상자에서 예를 선택합니다.

   

4. 가져오기 작업이 완료될 때까지 기다립니다.

   팁

   가져오기 작업을 완료하는 데 몇 분 정도 걸릴 수 있습니다.

데이터 쿼리

다음 단계에서는 Mongo Shell을 사용하여 쿼리를 실행하고 쿼리 결과를 확인합니다.

1. 데이터베이스 메뉴에서 Mongo Shell 열기를 선택합니다.

   

2. 셸에서 다음 쿼리를 실행합니다.

   db.Persons.find().pretty()
   

   팁

   Mongo의 pretty() 메서드는 읽기 쉬운 형식으로 쿼리 결과를 표시합니다. 자세한 내용은 cursor.pretty에 대한 공식 MongoDB 설명서를 참조하세요.

3. 셸 내에서 쿼리의 출력을 관찰합니다. 출력에는 다음 내용이 포함되어야 합니다.

   

다음 단계

이 빠른 시작에서는 MongoDB 계정용 API를 만들고, Azure Data Studio에서 데이터베이스 및 컬렉션을 만들고, 샘플 데이터를 쿼리하는 방법을 알아보았습니다. 이제 Azure Data Studio를 사용하여 데이터베이스의 실제 데이터를 검토할 수 있습니다.

• MongoDB용 Azure Cosmos DB API에 사용할 수 있는 확장에 대해 알아봅니다.
• Azure Cosmos DB로 MongoDB 데이터를 가져오고 싶나요? MongoDB를 MongoDB용 Azure Cosmos DB의 API로 마이그레이션을 참조하세요.
• Azure Cosmos DB로 마이그레이션하기 위한 용량 계획을 수행하려고 하시나요? 용량 계획을 위해 기존 데이터베이스 클러스터에 대한 정보를 사용할 수 있습니다.
  • 기존 데이터베이스 클러스터의 vCore 및 서버의 수만 알고 있는 경우 vCore 또는 vCPU를 사용하여 요청 단위 예측을 참조하세요
  • 현재 데이터베이스 워크로드에 대한 일반적인 요청 비율을 알고 있는 경우 Azure Cosmos DB 용량 계획 도구를 사용하여 요청 단위 예측에 대해 읽어보세요.