Hantera Azure Cosmos DB resurser med hjälp av Azure Storage Explorer

  • Artikel
  • 9 minuter för att läsa

GÄLLER för: SQL API API för Cassandra Gremlin API tabell-API Azure Cosmos DB API för MongoDB

Du kan använda Azure Storage explorer för att ansluta till Azure Cosmos DB. Du kan ansluta till Azure Cosmos DB-konton som finns i Azure och nationella moln från Windows, macOS eller Linux.

Använd samma verktyg för att hantera dina olika Azure-entiteter på ett och samma ställe. Du kan hantera Azure Cosmos DB entiteter, manipulera data, uppdatera lagrade procedurer och utlösare tillsammans med andra Azure-entiteter som lagringsblobar och köer. Azure Storage Explorer cosmos-konton som har konfigurerats för SQL-, MongoDB-, Graph- och tabell-API:er.

Anteckning

Azure Cosmos DB-integreringen med Storage Explorer har blivit inaktuell. Alla befintliga funktioner tas inte bort och det gäller under minst ett år, räknat från den här versionen. Du bör använda skrivbordsappenför Azure Portal, Azure Portal eller den fristående Azure Cosmos DB Explorer stället. Alternativen innehåller många nya funktioner som för närvarande inte stöds i Storage Explorer.

Förutsättningar

Ett Cosmos-konto med ett SQL API eller ett Azure Cosmos DB API för MongoDB. Om du inte har något konto kan du skapa ett i Azure Portal. Se Azure Cosmos DB: Skapa en SQL API-webbapp med .NET och Azure Portal för mer information.

Installation

Information om hur du installerar Azure Storage Explorer senaste bitar finns i Azure Storage Explorer. Vi stöder Windows-, Linux- och macOS-versioner.

Ansluta till en Azure-prenumeration

  1. När du Azure Storage Explorer väljer du plugin-ikonen i den vänstra rutan.

    Skärmbild som visar plugin-ikonen i den vänstra rutan.

  2. Välj Lägg till ett Azure-konto och välj sedan Logga in.

    Skärmbild av Anslut för Azure Storage med alternativknappen Lägg till ett Azure-konto markerad och den nedrullningsna menyn Azure Environment.

  3. I dialogrutan Azure Sign-in (Azure-inloggning) väljer du Sign in (Logga in) och anger sedan dina autentiseringsuppgifter för Azure.

    Skärmbild av fönstret Logga in som visar var du anger dina autentiseringsuppgifter för din Azure-prenumeration.

  4. Välj din prenumeration i listan och välj sedan Använd.

    Skärmbild av fönstret Kontohantering med en lista över prenumerationer och knappen Tillämpa.

    Explorer-fönstret uppdateras och visar kontona i den valda prenumerationen.

    Skärmbild av Explorer-fönstret, uppdaterat för att visa kontona i den valda prenumerationen.

    Ditt Cosmos DB är anslutet till din Azure-prenumeration.

Använda en anslutningssträng för att ansluta till Azure Cosmos DB

Du kan använda en anslutningssträng för att ansluta till en Azure Cosmos DB. Den här metoden stöder endast SQL- och tabell-API:er. Följ dessa steg för att ansluta med en anslutningssträng:

  1. Leta upp Lokala och anslutna i det vänstra trädet, högerklicka Cosmos DB Konton och välj sedan Anslut för att Cosmos DB.

    Skärmbild som visar den nedrullningsna menyn efter att du högerklickat, Anslut till Azure Cosmos D B markerat.

  2. I fönstret Anslut Cosmos DB du:

    1. Välj API:et från den nedrullningsna menyn.

    2. Klistra in anslutningssträngen i rutan Anslutningssträng. Information om hur du hämtar den primära anslutningssträngen finns i Hämta anslutningssträngen.

    3. Ange en Kontoetikett och välj sedan Nästa för att kontrollera sammanfattningen.

    4. Välj Anslut för att ansluta Azure Cosmos DB-kontot.

      Skärmbild av Anslut till Cosmos D B som visar den nedrullningsna API-menyn, rutan Anslutningssträng och rutan Kontoetikett.

Anteckning

Om Azure Storage Explorer visar att anslutningssträngen Azure Cosmos DB är i ett ogiltigt format kontrollerar du att anslutningssträngen har ett semikolon ( ; ) i slutet. Ett exempel på en giltig Azure Cosmos DB anslutningssträng är: AccountEndpoint=https://accountname.documents.azure.com:443;AccountKey=accountkey==;

Använda en lokal emulator för att ansluta till Azure Cosmos DB

