Azure Cosmos DB Data Explorer 연결 실패

Azure Cosmos DB Data Explorer 계정에 연결하거나 리소스 또는 항목에 대한 작업을 수행할 수 없는 경우도 있습니다. 이 문서에서는 이 문제에 대한 잠재적 원인 및 해결 방법을 검토합니다.

중요

Azure Cosmos DB Data Explorer PostgreSQL용 API 또는 vCore용 API에 사용할 수 없습니다.

필수 구성 요소

기존 Azure Cosmos DB for NoSQL, MongoDB RU, Apache Cassandra, Apache Gremlin 또는 Table 계정

증상

Azure Portal에서 액세스 허용 옵션을 사용하도록 설정한 후에도 Data Explorer 연결할 수 없습니다.

원인

올바른 역할 기반 액세스 제어 및 포털 권한을 구성한 후에도 선택한 API에 따라 구성해야 하는 추가 네트워크 액세스 요구 사항이 있습니다.

• NoSQL용 API, Apache Gremlin용 API 및 Table용 API와 같은 일부 서비스는 클라이언트 쪽 JavaScript SDK를 사용하여 작업을 수행하고 하나의 솔루션 집합이 필요합니다.

• MongoDB RU용 API 및 Apache Cassandra용 API와 같은 다른 서비스는 프로토콜별 미들웨어를 사용하며 대체 솔루션이 필요합니다.

NoSQL, Apache Gremlin 또는 Table용 API에 대한 솔루션

데이터베이스, 컨테이너, 그래프 및 테이블(컨트롤 플레인) 작업은 Azure Cosmos DB 리소스 공급자를 사용하여 Azure Resource Manager 컨트롤 플레인에 대한 호출을 통해 실행됩니다. 네트워크 구성은 이러한 작업에 영향을 주지 않습니다.

항목(데이터 평면) 작업은 브라우저의 컨텍스트 내에서 JavaScript SDK를 사용하여 실행됩니다. 현재 사용 중인 디바이스는 계정에 대한 직접 네트워크 액세스 권한이 있어야 합니다.

• 공용 액세스(모든 네트워크)로 구성된 계정의 경우 데이터 평면 작업에 네트워크 관련 연결 문제가 없어야 합니다.

• 공용 액세스(선택한 네트워크)로 구성된 계정의 경우 현재 디바이스에서 계정에 대한 액세스를 허용하는 방화벽 규칙을 만들어야 합니다. Azure Portal 서비스 페이지의 네트워킹 기능에는 IP 주소를 자동으로 추가할 수 있는 내 현재 IP 추가(...) 하이퍼링크가 있습니다.

• 계정에 방화벽 규칙이 없는 경우 Data Explorer Data Explorer 대한 알림에서 관찰할 수 있는 오류를 throw합니다. 이 오류 메시지에는 다음 예제와 유사한 텍스트가 포함되어 있습니다.

  API	오류
  Nosql	Request originated from IP XXX.XXX.XXX.XXX through public internet. This is blocked by your Cosmos DB account firewall settings.
  Apache Gremlin	Failure in submitting query: g.V(): Request originated from IP XXX.XXX.XXX.XXX through public internet. This is blocked by your Cosmos DB account firewall settings.
  표	Error while refreshing databases: Request originated from IP XXX.XXX.XXX.XXX through public internet. This is blocked by your Cosmos DB account firewall settings.

• 공용 액세스를 사용하지 않도록 설정된 계정의 경우 데이터 평면 작업이 작동하려면 디바이스가 계정에 연결된 가상 네트워크에 연결되어야 합니다.

MongoDB RU 또는 Apache Cassandra용 API에 대한 솔루션

컨트롤 플레인 및 데이터 평면 솔루션을 각각 검토합니다.

데이터베이스, 키스페이스 및 컬렉션(컨트롤 플레인) 작업은 Azure Cosmos DB 리소스 공급자를 사용하여 Azure Resource Manager 컨트롤 플레인에 대한 호출을 통해 실행됩니다. 네트워크 구성은 이러한 작업에 영향을 주지 않습니다.

항목(데이터 평면) 작업은 API의 미들웨어에서 프록시 서비스를 사용하여 실행됩니다. 이 서비스는 항목 작업 및 쿼리에서 서비스 네이티브(MongoDB, Cassandra) 프로토콜을 쉽게 사용할 수 있습니다. 프록시 서비스에는 계정에 대한 직접 네트워크 액세스가 필요합니다.

• 공용 액세스(모든 네트워크)로 구성된 계정의 경우 데이터 평면 작업에 네트워크 관련 연결 문제가 없어야 합니다.

• 공용 액세스(선택한 네트워크)로 구성된 계정의 경우 Azure Portal 서비스 페이지의 네트워킹 기능에서 Azure Portal에서 액세스 허용을 선택해야 합니다. 이 옵션은 미들웨어 서비스를 포함하는 IP 주소 범위를 추가합니다. 현재 디바이스의 IP 주소를 추가할 필요가 없습니다 .

• 계정에 방화벽 규칙이 없는 경우 Data Explorer 브라우저 개발자 도구에서 관찰할 수 있는 오류를 throw합니다. 이 오류 메시지에는 미들웨어 서비스에서 생성된 제네릭 Error querying documents 또는 Failed to establish connection with cassandra node 메시지가 포함됩니다. 확장된 오류 메시지는 다음 예제와 유사하게 Compute 게이트웨이 로그에 포함됩니다.

  Request originated from IP XXX.XXX.XXX.XXX through public internet. This is blocked by your Cosmos DB account firewall settings.