다음을 통해 공유


Azure Cosmos DB 데이터 탐색기를 사용하여 데이터 관리

적용 대상: NoSQL MongoDB Cassandra Gremlin 테이블

Azure Cosmos DB 데이터 탐색기는 Azure Cosmos DB에 저장된 데이터를 보고 관리할 수 있는 웹 기반 인터페이스입니다.

전용 Azure Cosmos DB 데이터 탐색기(https://cosmos.azure.com)는 다음을 포함하여 Azure Portal의 데이터 탐색기 환경과 비교할 때 몇 가지 주요 이점이 있습니다.

  • 데이터를 찾아보고, 쿼리를 실행하고, 쿼리 결과를 관찰하는 전체 화면 영역
  • 컨테이너의 데이터에 대한 Azure Portal 또는 Azure 구독 읽기 또는 읽기/쓰기 기능에 액세스하지 않고 사용자를 제공할 수 있는 기능
  • Azure 구독 또는 Azure Portal 액세스 권한이 없는 사용자와 쿼리 결과를 공유하는 기능

필수 조건

Azure 구독을 사용하여 데이터 탐색기에 직접 액세스

데이터 탐색기에 직접 액세스하고 기존 자격 증명을 사용하여 도구를 빠르게 시작할 수 있습니다.

  1. https://cosmos.azure.com으로 이동합니다.

  2. 로그인을 선택합니다. Azure Cosmos DB 계정에 액세스할 수 있는 기존 자격 증명을 사용하여 로그인합니다.

  3. 다음으로 데이터베이스 계정 선택 메뉴에서 Azure 구독 및 대상 계정을 선택합니다.

    데이터 탐색기의 '데이터베이스 계정 선택' 메뉴 스크린샷

Azure 구독을 사용하여 Azure Portal에서 데이터 탐색기에 액세스

Azure Portal에 익숙한 경우 포털 내 데이터 탐색기에서 독립 실행형 데이터 탐색기로 직접 이동할 수 있습니다.

  1. Azure 포털에 로그인합니다.

  2. 기존 Azure Cosmos DB 계정으로 이동합니다.

  3. 리소스 메뉴에서 데이터 탐색기를 선택합니다.

  4. 다음으로 전체 화면 열기 메뉴 옵션을 선택합니다.

    '전체 화면 열기' 옵션이 강조 표시된 데이터 탐색기 페이지의 스크린샷

  5. 전체 화면 열기 대화 상자에서 열기를 선택합니다.

요청 단위 임계값 구성

데이터 탐색기에서 쿼리에서 사용하는 초당 요청 단위(RU/s)에 대한 제한을 구성할 수 있습니다. 이 기능을 사용하여 쿼리의 RU(요청 단위)에서 비용 및 성능을 제어할 수 있습니다. 이 기능은 고비용 쿼리를 자동으로 취소할 수도 있습니다.

  1. 대상 Azure Cosmos DB 계정에 대한 탐색기에서 시작합니다.

  2. 설정 메뉴 옵션을 선택합니다.

    '설정 열기' 옵션이 강조 표시된 데이터 탐색기 페이지의 스크린샷

  3. 설정 대화 상자에서 RU 임계값 및 실제 RU 임계값사용하도록 설정할지 여부를 구성합니다.

    요청 단위 임계값을 구성하는 개별 설정의 스크린샷.

    RU 임계값은 기본값 인 5,000RU 로 자동으로 사용하도록 설정됩니다.

Microsoft Entra 인증과 함께 사용

구성을 통해 사용하도록 설정하여 탐색기 내에서 Microsoft Entra 기반 인증을 사용할 수 있습니다. 역할 기반 액세스 제어에 대한 자세한 내용은 보안 가이드참조하세요.

  1. 대상 Azure Cosmos DB 계정에 대한 탐색기에서 시작합니다.

  2. 설정 메뉴 옵션을 선택합니다.

  3. 설정 대화 상자에서 가능한 세 가지 값 중 하나를 사용할지 여부를 Enable Entra ID (RBAC) 구성합니다.

    설명
    자동(기본값) 계정에 대해 키 기반 인증을 사용하지 않도록 설정한 경우 RBAC(역할 기반 액세스 제어)가 자동으로 사용됩니다. 그렇지 않으면 데이터 탐색기는 데이터 요청에 키 기반 인증을 사용합니다.
    True 역할 기반 액세스 제어는 항상 데이터 요청에 사용됩니다. 계정 또는 ID에 대해 역할 기반 액세스 제어가 올바르게 구성되지 않은 경우 요청이 실패합니다.
    False 키 기반 인증은 항상 데이터 요청에 사용됩니다. 키 기반 인증을 사용하지 않도록 설정하면 요청이 실패합니다.

    Microsoft Entra ID 역할 기반 액세스 제어 설정 및 세 가지 잠재적 값의 스크린샷.

    참고 항목

    이 설정을 키 기반 인증을 사용하는 옵션으로 변경하면 로그인한 ID를 대신하여 기본 키를 검색하는 요청을 트리거할 수 있습니다.

  4. 이제 탐색기의 명령 모음에서 Entra ID RBAC 에 대한 로그인 옵션을 선택합니다.

    Azure Cosmos DB 데이터 탐색기()를 사용하는 경우에는 이 단계가https://cosmos.azure.com 필요하지 않습니다. Azure Cosmos DB 데이터 탐색기는 URL을 사용하여 https://cosmos.azure.com?feature.enableAadDataPlane=true 값을 수동으로 설정하는 Enable Entra ID (RBAC) True 옵션도 지원합니다.

알려진 문제

다음은 현재 알려진 몇 가지 문제입니다.

  • UUID가 포함된 항목 검색은 데이터 탐색기에서 지원되지 않습니다. 이 제한은 컨테이너 로드에 영향을 주지 않으며 이러한 항목을 포함하는 개별 항목 또는 쿼리만 볼 수 있습니다. 이러한 항목을 보고 관리하려면 사용자는 원래 이러한 항목을 만드는 데 사용한 것과 동일한 도구/SDK를 계속 사용해야 합니다.

  • MICROSOFT Entra ID 계정에 대한 역할 기반 액세스 제어 권한이 부족하여 HTTP 401 오류가 발생할 수 있습니다. 이 조건은 특히 계정에 사용자 지정 역할이 있는 경우에 해당할 수 있습니다. 모든 사용자 지정 역할에는 Microsoft.DocumentDB/databaseAccounts/listKeys/* 데이터 탐색기를 사용하려면 작업이 포함되어 있어야 합니다.

다음 단계