Använd följande steg för att ansluta till en Azure Cosmos DB med en emulator. Den här metoden stöder endast SQL konton.

  1. Installera Cosmos DB Emulator och öppna den. Information om hur du installerar emulatorn finns i Cosmos DB Emulator.

  2. Leta upp Lokala och anslutna i det vänstra trädet, högerklicka Cosmos DB Konton och välj sedan Anslut för att Cosmos DB Emulator.

    Skärmbild som visar menyn som visas när du högerklickar, med Anslut till Azure Cosmos D B Emulator markerat.

  3. I fönstret Anslut Cosmos DB du:

    1. Klistra in anslutningssträngen i rutan Anslutningssträng. Information om hur du hämtar den primära anslutningssträngen finns i Hämta anslutningssträngen.

    2. Ange en Kontoetikett och välj sedan Nästa för att kontrollera sammanfattningen.

    3. Välj Anslut för att ansluta Azure Cosmos DB-kontot.

      Skärmbild av Anslut till Cosmos D B som visar rutan Anslutningssträng och rutan Kontoetikett.

Resurshantering för Azure Cosmos DB

Använd följande åtgärder för att hantera ett Azure Cosmos DB konto:

  • Öppna kontot i Azure Portal.
  • Lägg till resursen i listan Snabbåtkomst.
  • Sök efter och uppdatera resurser.
  • Skapa och ta bort databaser.
  • Skapa och ta bort samlingar.
  • Skapa, redigera, ta bort och filtrera dokument.
  • Hantera lagrade procedurer, utlösare och användardefinierade funktioner.

Uppgifter för snabbåtkomst

Du kan högerklicka på en prenumeration i Explorer-fönstret för att utföra många snabbåtgärder, till exempel:

  • Högerklicka på ett Azure Cosmos DB konto eller databas och välj sedan Öppna i portalen för att hantera resursen i webbläsaren på Azure Portal.

    Skärmbild som visar menyn som visas när du högerklickar, med Öppna i portalen markerat.

  • Högerklicka på ett Azure Cosmos DB, databas eller samling och välj sedan Lägg till i snabbåtkomst för att lägga till det på snabbåtkomstmenyn.

  • Välj Sök här om du vill aktivera nyckelordssökning under den valda sökvägen.

    Skärmbild som visar den markerade sökrutan.

Databas- och samlingshantering

Skapa en databas

  1. Högerklicka på Azure Cosmos DB och välj sedan Skapa databas.

    Skärmbild som visar menyn som visas när du högerklickar, med Skapa databas markerat.

  2. Ange databasnamnet och tryck sedan på Retur för att slutföra.

Ta bort en databas

  1. Högerklicka på databasen och välj sedan Ta bort databas.

    Skärmbild som visar menyn som visas när du högerklickar, med Ta bort databas markerat.

  2. Välj Ja i popup-fönstret. Databasnoden tas bort och Azure Cosmos DB-konto uppdateras automatiskt.

    Skärmbild av bekräftelsefönstret med knappen Ja markerad.

Skapa en samling

  1. Högerklicka på databasen och välj sedan Skapa samling.

    Skärmbild som visar menyn som visas när du högerklickar, med Skapa samling markerat.

  2. I fönstret Skapa samling anger du den begärda informationen, till exempel Samlings-ID och Storage kapacitet och så vidare. Slutför genom att välja OK.

    Skärmbild av fönstret Skapa samling med rutan Samling I D och Storage för kapacitet.

  3. Välj Obegränsat så att du kan ange en partitionsnyckel och välj sedan OK för att slutföra.

    Anteckning

    Om en partitionsnyckel används när du skapar en samling kan du inte ändra partitionsnyckelvärdet för samlingen när den har skapats.

    Skärmbild av fönstret Skapa samling med Obegränsat valt för Storage kapacitet och rutan Partitionsnyckel markerad.

Ta bort en samling

  • Högerklicka på samlingen, välj Ta bort samling och välj sedan Ja i popup-fönstret.

    Samlingsnoden tas bort och databasen uppdateras automatiskt.

    Skärmbild som visar menyn som visas när du högerklickar, med Ta bort samling markerat.

Dokumenthantering

Skapa och ändra dokument

  • Öppna Dokument i den vänstra rutan, välj Nytt dokument, redigera innehållet i den högra rutan och välj sedan Spara.

  • Du kan också uppdatera ett befintligt dokument och sedan välja Spara. Om du vill ta bort ändringar väljer du Ignorera.

    Skärmbild som visar Dokument markerat i det vänstra fönstret. I den högra rutan markeras Nytt dokument, Spara och Ignorera.

