Delen via

Azure Cosmos DB Data Explorer gebruiken om uw gegevens te beheren

  • Artikel

VAN TOEPASSING OP: NoSQL MongoDB Cassandra Gremlin Tafel

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

Vereisten

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.

    Schermopname van het menu Een databaseaccount selecteren in Data Explorer.

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 .

    Schermopname van de Data Explorer-pagina met de optie Volledig scherm openen gemarkeerd.

  5. Selecteer Openen in het dialoogvenster Volledig scherm openen.

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 .

    Schermopname van een Data Explorer-pagina met de optie Instellingen openen gemarkeerd.

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

    Schermopname van de afzonderlijke instellingen voor het configureren van de drempelwaarde voor de aanvraageenheid.

    Tip

    De RU-drempelwaarde wordt automatisch ingeschakeld met een standaardwaarde van 5000 RU's.

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:

    Beschrijving
    Automatisch (standaard) Op rollen gebaseerd toegangsbeheer (RBAC) wordt automatisch gebruikt als verificatie op basis van sleutels is uitgeschakeld voor uw account. Anders maakt Data Explorer gebruik van verificatie op basis van sleutels voor gegevensaanvragen.
    Waar Op rollen gebaseerd toegangsbeheer wordt altijd gebruikt voor gegevensaanvragen. Als op rollen gebaseerd toegangsbeheer niet juist is geconfigureerd voor het account of de identiteit, mislukken de aanvragen.
    Niet waar Verificatie op basis van sleutels wordt altijd gebruikt voor gegevensaanvragen. Als verificatie op basis van sleutels is uitgeschakeld, mislukken de aanvragen.

    Schermopname van de op rollen gebaseerde toegangsbeheerinstelling van Microsoft Entra ID en drie mogelijke waarden.

    Notitie

    Als u deze instelling wijzigt in een optie die gebruikmaakt van verificatie op basis van sleutels, kan een aanvraag worden geactiveerd om de primaire sleutel op te halen namens de identiteit die is aangemeld.

  4. Selecteer nu de optie Aanmelden voor Entra ID RBAC in de opdrachtbalk van de verkenner.

    Tip

    Deze stap is niet nodig bij het gebruik van Azure Cosmos DB Data Explorer (https://cosmos.azure.com). 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.

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

Aan de slag met query's