Använda Azure Cosmos DB Explorer för att hantera dina data

  • Artikel

GÄLLER FÖR: Nosql Mongodb Cassandra Gremlin Tabell

Azure Cosmos DB Explorer är ett fristående webbaserat gränssnitt som gör att du kan visa och hantera data som lagras i Azure Cosmos DB. Azure Cosmos DB Explorer motsvarar det befintliga avsnittet Datautforskaren som är tillgängligt i Azure-portalen för Azure Cosmos DB-konton.

Azure Cosmos DB Explorer har några viktiga fördelar jämfört med Datautforskaren, inklusive:

  • Fastigheter i helskärmsläge för att bläddra bland data, köra frågor och observera frågeresultat
  • Möjlighet att ge användare utan åtkomst till Azure-portalen eller en Azure-prenumeration läs- eller lässkrivningsfunktioner över data i containrar
  • Möjlighet att dela frågeresultat med användare som inte har någon Azure-prenumeration eller Åtkomst till Azure-portalen

Förutsättningar

Få åtkomst till Utforskaren direkt med din Azure-prenumeration

Du kan använda åtkomst till Utforskaren direkt och använda dina befintliga autentiseringsuppgifter för att snabbt komma igång med verktyget.

  1. Navigera till https://cosmos.azure.com.

  2. Välj Logga in. Logga in med dina befintliga autentiseringsuppgifter som har åtkomst till Azure Cosmos DB-kontot.

  3. Välj sedan din Azure-prenumeration och ditt målkonto på menyn Välj ett databaskonto .

    Screenshot of the 'Select a Database Account' menu in the Explorer.

Få åtkomst till Utforskaren från Azure-portalen med din Azure-prenumeration

Om du redan är nöjd med Azure-portalen kan du navigera direkt från datautforskaren i portalen till den fristående utforskaren.

  1. Logga in på Azure-portalen.

  2. Gå till ditt befintliga Azure Cosmos DB-konto.

  3. I resursmenyn väljer du Datautforskaren.

  4. Välj sedan alternativet Öppna helskärmsmeny .

    Screenshot of the Data Explorer page with the 'Open Full Screen' option highlighted.

  5. I dialogrutan Öppna helskärm väljer du Öppna.

Ge någon annan åtkomst till Utforskaren med hjälp av en anslutningssträng

Använd antingen skrivskyddad eller skrivskyddad nyckel för att ge en annan användare åtkomst till ditt Azure Cosmos DB-konto. Den här metoden fungerar även om användaren inte har åtkomst till en Azure-prenumeration eller Azure-portalen.

  1. Logga in på Azure-portalen.

  2. Gå till ditt befintliga Azure Cosmos DB-konto.

  3. I resursmenyn väljer du Nycklar.

  4. På sidan Nycklar väljer du antingen alternativet Skrivskyddade nycklar eller Skrivskyddade nycklar . Kopiera sedan värdet för fältet Primär Anslut jonsträng. Du använder det här värdet i ett senare steg.

    beskrivning
    Läs- och skrivnyckel Ger åtkomst till att visa och ändra databaser, containrar, frågor och andra resurser som är associerade med det specifika kontot
    Skrivskyddad nyckel Ger åtkomst till att visa databaser, containrar, frågor och andra resurser som är associerade med det specifika kontot

    Dricks

    Om du vill dela resultat av en fråga med dina teammedlemmar som inte har åtkomst till en Azure-prenumeration eller Azure-portalen kan du ge dem skrivskyddade .

  5. Nu ska den andra användaren navigera till https://cosmos.azure.com.

  6. Välj Anslut till ditt konto med anslutningssträng. Låt sedan användaren ange anslutningssträng kopierade tidigare och välja Anslut.

Konfigurera tröskelvärde för begärandeenhet

I Utforskaren kan du konfigurera en gräns för de enheter för begäranden per sekund (RU/s) som frågor använder. Använd den här funktionen för att styra kostnaden och prestandan i begärandeenheter (RU) för dina frågor. Den här funktionen kan också avbryta frågor med höga kostnader automatiskt.

  1. Starta i Utforskaren för Azure Cosmos DB-målkontot.

  2. Välj menyalternativet Inställningar.

    Screenshot of an Data Explorer page with the 'Open Settings' option highlighted.

  3. I dialogrutan Inställningar konfigurerar du om du vill aktivera RU-tröskelvärde och det faktiska RU-tröskelvärdet.

    Screenshot of the individual settings to configure the request unit threshold

    Dricks

    RU-tröskelvärdet aktiveras automatiskt med ett standardvärde på 5 000 RU:er.

Kända problem

Här är några kända problem:

  • Det går inte att bläddra bland objekt som innehåller ett UUID i Datautforskaren. Den här begränsningen påverkar inte inläsning av containrar, utan endast visning av enskilda objekt eller frågor som innehåller dessa objekt. Om du vill visa och hantera dessa objekt bör användarna fortsätta att använda samma verktyg/SDK:er som ursprungligen användes för att skapa dessa objekt.

  • HTTP 401-fel kan inträffa på grund av otillräckliga rollbaserade behörigheter för åtkomstkontroll för ditt Microsoft Entra-ID-konto. Det här villkoret kan vara sant, särskilt om kontot har en anpassad roll. Alla anpassade roller måste innehålla åtgärden Microsoft.DocumentDB/databaseAccounts/listKeys/* för att använda Utforskaren.

Gå vidare

Komma igång med frågor