Ta bort ett dokument

  • Välj knappen Ta bort för att ta bort det valda dokumentet.

Fråga för dokument

  • Om du vill redigera dokumentfiltret anger du SQL frågaoch väljer sedan Tillämpa.

    Skärmbild av den högra rutan med knapparna Filter och Tillämpa, ID-numret och frågerutan markerad.

Graph-hantering

Skapa och ändra ett hörn

  • Om du vill skapa ett nytt hörn öppnar Graph i den vänstra rutan, väljer Nytt hörn, redigerar innehållet och väljer sedan OK.

  • Om du vill ändra ett befintligt hörn väljer du pennikonen i den högra rutan.

    Skärmbild som Graph markerats i det vänstra fönstret och som visar Nytt hörn och pennikonen markerade i den högra rutan.

Ta bort en graf

  • Om du vill ta bort ett hörn väljer du papperskorgsikonen bredvid hörnets namn.

Filter för graf

  • Om du vill redigera graffiltret anger du en gremlin-frågaoch väljer sedan Använd filter.

    Skärmbild som Graph markerat i det vänstra fönstret och visar Tillämpa filter och frågerutan markerad i den högra rutan.

Tabellhantering

Skapa och ändra en tabell

  • Så här skapar du en ny tabell:

    1. I den vänstra rutan öppnar du Entiteter och väljer sedan Lägg till.

    2. Redigera innehållet i dialogrutan Lägg till entitet.

    3. Välj knappen Lägg till egenskap för att lägga till en egenskap.

    4. Välj Infoga.

      Skärmbild som visar Entiteter markerade i det vänstra fönstret och visar Lägg till, Redigera, Lägg till egenskap och Infoga markerat i den högra rutan.

  • Om du vill ändra en tabell väljer du Redigera, ändrar innehållet och väljer sedan Uppdatera.

Importera och exportera tabell

  • Om du vill importera väljer du knappen Importera och sedan en befintlig tabell.

  • Om du vill exportera väljer du knappen Exportera och sedan ett mål.

    Skärmbild som visar knapparna Importera och Exportera markerade i den högra rutan.

Ta bort entiteter

  • Välj entiteterna och välj sedan knappen Ta bort.

    Skärmbild som visar knappen Ta bort markerad i det högra fönstret och ett bekräftelsefönster med Ja markerat.

Fråga en tabell

  • Välj knappen Fråga, ange ett frågevillkor och välj sedan knappen Kör fråga. Stäng frågefönstret genom att välja knappen Stäng fråga.

    Skärmbild av den högra rutan med knappen Kör fråga och knappen Stäng fråga markerad.

Hantera lagrade procedurer, utlösare och UDF:er

  • Så här skapar du en lagrad procedur:

    1. Högerklicka på Lagrade procedurer i det vänstra trädet och välj sedan Skapa lagrad procedur.

      Skärmbild av det vänstra fönstret som visar menyn som visas när du högerklickar, med Skapa lagrad procedur markerad.

    2. Ange ett namn till vänster, ange skripten för lagrad procedur i den högra rutan och välj sedan Skapa.

  • Om du vill redigera en befintlig lagrad procedur dubbelklickar du på proceduren, gör uppdateringen och väljer sedan Uppdatera för att spara. Du kan också välja Ignorera för att avbryta ändringen.

  • Åtgärderna för utlösare och UDF liknar lagrade procedurer.

Felsökning

Följande är lösningar på vanliga problem som uppstår när du använder Azure Cosmos DB i Storage Explorer.

Inloggningsproblem

Starta först om programmet för att se om det löser problemet. Om problemet kvarstår fortsätter du att felsöka.

Självsignerat certifikat i certifikatkedjan

Det finns några orsaker till att du ser det här felet. De två vanligaste är:

  • Du är bakom en transparent proxy. Någon, som it-avdelningen, fångar upp HTTPS-trafik, dekrypterar den och krypterar den sedan med hjälp av ett själv signerat certifikat.

  • Du kör programvara, till exempel antivirusprogram. Programvaran matar in ett själv signerat TLS/SSL-certifikat i de HTTPS-meddelanden som du får.

