Delen via

Azure Cosmos DB Data Explorer kan geen verbinding maken

  • Artikel

Af en toe kan Azure Cosmos DB Data Explorer geen verbinding maken met uw account of bewerkingen uitvoeren op resources of items. In dit artikel worden mogelijke oorzaken en oplossingen voor dit probleem besproken.

Belangrijk

Azure Cosmos DB Data Explorer is niet beschikbaar voor de API voor PostgreSQL of de API voor vCore.

Voorwaarden

Een bestaand Azure Cosmos DB for NoSQL-, MongoDB-RU-, Apache Cassandra-, Apache Gremlin- of Table-account

Symptomen

U kunt geen verbinding maken met Data Explorer, zelfs niet nadat u de optie Toegang vanuit Azure Portal toestaan hebt ingeschakeld.

Oorzaak

Zelfs nadat u het juiste op rollen gebaseerd toegangsbeheer en de portalmachtigingen hebt geconfigureerd, zijn er extra netwerktoegangsvereisten die moeten worden geconfigureerd op basis van uw geselecteerde API.

  • Sommige services, zoals de API voor NoSQL, API voor Apache Gremlin en API voor Table, gebruiken een JavaScript-SDK aan de clientzijde om bewerkingen uit te voeren en één set oplossingen te vereisen.

  • Andere services, zoals de API voor MongoDB RU en API voor Apache Cassandra, gebruiken protocolspecifieke middleware en vereisen een alternatieve oplossing.

Oplossing voor de API voor NoSQL, Apache Gremlin of Table

Database-, container-, grafiek- en tabelbewerkingen (besturingsvlak) worden uitgevoerd via aanroepen naar het Azure Resource Manager-besturingsvlak met behulp van de Azure Cosmos DB-resourceprovider. Uw netwerkconfiguratie heeft geen invloed op deze bewerkingen.

Itembewerkingen (gegevensvlak) worden uitgevoerd met behulp van de JavaScript SDK binnen de context van uw browser. Het apparaat dat u momenteel gebruikt, moet directe netwerktoegang tot het account hebben.

  • Voor accounts die zijn geconfigureerd met openbare toegang (alle netwerken), mogen gegevensvlakbewerkingen geen netwerkgerelateerde verbindingsproblemen hebben.

  • Voor accounts die zijn geconfigureerd met openbare toegang (geselecteerde netwerken), moet u een firewallregel maken om toegang tot het account vanaf uw huidige apparaat toe te staan. De netwerkfunctie op de pagina van de service in Azure Portal heeft een hyperlink Mijn huidige IP (...) toevoegen waarmee uw IP-adres automatisch kan worden toegevoegd.

  • Als het account geen firewallregel heeft, genereert Data Explorer een fout die kan worden waargenomen in de meldingen voor Data Explorer. Dit foutbericht bevat tekst die vergelijkbaar is met de volgende voorbeelden:

    API Error
    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.
    Tabel 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.

  • Voor accounts die zijn geconfigureerd met openbare toegang uitgeschakeld, moet uw apparaat zijn verbonden met een virtueel netwerk met connectiviteit met het account voor de werking van de gegevensvlakbewerkingen.

Oplossing voor de API voor MongoDB RU of Apache Cassandra

Controleer respectievelijk de besturingsvlak- en gegevensvlakoplossingen.

Database-, keyspace- en verzamelingsbewerkingen (besturingsvlak) worden uitgevoerd via aanroepen naar het Azure Resource Manager-besturingsvlak met behulp van de Azure Cosmos DB-resourceprovider. Uw netwerkconfiguratie heeft geen invloed op deze bewerkingen.

Itembewerkingen (gegevensvlak) worden uitgevoerd met behulp van een proxyservice in de middleware van de API. Deze service vereenvoudigt het gebruik van het serviceeigen protocol (MongoDB, Cassandra) in itembewerkingen en query's. De proxyservice vereist directe netwerktoegang tot het account.

  • Voor accounts die zijn geconfigureerd met openbare toegang (alle netwerken), mogen gegevensvlakbewerkingen geen netwerkgerelateerde verbindingsproblemen hebben.

  • Voor accounts die zijn geconfigureerd met openbare toegang (geselecteerde netwerken), moet u Toegang toestaan in Azure Portal selecteren in de netwerkfunctie van de pagina van de service in Azure Portal. Met deze optie wordt een reeks IP-adressen toegevoegd die de middlewareservice bevatten. U hoeft het IP-adres van uw huidige apparaat niet toe te voegen.

  • Als het account geen firewallregel heeft, genereert Data Explorer een fout die kan worden waargenomen in de ontwikkelhulpprogramma's van de browser. Dit foutbericht bevat een algemeen Error querying documents bericht of Failed to establish connection with cassandra node bericht dat is gegenereerd door de middlewareservice. Het uitgebreide foutbericht wordt opgenomen in de logboeken van de compute-gateway, vergelijkbaar met het volgende voorbeeld:

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