Dela via

Azure Cosmos DB Data Explorer kan inte ansluta

  • Artikel

Ibland kan Azure Cosmos DB Data Explorer inte ansluta till ditt konto eller utföra åtgärder mot resurser eller objekt. Den här artikeln granskar potentiella orsaker och lösningar på det här problemet.

Viktigt!

Azure Cosmos DB Data Explorer är inte tillgängligt för API:et för PostgreSQL eller API:et för virtuell kärna.

Förutsättningar

Ett befintligt Azure Cosmos DB för NoSQL, MongoDB RU, Apache Cassandra, Apache Gremlin eller Tabellkonto

Symptom

Du kan inte ansluta till Datautforskaren även när du har aktiverat alternativet Tillåt åtkomst från Azure-portalen .

Orsak

Även när du har konfigurerat rätt rollbaserad åtkomstkontroll och portalbehörigheter finns det extra krav för nätverksåtkomst som måste konfigureras baserat på ditt valda API.

  • Vissa tjänster, till exempel API för NoSQL, API för Apache Gremlin och API för Table, använder en JavaScript SDK på klientsidan för att utföra åtgärder och kräva en uppsättning lösningar.

  • Andra tjänster, till exempel API:et för MongoDB RU och API för Apache Cassandra, använder protokollspecifikt mellanprogram och kräver en alternativ lösning.

Lösning för API:et för NoSQL, Apache Gremlin eller tabell

Databas-, container-, graf- och tabellåtgärder (kontrollplan) körs via anrop till Azure Resource Manager-kontrollplanet med hjälp av Azure Cosmos DB-resursprovidern. Nätverkskonfigurationen påverkar inte dessa åtgärder.

Objektåtgärder (dataplan) körs med hjälp av JavaScript SDK i webbläsarens kontext. Den enhet som du använder för närvarande måste ha direkt nätverksåtkomst till kontot.

  • För konton som konfigurerats med offentlig åtkomst (alla nätverk) bör dataplansåtgärder inte ha några nätverksrelaterade anslutningsproblem.

  • För konton som konfigurerats med offentlig åtkomst (valda nätverk) måste du skapa en brandväggsregel för att tillåta åtkomst till kontot från den aktuella enheten. Nätverksfunktionen på tjänstens sida i Azure Portal har hyperlänken Lägg till min aktuella IP-adress (...) som automatiskt kan lägga till din IP-adress.

  • Om kontot inte har någon brandväggsregel genererar Datautforskaren ett fel som kan observeras i meddelandena för DataUtforskaren. Det här felmeddelandet innehåller text som liknar följande exempel:

    API Fel
    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.
    Tabell 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.

  • För konton som har konfigurerats med offentlig åtkomst inaktiverad måste enheten vara ansluten till ett virtuellt nätverk med anslutning till kontot för att dataplansåtgärder ska fungera.

Lösning för API:et för MongoDB RU eller Apache Cassandra

Granska lösningarna för kontrollplanet respektive dataplanet.

Databas-, nyckelrymds- och insamlingsåtgärder (kontrollplan) körs via anrop till Azure Resource Manager-kontrollplanet med hjälp av Azure Cosmos DB-resursprovidern. Nätverkskonfigurationen påverkar inte dessa åtgärder.

Objektåtgärder (dataplan) körs med hjälp av en proxytjänst i API:ets mellanprogram. Den här tjänsten underlättar användningen av mongoDB-protokollet (MongoDB, Cassandra) i objektåtgärder och frågor. Proxytjänsten kräver direkt nätverksåtkomst till kontot.

  • För konton som konfigurerats med offentlig åtkomst (alla nätverk) bör dataplansåtgärder inte ha några nätverksrelaterade anslutningsproblem.

  • För konton som konfigurerats med offentlig åtkomst (valda nätverk) måste du välja Tillåt åtkomst från Azure-portalen i nätverksfunktionen på tjänstens sida i Azure Portal. Det här alternativet lägger till ett intervall med IP-adresser som inkluderar mellanprogramstjänsten. Du behöver inte lägga till IP-adressen för den aktuella enheten.

  • Om kontot inte har någon brandväggsregel genererar Datautforskaren ett fel som kan observeras i webbläsarutvecklarverktygen. Det här felmeddelandet innehåller ett allmänt Error querying documents meddelande eller Failed to establish connection with cassandra node meddelande som genereras av mellanprogramstjänsten. Det expanderade felmeddelandet ingår i Compute Gateway-loggarna, ungefär som i följande exempel:

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