Verwalten von Daten mithilfe von Azure Cosmos DB-Explorer
GILT FÜR: 
NoSQL MongoDB Cassandra Gremlin Tabelle
Azure Cosmos DB-Explorer ist eine eigenständige webbasierte Schnittstelle, die Ihnen ermöglicht, in Azure Cosmos DB gespeicherte Daten anzuzeigen und zu verwalten. Azure Cosmos DB-Explorer entspricht dem vorhandenen Abschnitt Daten-Explorer, der im Azure-Portal für Azure Cosmos DB-Konten verfügbar ist.
Azure Cosmos DB-Explorer bietet im Vergleich zum Daten-Explorer einige wichtige Vorteile:
- Vollbildmodus zum Durchsuchen von Daten, Ausführen von Abfragen und Untersuchen von Abfrageergebnissen
- Benutzern ohne Azure-Abonnement oder Zugriff auf das Azure-Portal kann Lese- oder Lese-/Schreibzugriff auf Daten in Containern bereitgestellt werden
- Abfrageergebnisse können für Benutzer ohne Azure-Abonnement oder Zugriff auf das Azure-Portal freigegeben werden
Voraussetzungen
- Ein vorhandenes Azure Cosmos DB-Konto
- Wenn Sie kein Azure-Abonnement besitzen, testen Sie Azure Cosmos DB kostenlos.
Direkter Zugriff auf den Explorer mit Ihrem Azure-Abonnement
Sie können direkt auf den Explorer zugreifen und Ihre vorhandenen Anmeldeinformationen verwenden, um schnell mit dem Tool zu beginnen.
Navigieren Sie zu https://cosmos.azure.com.
Wählen Sie Anmelden aus. Melden Sie sich mit Ihren vorhandenen Anmeldeinformationen an, die Zugriff auf das Azure Cosmos DB-Konto haben.
Wählen Sie als Nächstes Ihr Azure-Abonnement und Ihr Zielkonto im Menü Select a Database Account (Datenbankkonto auswählen) aus.
Zugriff auf den Explorer im Azure-Portal mit Ihrem Azure-Abonnement
Wenn Sie bereits mit dem Azure-Portal vertraut sind, können Sie direkt vom Daten-Explorer im Portal zum eigenständigen Explorer navigieren.
Melden Sie sich beim Azure-Portal an.
Navigieren Sie zu Ihrem vorhandenen Azure Cosmos DB-Konto.
Wählen Sie im Ressourcenmenü Data Explorer aus.
Wählen Sie als Nächstes die Menüoption Vollbildmodus öffnen aus.
Wählen Sie im Dialogfeld Vollbild öffnen die Option Öffnen aus.
Gewähren des Zugriffs auf den Explorer für andere Benutzer mithilfe einer Verbindungszeichenfolge
Verwenden Sie entweder die Lese-/Schreibschlüssel oder schreibgeschützten Schlüssel, um anderen Benutzern Zugriff auf Ihr Azure Cosmos DB-Konto zu gewähren. Diese Methode funktioniert auch dann, wenn die Benutzer keinen Zugriff auf ein Azure-Abonnement oder das Azure-Portal haben.
Melden Sie sich beim Azure-Portal an.
Navigieren Sie zu Ihrem vorhandenen Azure Cosmos DB-Konto.
Wählen Sie im Ressourcenmenü die Option Schlüssel aus.
Wählen Sie auf der Seite Schlüssel entweder die Option Lese-/Schreibschlüssel oder die Option Schreibgeschützte Schlüssel aus. Kopieren Sie dann den Wert im Feld Primäre Verbindungszeichenfolge. Sie verwenden diesen Wert in einem späteren Schritt.
Beschreibung Lese-/Schreibschlüssel Bietet Zugriff zum Anzeigen und Ändern der Datenbanken, Container, Abfragen und anderen Ressourcen, die diesem bestimmten Konto zugeordnet sind. Schreibgeschützter Schlüssel Bietet Zugriff zum Anzeigen der Datenbanken, Container, Abfragen und anderen Ressourcen, die diesem bestimmten Konto zugeordnet sind. Tipp
Wenn Sie die Ergebnisse einer Abfrage für Ihre Teamkollegen freigeben möchten, die keinen Zugriff auf das Azure-Portal oder Ihr Azure Cosmos DB-Konto haben, können Sie ihnen den schreibgeschützten Schlüssel bereitstellen.
Lassen Sie nun den anderen Benutzer zu https://cosmos.azure.com navigieren.
Bitten Sie dann den Benutzer, die Option Connect to your account with connection string (Mit einer Verbindungszeichenfolge mit Ihrem Konto verbinden) auszuwählen. Anschließend sollte der Benutzer die zuvor kopierte Verbindungszeichenfolge eingeben und auf Connect (Verbinden) klicken.
Konfigurieren des Anforderungseinheitsschwellenwerts
Im Explorer können Sie einen Grenzwert für die Anforderungseinheiten pro Sekunde (RU/s) konfigurieren, die von Abfragen verwendet werden. Verwenden Sie diese Funktion, um die Kosten und Leistung in Anforderungseinheiten (RU) Ihrer Abfragen zu steuern. Diese Funktion kann auch automatisch kostenintensive Abfragen abbrechen.
Starten Sie im Explorer für das Azure Cosmos DB-Zielkonto.
Wählen Sie die Menüoption Settings (Einstellungen) aus.
Legen Sie im Dialogfeld Settings (Einstellungen) fest, ob Sie mit der Option Enable RU threshold den RU-Schwellenwert aktivieren und den tatsächlichen RU-Schwellenwert im Feld RU Threshold angeben möchten.
Tipp
Der RU-Schwellenwert wird automatisch mit einem Standardwert von 5.000 RUs aktiviert.
Bekannte Probleme
Hier sind einige derzeit bekannte Probleme:
Das Durchsuchen von Elementen, die eine UUID enthalten, wird im Daten-Explorer nicht unterstützt. Diese Einschränkung wirkt sich nicht auf das Laden von Containern aus, sondern nur auf die Anzeige einzelner Elemente oder Abfragen, die diese Elemente enthalten. Um diese Elemente anzuzeigen und zu verwalten, sollten Benutzer weiterhin das Tool/SDK verwenden, das ursprünglich zum Erstellen dieser Elemente verwendet wurde.
HTTP 401-Fehler können aufgrund unzureichender rollenbasierter Zugriffssteuerungsberechtigungen für Ihr Microsoft Entra ID-Konto auftreten. Dies kann insbesondere dann zutreffen, wenn das Konto über eine benutzerdefinierte Rolle verfügt. Alle benutzerdefinierten Rollen müssen die Aktion
Microsoft.DocumentDB/databaseAccounts/listKeys/*enthalten, um den Explorer zu verwenden.