När Storage Explorer hittar ett själv signerat certifikat vet det inte om HTTPS-meddelandet som det tar emot har manipulerats. Om du har en kopia av det själv signerade certifikatet kan du be Storage Explorer lita på det. Om du är osäker på vem som har matat in certifikatet kan du följa dessa steg för att försöka ta reda på det:

  1. Installera OpenSSL:

    • Windows:Alla ljusversioner är OK.
    • macOS och Linux: Ska ingå i ditt operativsystem.

  2. Kör OpenSSL:

    • Windows: Gå till installationskatalogen och sedan /bin/ och dubbelklicka sedan påopenssl.exe.
    • Mac och Linux: Kör openssl från en terminal.

  3. Kör s_client -showcerts -connect microsoft.com:443 .

  4. Leta efter självsignerade certifikat. Om du är osäker på vilka som är själv signerade kan du leta efter var som helst där ämnet ("s:") och utfärdaren ("i:") är desamma.

  5. Om du hittar några själv signerade certifikat kopierar du och klistrar in allt från och -----BEGIN CERTIFICATE----- till -----END CERTIFICATE----- till en ny . CER-fil för var och en.

  6. Öppna Storage Explorer och gå sedan till Redigera > SSL-certifikat > Importera certifikat. Använd filväljaren för att hitta, välja och öppna sedan . CER-filer som du skapade.

Om du inte hittar några själv signerade certifikat kan du skicka feedback om du behöver mer hjälp.

Det gick inte att hämta prenumerationer

Om du inte kan hämta dina prenumerationer när du har loggat in kan du prova följande förslag:

  • Kontrollera att ditt konto har åtkomst till prenumerationerna. Det gör du genom att logga in på Azure Portal.

  • Kontrollera att du har loggat in i rätt miljö:

  • Om du är bakom en proxyserver kontrollerar du att Storage Explorer proxyn är korrekt konfigurerad.

  • Ta bort kontot och lägg sedan till det igen.

  • Ta bort följande filer från arbetskatalogen (till exempel: C:\Users\ContosoUser) och lägg sedan till kontot igen:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Tryck på F12 för att öppna utvecklarkonsolen. Titta på konsolen för eventuella felmeddelanden när du loggar in.

    Skärmbild av konsolen för utvecklarverktyg med Konsolen markerad.

Det gick inte att visa autentiseringssidan

Om du inte kan se autentiseringssidan:

  • Beroende på anslutningens hastighet kan det ta en stund innan inloggningssidan läses in. Vänta minst en minut innan du stänger dialogrutan för autentisering.
  • Om du är bakom en proxyserver kontrollerar du att Storage Explorer proxyn är korrekt konfigurerad.
  • Titta på svaren i konsolen för utvecklarverktyg (F12) för att se om du kan hitta någon ledtråd till varför autentisering inte fungerar.

Det går inte att ta bort ett konto

Om du inte kan ta bort ett konto eller om återauktoratelänken inte gör något:

  • Ta bort följande filer från arbetskatalogen och lägg sedan till kontot igen:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Om du vill ta bort SAS-kopplade lagringsresurser, ta bort:

    • %AppData%/StorageExplorer-mapp för Windows
    • /Users/<your_name>/Library/Application SUpport/StorageExplorer for macOS
    • ~/.config/StorageExplorer för Linux

    Anteckning

    Om du tar bort de här filerna måste du återautentiseringsuppgifterna.

HTTP/HTTPS-proxyproblem

Du kan inte visa Azure Cosmos DB i det vänstra trädet när du konfigurerar en HTTP/HTTPS-proxy i ASE. Du kan Azure Cosmos DB datautforskaren i Azure Portal som en arbetsyta.

Problem med ”Utvecklingsnod” under ”Lokala och kopplade” noder

Det finns inget svar när du har valt noden Utveckling under noden Lokal och Ansluten i det vänstra trädet. Det här beteendet är förväntat.

Skärmbild som visar noden Utveckling vald.

Koppla ett Azure Cosmos DB konto i felet Lokal och ansluten nod

Om du ser följande fel när du har kopplat ett Azure Cosmos DB-konto i den lokala och anslutna noden kontrollerar du att du använder rätt anslutningssträng.

Skärmbild av popup-fönstret Det går inte att hämta underordnade resurser, som visar getaddrinfo ENOTFOUND.

Nodfel vid expandera Microsoft Azure Cosmos DB

Följande fel kan visas när du försöker expandera noder i det vänstra trädet.

Skärmbild av popup-fönstret Det går inte att hämta underordnade resurser, som visar Det går inte att ansluta till det här Cosmos D B-kontot.

Prova följande förslag:

  • Kontrollera om Azure Cosmos DB-kontot har etablerats. Försök igen när kontot har skapats.
  • Om kontot finns under noderna Snabbåtkomst eller Lokal och Ansluten kontrollerar du om kontot har tagits bort. I så fall måste du ta bort noden manuellt.

Nästa steg