Azure Cosmos DB Data Explorer gebruiken om uw gegevens te beheren

Azure Cosmos DB Data Explorer is een webinterface waarmee u de gegevens kunt bekijken en beheren die zijn opgeslagen in Azure Cosmos DB.

De toegewezen Azure Cosmos DB Data Explorer (https://cosmos.azure.com) heeft enkele belangrijke voordelen in vergelijking met de Data Explorer-ervaring van Azure Portal, waaronder:

• Onroerend goed in volledig scherm om door gegevens te bladeren, query's uit te voeren en queryresultaten te bekijken
• Mogelijkheid om gebruikers zonder toegang te bieden tot Azure Portal of lees- of lees-schrijfmogelijkheden van een Azure-abonnement via gegevens in containers
• Mogelijkheid om queryresultaten te delen met gebruikers die geen Azure-abonnement of Toegang tot Azure Portal hebben

Prerequisites

• Een bestaand Azure Cosmos DB-account.
  • Als u geen Azure-abonnement hebt, kunt u Azure Cosmos DB gratis proberen.

Rechtstreeks toegang krijgen tot Data Explorer met uw Azure-abonnement

U kunt rechtstreeks toegang krijgen tot Data Explorer en uw bestaande referenties gebruiken om snel aan de slag te gaan met het hulpprogramma.

1. Navigeer naar https://cosmos.azure.com.

2. Selecteer Aanmelden. Meld u aan met uw bestaande referenties die toegang hebben tot het Azure Cosmos DB-account.

3. Selecteer vervolgens uw Azure-abonnement en doelaccount in het menu Een databaseaccount selecteren .

   

Toegang tot Data Explorer vanuit Azure Portal met behulp van uw Azure-abonnement

Als u al vertrouwd bent met Azure Portal, kunt u rechtstreeks vanuit de data explorer in de portal naar de zelfstandige Data Explorer navigeren.

1. Meld u aan bij het Azure Portal.

2. Navigeer naar uw bestaande Azure Cosmos DB-account.

3. Selecteer Data Explorer in het resourcemenu.

4. Selecteer vervolgens de menuoptie Volledig scherm openen .

   

5. Selecteer Openen in het dialoogvenster Volledig scherm openen.

Uw gegevensweergaven aanpassen met de aangepaste kolomkiezer

Met de aangepaste kolomkiezer in Azure Cosmos DB Data Explorer kunt u uw gegevensweergaven aanpassen door specifieke kolommen te selecteren die het meest relevant zijn voor uw analyse wanneer u de NoSQL-API gebruikt. Voorheen kon u in de gegevensverkenner-itemsweergave alleen de kolommen partitiesleutel en id zien. Met deze nieuwe functie kunt u nu een of meer eigenschappen in uw document selecteren en extra kolommen maken om uw gegevens eenvoudig weer te geven. 

1. Meld u aan bij het Azure Portal.

2. Navigeer naar uw bestaande Azure Cosmos DB-account.

3. Selecteer Data Explorer in het resourcemenu.

4. (Optioneel) Selecteer vervolgens de menuoptie Volledig scherm openen .

   

5. Selecteer Openen in het dialoogvenster Volledig scherm openen.

6. Open in Data Explorer de verzameling waarop u een query wilt uitvoeren en selecteer Items.

7. Selecteer in het menu met het beletselteken rechtsboven in een kolom de optie Kolom bewerken

8. Selecteer de kolommen die u wilt weergeven en sla uw instellingen op.

9. Uw gegevensweergave weerspiegelt nu alleen de geselecteerde kolommen, zodat u zich gemakkelijker kunt richten op relevante gegevens.

Een aangepaste kolom verwijderen

1. Open in Data Explorer de verzameling waarop u een query wilt uitvoeren en selecteer Items.

2. Selecteer in het menu met het weglatingsteken rechtsboven in een kolom de optie Kolom verwijderen.

3. De kolomweergave oplopend of aflopend sorteren

4. Open in Data Explorer de verzameling waarop u een query wilt uitvoeren en selecteer Items.

5. Selecteer in het menu met het weglatingsteken rechtsboven in een kolom de optie Kolom verwijderen.

De kolomweergave opnieuw instellen

1. Open in Data Explorer de verzameling waarop u een query wilt uitvoeren en selecteer Items.

2. Selecteer in het menu met het beletselteken rechtsboven in een kolom de optie Kolom bewerken.

3. Selecteer Opnieuw instellen om terug te keren naar de standaardweergave. U kunt ook de instellingen voor filtergeschiedenis, kolommen en Viewport wissen door het tandwielpictogram te selecteren in het algemene menu van Data Explorer in de rechterbovenhoek en Clear History te selecteren.

Filtergeschiedenis gebruiken

Met filtergeschiedenis kunt u snel teruggaan en eerdere filters toepassen. Met deze functie wordt u opgeslagen uit de terugkerende taak voor het handmatig reconstrueren van filters voor terugkerende query's. Met Filtergeschiedenis hebt u toegang tot een logboek van uw eerdere filters en kunt u ze opnieuw toepassen met een eenvoudige selectie. Deze functie is nuttig voor gebruikers die regelmatig analyses uitvoeren op vergelijkbare gegevenssets.

Een opgeslagen filter toepassen

1. Open in Data Explorer de verzameling waarop u een query wilt uitvoeren en selecteer Items.

2. Selecteer Filter bewerken.

3. Pas een filter toe op uw gegevens zoals u dat normaal zou doen.

4. Uw filter wordt automatisch opgeslagen en toegevoegd aan de standaardfilterlijst in het filterdialoogvenster nadat het filter is toegepast.

5. Als u een eerder filter opnieuw wilt toepassen, selecteert u op de knop Filter bewerken.

6. Wis een filter uit het filtervenster. Deze stap is vereist om uw opgeslagen filters weer te geven.

7. Selecteer de vervolgkeuzelijst in het filtervenster en selecteer het gewenste filter in de lijst.

8. Filter toepassen selecteren

Filtergeschiedenis wissen

1. Selecteer in Data Explorer het tandwielpictogram in de rechterbovenhoek van Data Explorer voor toegang tot instellingen

2. Selecteer de knop Geschiedenis wissen

3. Bevestig dat u uw geschiedenis wilt wissen. Dit omvat splitsposities voor filterkolommen, aangepaste kolommen en de tabbladindeling.

De weergave Queryvenster wijzigen

Met een nieuwe functie in de queryweergave kunt u schakelen tussen horizontale en verticale weergaven voor de query en het resultatenvenster. U kunt schakelen tussen deze weergaven door de optie Weergaven te selecteren in het opdrachtbalkmenu.

1. Voorkeuren voor de weergave van het queryvenster opslaan

2. Selecteer in Data Explorer het tandwielpictogram in de rechterbovenhoek van Data Explorer voor toegang tot instellingen.

3. Selecteer Standaardweergave queryresultaten in de vervolgkeuzelijst.

4. Selecteer horizontaal of verticaal als standaardweergave.

5. Selecteer Opslaan om uw instellingen toe te passen.

Drempelwaarde voor aanvraageenheden configureren

In Data Explorer kunt u een limiet configureren voor de aanvraageenheden per seconde (RU/s) die door query's worden gebruikt. Gebruik deze functionaliteit om de kosten en prestaties in aanvraageenheden (RU) van uw query's te beheren. Deze functionaliteit kan query's met hoge kosten ook automatisch annuleren.

1. Begin in de verkenner voor het Azure Cosmos DB-doelaccount.

2. Selecteer de menuoptie Instellingen .

   

3. Configureer in het dialoogvenster Instellingen of u een RU-drempelwaarde en de werkelijke WAARDE van de RU-drempelwaarde wilt inschakelen.

   

   Tip

   De drempelwaarde voor aanvraageenheden (RU) wordt automatisch ingeschakeld met een standaardwaarde van 5000 aanvraageenheden.

Gebruiken met Microsoft Entra-verificatie

U kunt verificatie op basis van Microsoft Entra in de explorer gebruiken door deze in te schakelen via configuratie. Zie de beveiligingshandleiding voor meer informatie over op rollen gebaseerd toegangsbeheer.

1. Begin in de verkenner voor het Azure Cosmos DB-doelaccount.

2. Selecteer de menuoptie Instellingen .

3. Configureer in het dialoogvenster Instellingen of u een van de drie mogelijke waarden wilt Enable Entra ID (RBAC) gebruiken:

4. Data Explorer meldt zich automatisch aan met uw account. Met deze stap wordt mogelijk een kort pop-upvenster geopend zonder u om een referentievermelding te vragen. Als automatisch aanmelden mislukt of als pop-ups worden geblokkeerd in uw browser, moet u de knop Aanmelden voor Entra ID RBAC (op de opdrachtbalk van Data Explorer) gebruiken en pop-ups voor Data Explorer toestaan voordat u gegevensaanvragen indient.

   Tip

   Azure Cosmos DB Data Explorer biedt ook ondersteuning voor de optie om de waarde van de Enable Entra ID (RBAC) URL handmatig in te True stellen op basis van de https://cosmos.azure.com?feature.enableAadDataPlane=true URL.

Data Explorer-clientregio selecteren

Wanneer u toegang krijgt tot een NoSQL-account met Microsoft Entra-verificatie (op rollen gebaseerd toegangsbeheer op basis van besturingsvlak), ziet u de optie Regioselectie in instellingen. Als u een regio selecteert, dwingt Data Explorer alle aanvragen naar die specifieke regio te verzenden.

Een regio selecteren:

1. Meld u aan bij uw account met Microsoft Entra-verificatie via de portal of rechtstreeks via uw Azure-abonnement.

2. Open het menu Instellingen .

3. Gebruik de vervolgkeuzelijst Regio selecteren om Globaal of de vereiste regio te kiezen.

Als u een alleen-lezen regio selecteert, worden schrijf-, update- en verwijderbewerkingen uitgeschakeld in Data Explorer.

Als u Globaal selecteert, gebruikt de client het globale eindpunt van het account en stelt eindpuntdetectie in staat om aanvragen naar de optimale regio te routeren. Als u een specifieke regio selecteert, wordt eindpuntdetectie door de client uitgeschakeld en worden alle aanvragen alleen naar de geselecteerde regio verzonden. 

Bekende problemen

Hier volgen enkele bekende problemen:

• Bladeren door items die een UUID bevatten, wordt niet ondersteund in Data Explorer. Deze beperking heeft geen invloed op het laden van containers, maar alleen voor het weergeven van afzonderlijke items of query's die deze items bevatten. Als u deze items wilt weergeven en beheren, moeten gebruikers dezelfde hulpprogramma's/SDK's blijven gebruiken die oorspronkelijk zijn gebruikt om deze items te maken.

• HTTP 401-fouten kunnen optreden vanwege onvoldoende machtigingen voor op rollen gebaseerd toegangsbeheer voor uw Microsoft Entra ID-account. Deze voorwaarde kan waar zijn, met name als het account een aangepaste rol heeft. Aangepaste rollen moeten de Microsoft.DocumentDB/databaseAccounts/listKeys/* actie bevatten om Data Explorer te kunnen gebruiken.

Volgende stap