다음을 통해 공유

Visual Studio Code를 사용하여 Azure Cosmos DB 인스턴스 연결 및 쿼리

  • 아티클

적용 대상: NoSQL MongoDB

Visual Studio Code 는 다양한 확장을 지원하는 Linux, macOS 및 Windows용 다양한 코드 편집기입니다. 이 빠른 시작에서는 Visual Studio Code를 사용하여 Azure Cosmos DB for NoSQL 및 Azure Cosmos DB for MongoDB(vCore) 클러스터에 연결하는 방법을 보여 줍니다. 쿼리, 삽입, 업데이트 및 삭제를 비롯한 핵심 데이터베이스 작업 수행에 대해 설명합니다.

필수 조건

시작하기 전에 다음이 있는지 확인합니다.

  • NoSQL API에 대한 데이터베이스 및 컬렉션으로 구성된 Azure Cosmos DB 계정입니다. 아래 빠른 시작을 사용하여 리소스를 설정합니다.

  • Visual Studio 내의 Azure Cosmos DB에서 데이터를 연결하고 관리하려면 먼저 Azure Databases 확장을 설치 합니다 .

    1. Visual Studio Code를 엽니다.
    2. 확장 보기 > 또는 Windows의 Ctrl + Shift + X, MacOS의 명령 + Shift + X 바로 가기를 사용하여 확장 창에 액세스합니다.
    3. 검색 창에서 Azure Databases 확장을 입력하고 확장을 선택합니다. 그런 다음 설치를 클릭합니다.
    4. 설치 후 메시지가 표시되면 Visual Studio Code를 다시 로드합니다.

NoSQL용 Azure Cosmos DB에 연결

  1. Visual Studio Code에서 Azure 창으로 이동합니다(활동 모음에서 Azure 아이콘 선택).
  2. Entra ID를 통해 Azure 계정에 로그인: 참고: 가장 안전한 인증 방법을 위해 계정 키 대신 Azure Cosmos DB 리소스에 액세스할 때 항상 Microsoft Entra ID RBAC를 사용하는 것이 좋습니다.
  3. 로그인하면 Azure 트리 뷰에서 Azure 구독을 찾아 Azure Cosmos DB로 드릴다운합니다.
  4. 기존 계정을 선택하거나 마우스 오른쪽 단추를 클릭하여 새 리소스를 만듭니다.

데이터 쿼리 및 표시

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

  1. 컬렉션 메뉴에서 컬렉션을 마우스 오른쪽 단추로 클릭하여 미리 보기에서 쿼리 편집기 엽니다.

    VS Code의 쿼리 편집기 스크린샷

  2. 쿼리 편집기에서 제공된 쿼리를 실행하여 테이블 뷰에 데이터를 표시합니다.

    VS Code의 쿼리 편집기 결과 스크린샷

  3. 지원되는 다른 보기에서 데이터를 탐색합니다.

  • JSON 뷰: 원시 데이터 구조를 참조하세요. json 보기의 쿼리 편집기 결과 스크린샷
  • 트리 뷰: 중첩된 데이터를 쉽게 탐색합니다. 트리 뷰의 쿼리 편집기 결과 스크린샷.

쿼리 및 인덱스 메트릭 보기

쿼리 편집기 내에서 쿼리 성능을 최적화하는 데 도움이 되도록 추가 쿼리 및 인덱스 메트릭을 봅니다.

  1. 쿼리 결과 옆에 있는 통계 탭을 선택합니다. VS Code의 쿼리 통계 스크린샷

  2. 메트릭 정의에 대한 자세한 내용은 쿼리 메트릭 설명서를 참조 하세요.

문서 삽입, 편집 및 삭제

  • 실시간 문서 편집: 변경 내용을 실시간으로 반영하여 문서를 즉시 추가, 보기, 편집 및 삭제합니다.
  • JSON에서 가져오기: JSON 파일에서 데이터를 빠르게 로드합니다. VS Code의 문서 편집 스크린샷

쿼리 결과 내보내기

  • 결과 다운로드: CSV 또는 JSON 파일에 쿼리 결과를 다운로드합니다. VS Code의 내보내기 결과 스크린샷

