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 Data Explorer ä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:et för NoSQL, API för Apache Gremlin och API for 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 kontrollplan 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 problem med nätverksrelaterade anslutningar.

  • 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 Data Explorer ett fel som kan observeras i meddelandena för Data Explorer. 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 inaktiverat 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 kontrollplanet respektive dataplanslösningarna.

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 det tjänstbaserade 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 problem med nätverksrelaterade anslutningar.

  • 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 mellanprogramtjänsten. Du behöver inte lägga till IP-adressen för den aktuella enheten.

  • Om kontot inte har en brandväggsregel genererar Data Explorer ett fel som kan observeras i utvecklarverktygen i webbläsaren. 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 mellanprogramtjänsten. Det utökade felmeddelandet ingår i Beräkningsgatewayloggarna, 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.