다음 단계

이 자습서에서는 VS Code에서 데이터를 쿼리하고, 쿼리 결과를 내보내고, 쿼리 성능을 조정하기 위한 쿼리 및 인덱스 메트릭을 보고, 지원되는 여러 보기에 데이터를 표시하는 방법을 알아보았습니다. 이제 Azure Databases VS Code 확장을 사용하여 데이터베이스의 실제 데이터를 검토할 수 있습니다.

필수 조건

시작하기 전에 다음이 있는지 확인합니다.

  • Azure Cosmos DB for MongoDB의 데이터베이스로 구성된 Azure Cosmos DB 계정입니다. 다음 빠른 시작 중 하나를 사용하여 데이터베이스를 설정합니다.
  • Azure Cosmos DB에서 데이터를 연결하고 관리하려면 Visual Studio Code용 Azure Databases 확장을 설치해야 합니다.
    1. Visual Studio Code를 엽니다.
    2. 확장 보기 > 또는 Windows의 Ctrl + Shift + X, MacOS의 명령 + Shift + X 바로 가기를 사용하여 확장 창에 액세스합니다.
    3. 검색 창에서 Azure Databases 확장을 입력하고 확장을 선택합니다. 그런 다음 설치를 클릭합니다.
    4. 설치 후 메시지가 표시되면 Visual Studio Code를 다시 로드합니다.
  • 명령줄 상호 작용을 위해 설치된 MongoDB 셸(mongosh)입니다(선택 사항이지만 권장됨).

MongoDB 워크로드에 연결

  1. Azure Databases 확장에서 Azure Resources 섹션을 확장합니다.
  2. MongoDB 워크로드가 있는 구독을 찾습니다. 원하는 구독에서 Azure Cosmos DB for MongoDB(vCore) 분기를 확인할 수 있습니다. 분기를 확장하여 클러스터 및 데이터베이스를 봅니다.
  3. 확장된 목록에서 Azure Cosmos DB for MongoDB(vCore) 클러스터를 선택합니다.
  4. 메시지가 표시되면 클러스터의 관리자 암호를 입력합니다.
  5. 인증되면 클러스터에 대한 액세스 권한을 얻게 됩니다.

참고 항목

암호는 인증에만 사용되며 저장되지 않습니다.

참고 항목

대부분의 회사 환경에서는 VPN 또는 다른 회사 네트워크 설정으로 인해 개발자 컴퓨터 IP 주소가 숨겨집니다. 이러한 경우 허용 목록을 구체화하기 전에 처음에 연결 테스트를 위해 0.0.0.0 - 255.255.255.255 방화벽 규칙을 추가하여 모든 IP 주소에 대한 액세스를 허용하는 것으로 시작하는 것이 좋습니다.

클러스터에 대한 네트워킹 및 방화벽 옵션의 스크린샷.

직관적인 데이터 관리

Visual Studio Code 내에서 데이터베이스를 쉽게 관리합니다.

  • 데이터베이스/컬렉션 만들기 및 삭제: 리소스 패널에서 계정, 데이터베이스 또는 컬렉션을 마우스 오른쪽 단추로 클릭하여 데이터베이스 및 컬렉션을 만들거나 삭제합니다.

  • JSON에서 가져오기: JSON 파일의 데이터를 컬렉션으로 빠르게 가져옵니다.

    • 가져오기 시작
      1. 리소스 보기에서 컬렉션 이름을 마우스 오른쪽 단추로 클릭하고 컬렉션으로 문서 가져오기를 선택합니다.
      2. 또는 컬렉션의 문서 항목을 클릭하여 "컬렉션 보기"를 연 다음 가져오기 단추를 클릭합니다.
    • JSON 파일 선택
      1. 데이터를 포함하는 *.json 파일을 찾습니다.
      2. 가져오기 프로세스를 시작하도록 확인합니다.

  • 데이터 내보내기: 백업 또는 공유를 위해 컬렉션 또는 쿼리 결과를 JSON으로 저장합니다.

    • 내보내기 시작:
      • 옵션 1
        1. 리소스 보기에서 컬렉션 이름을 마우스 오른쪽 단추로 클릭하고 컬렉션에서 문서 내보내기를 선택하여 전체 컬렉션을 내보냅니다.
      • 옵션 2
        1. 컬렉션의 문서 항목을 클릭하여 "컬렉션 보기"를 연 다음 내보내기 단추를 클릭합니다.
        2. 전체 컬렉션 또는 현재 쿼리의 결과를 내보내도록 선택합니다.
    • 대상 파일 지정:
      1. 대상 *.json 파일의 이름과 위치를 입력합니다.
      2. 내보내기를 확인하여 데이터 저장을 시작합니다.

  • 실시간 문서 편집: 실시간 업데이트를 사용하여 문서를 즉시 추가, 보기, 편집 및 삭제합니다.

    • 문서 편집 열기:
      • "컬렉션 보기" 내에서 직접 문서 편집 옵션에 액세스합니다. 이러한 컨트롤은 쉽게 액세스할 수 있도록 데이터 뷰 위에 편리하게 배치됩니다.
    • 사용 가능한 작업:
      • 추가: 컬렉션 내에서 새 문서를 만듭니다.
      • 보기: 선택한 문서의 내용을 봅니다.
      • 편집: 선택한 문서의 내용을 편집합니다.
      • 삭제: 변경 내용이 즉시 반영된 선택한 문서를 제거합니다.

CosmosDB for MongoDB(vCore) 클러스터의 VS 코드 확장 스크린샷

강력한 쿼리 도구

쿼리를 원활하게 실행하고 구체화합니다.

  • 즉시 결과: 쿼리 결과를 원하는 형식(테이블, JSON 또는 트리 뷰)으로 즉시 봅니다.

    • 보기 드롭다운 메뉴를 사용하여 보기를 쉽게 전환합니다.

  • 쿼리 직접 실행: 구문 강조 표시 및 자동 완성과 같은 기능을 사용하여 MongoDB 쿼리를 작성하고 실행합니다.

    • 쿼리를 실행하려면 쿼리 찾기 단추를 클릭 하거나 쿼리 편집기에서 누릅니 Ctrl/Cmd+Enter 다.

참고 항목

현재는 필터 쿼리만 지원되며, 확장된 쿼리 기능은 곧 제공될 예정입니다.

유연한 데이터 뷰

다양한 관점에 대해 여러 보기를 사용하여 데이터를 탐색합니다.

  • JSON 뷰: 원시 JSON 데이터 구조를 참조하세요. JSON 보기에서 CosmosDB for MongoDB(vCore) 클러스터의 VS 코드 확장 스크린샷

  • 트리 뷰: 중첩된 데이터를 쉽게 탐색하고 탐색합니다. 트리 보기에서 CosmosDB for MongoDB(vCore) 클러스터의 VS 코드 확장 스크린샷

  • 테이블 뷰: 데이터를 빠르게 검색하고 중첩된 문서로 드릴다운합니다.

    • 드릴다운하려면: 포함된 개체를 나타내는 아이콘이 {} 있는 항목을 찾습니다. 콘텐츠를 확장하고 보려면 두 번 클릭합니다.
    • 돌아가려면: 테이블 뷰 아래의 탐색 이동 경로를 사용하여 이전 수준으로 돌아갑니다. 테이블 보기에서 CosmosDB for MongoDB(vCore) 클러스터의 VS 코드 확장 스크린샷

Mongo Shell 통합

명령줄 기능을 사용할 수 있습니다.

  • 시작 mongosh: Visual Studio Code에서 직접 고급 MongoDB 명령을 실행합니다.

참고 항목

MongoDB 셸(mongosh)은 확장에 포함되지 않습니다. 별도로 설치하고 수동으로 구성해야 합니다.

클러스터 관리

리소스를 계속 활용하세요.

  • 클러스터 세부 정보 보기: 클러스터의 계층, 서버 버전 및 리소스 사용량을 확인합니다.

  • 태그 관리: Azure Portal과 동기화되는 태그를 사용하여 클러스터를 구성합니다.

다음 단계

MongoDB 워크로드를 Azure Cosmos DB로 마이그레이션