Uw Azure Cosmos DB beheren met behulp van Azure Storage Explorer

  • Artikel
  • 10 minuten om te lezen

VAN TOEPASSING OP: SQL-API Cassandra-API Gremlin-API Table-API Azure Cosmos DB-API voor MongoDB

U kunt Azure Storage Explorer gebruiken om verbinding te maken met Azure Cosmos DB. Hiermee kunt u verbinding maken met Azure Cosmos DB-accounts die worden gehost in Azure en onafhankelijke clouds Windows, macOS of Linux.

Gebruik hetzelfde hulpprogramma om uw verschillende Azure-entiteiten op één plek te beheren. U kunt uw Azure Cosmos DB beheren, gegevens bewerken, opgeslagen procedures en triggers bijwerken, samen met andere Azure-entiteiten, zoals opslagblobs en wachtrijen. Azure Storage Explorer biedt ondersteuning voor Cosmos-accounts die zijn geconfigureerd voor SQL-, MongoDB-, Graph- en Table-API's.

Notitie

Integratie van Azure Cosmos DB met Storage Explorer is afgeschaft. Bestaande functionaliteit wordt gedurende minimaal één jaar niet uit deze release verwijderd. U moet in plaats daarvan de Azure-portal, de bureaublad-app van Azure Portal of de zelfstandige Azure Cosmos DB Explorer gebruiken. De alternatieve opties bevatten veel nieuwe functies die momenteel niet in Storage Explorer worden ondersteund.

Vereisten

Een Cosmos-account met een SQL API of een Azure Cosmos DB API voor MongoDB. Als u geen account hebt, kunt u er een maken in de Azure Portal. Zie Azure Cosmos DB: Een SQL API-web-app bouwen met .NET en de Azure Portal voor meer informatie.

Installatie

Zie voor het installeren van de nieuwste Azure Storage Explorer bits Azure Storage Explorer. We ondersteunen Windows-, Linux- en macOS-versies.

Verbinding maken met een Azure-abonnement

  1. Nadat u de Azure Storage Explorer, selecteert u het pictogram van de in plug-in in in het linkerdeelvenster.

    Schermopname van het pictogram van de in plug-in in in het linkerdeelvenster.

  2. Selecteer Een Azure-account toevoegen en selecteer vervolgens Aanmelden.

    Schermopname van het Verbinding maken Azure Storage met het keuzerondje Een Azure-account toevoegen geselecteerd en het vervolgkeuzemenu Azure Environment.

  3. Selecteer aanmelden in het dialoogvenster Azure-aanmelding en voer uw Azure-referenties in.

    Schermopname van het venster Aanmelden waarin wordt weergegeven waar u uw referenties voor uw Azure-abonnement kunt invoeren.

  4. Selecteer uw abonnement in de lijst en selecteer vervolgens Toepassen.

    Schermopname van het deelvenster Accountbeheer, met een lijst met abonnementen en de knop Toepassen.

    Het deelvenster Explorer wordt bijgewerkt en de accounts in het geselecteerde abonnement worden weergegeven.

    Schermopname van het deelvenster Explorer, bijgewerkt om de accounts in het geselecteerde abonnement weer te geven.

    Uw Cosmos DB is verbonden met uw Azure-abonnement.

Een connection string gebruiken om verbinding te maken met Azure Cosmos DB

U kunt een connection string verbinding maken met een Azure Cosmos DB. Deze methode ondersteunt alleen SQL en Table-API's. Volg deze stappen om verbinding te maken met een connection string:

  1. Zoek lokaal en gekoppeld in de linkerstructuur, klik met de rechtermuisknop op Cosmos DB Accounts en selecteer vervolgens Verbinding maken om Cosmos DB.

    Schermopname van de vervolgkeuzelijst nadat u met de rechtermuisknop hebt geklikt, met Verbinding maken naar Azure Cosmos D B gemarkeerd.

  2. In het Verbinding maken naar Cosmos DB venster:

    1. Selecteer de API in de vervolgkeuzelijst.

    2. Plak uw connection string in het vak Verbindingsreeks. Zie De primaire connection string ophalen voor meer informatie connection string.

    3. Voer een accountlabel in en selecteer volgende om de samenvatting te controleren.

    4. Selecteer Verbinding maken verbinding te maken met het Azure Cosmos DB account.

      Schermopname van Verbinding maken cosmos D B-venster, met de vervolgkeuzelijst API, het vak Verbindingsreeks en het labelvak Account.

Notitie

Als de Azure Storage Explorer dat de Azure Cosmos DB connection string een ongeldige indeling heeft, moet u ervoor zorgen dat de connection string puntkomma () aan het einde ; heeft. Een voorbeeld van een geldige Azure Cosmos DB connection string is: AccountEndpoint=https://accountname.documents.azure.com:443;AccountKey=accountkey==;

Een lokale emulator gebruiken om verbinding te maken met Azure Cosmos DB

Gebruik de volgende stappen om verbinding te maken met een Azure Cosmos DB een emulator. Deze methode ondersteunt alleen SQL accounts.

  1. Installeer Cosmos DB Emulator en open het. Zie voor het installeren van de emulator Cosmos DB Emulator.

  2. Zoek Local en Attached in de linkerstructuur, klik met de rechtermuisknop op Cosmos DB Accounts en selecteer Verbinding maken om Cosmos DB Emulator.

    Schermopname van het menu dat wordt weergegeven nadat u met de rechtermuisknop hebt geklikt, met Verbinding maken naar Azure Cosmos D B Emulator gemarkeerd.

  3. In het Verbinding maken naar Cosmos DB venster:

    1. Plak uw connection string in het vak Verbindingsreeks. Zie Get the connection string (De connection string) voor meer informatie over het ophalen connection string primaire connection string.

    2. Voer een accountlabel in en selecteer volgende om de samenvatting te controleren.

    3. Selecteer Verbinding maken verbinding te maken met het Azure Cosmos DB account.

      Schermopname van Verbinding maken cosmos D B-venster, met het vak Verbindingsreeks en het vak Accountlabel.

Azure Cosmos DB-resourcebeheer

Gebruik de volgende bewerkingen om een Azure Cosmos DB beheren:

  • Open het account in de Azure Portal.
  • Voeg de resource toe aan de lijst Snelle toegang.
  • Resources zoeken en vernieuwen.
  • Databases maken en verwijderen.
  • Verzamelingen maken en verwijderen.
  • Documenten maken, bewerken, verwijderen en filteren.
  • Opgeslagen procedures, triggers en door de gebruiker gedefinieerde functies beheren.

Snelle toegang tot taken

U kunt met de rechtermuisknop op een abonnement in het deelvenster Explorer klikken om veel snelle actietaken uit te voeren, bijvoorbeeld:

  • Klik met de rechtermuisknop Azure Cosmos DB account of database en selecteer vervolgens Openen in portal om de resource te beheren in de browser op Azure Portal.

    Schermopname van het menu dat wordt weergegeven nadat u met de rechtermuisknop hebt geklikt, met Openen in portal gemarkeerd.

  • Klik met de rechtermuisknop Azure Cosmos DB account, database of verzameling en selecteer toevoegen aan snelle toegang om het toe te voegen aan het menu Snelle toegang.

  • Selecteer Zoeken in Hier om zoeken met trefwoorden in te stellen onder het geselecteerde pad.

    Schermopname waarin het zoekvak is gemarkeerd.

Database- en verzamelingbeheer

Een database maken

  1. Klik met de rechtermuisknop op Azure Cosmos DB account en selecteer database maken.

    Schermopname van het menu dat wordt weergegeven nadat u met de rechtermuisknop hebt geklikt, met Database maken gemarkeerd.

  2. Voer de naam van de database in en druk vervolgens op Enter om dit te voltooien.

Een database verwijderen

  1. Klik met de rechtermuisknop op de database en selecteer database verwijderen.

    Schermopname van het menu dat wordt weergegeven nadat u met de rechtermuisknop hebt geklikt, met Database verwijderen gemarkeerd.

  2. Selecteer Ja in het pop-upvenster. Het databaseknooppunt wordt verwijderd en het Azure Cosmos DB die Cosmos-account wordt automatisch vernieuwd.

    Schermopname van het bevestigingsvenster met de knop Ja gemarkeerd.

Een verzameling maken

  1. Klik met de rechtermuisknop op uw database en selecteer Verzameling maken.

    Schermopname van het menu dat wordt weergegeven nadat u met de rechtermuisknop hebt geklikt, met Verzameling maken gemarkeerd.

  2. Voer in het venster Verzameling maken de gevraagde gegevens in, zoals Verzamelings-id en Storage capaciteit, en meer. Selecteer ten slotte OK.

    Schermopname van het venster Verzameling maken, met het vak Verzamelings-ID en de knoppen Storage capaciteit.

  3. Selecteer Onbeperkt zodat u een partitiesleutel kunt opgeven en selecteer vervolgens OK om te voltooien.

    Notitie

    Als een partitiesleutel wordt gebruikt bij het maken van een verzameling, kunt u de partitiesleutelwaarde voor de verzameling niet meer wijzigen zodra het maken is voltooid.

    Schermopname van het venster Verzameling maken, waarin Onbeperkt is geselecteerd Storage Capaciteit en het vak Partitiesleutel is gemarkeerd.

Verwijder een collectie

  • Klik met de rechtermuisknop op de verzameling, selecteer Verzameling verwijderen en selecteer vervolgens Ja in het pop-upvenster.

    Het verzamelingsknooppunt wordt verwijderd en de database wordt automatisch vernieuwd.

    Schermopname van het menu dat wordt weergegeven nadat u met de rechtermuisknop hebt geklikt, met Verzameling verwijderen gemarkeerd.

Documentbeheer

Documenten maken en wijzigen

  • Open Documenten in het linkerdeelvenster, selecteer Nieuw document, bewerk de inhoud in het rechterdeelvenster en selecteer vervolgens Opslaan.

  • U kunt ook een bestaand document bijwerken en vervolgens Opslaan selecteren. Als u wijzigingen wilt verwijderen, selecteert u Negeren.

    Schermopname met Documenten gemarkeerd in het linkerdeelvenster. In het rechterdeelvenster zijn Nieuw document, Opslaan en Verwijderen gemarkeerd.

Een document verwijderen

  • Selecteer de knop Verwijderen om het geselecteerde document te verwijderen.

Query voor documenten

  • Als u het documentfilter wilt bewerken, voert u een SQL query inen selecteert u vervolgens Toepassen.

    Schermopname van het rechterdeelvenster met de knoppen Filter en Toepassen, het id-nummer en het queryvak gemarkeerd.

Grafiekbeheer

Een hoekpunt maken en wijzigen

  • Als u een nieuw hoekpunt wilt maken, opent Graph in het linkerdeelvenster, selecteert u Nieuw hoekpunt, bewerkt u de inhoud en selecteert u vervolgens OK.

  • Als u een bestaand hoekpunt wilt wijzigen, selecteert u het penpictogram in het rechterdeelvenster.

    Schermopname van Graph geselecteerd in het linkerdeelvenster, met Nieuw hoekpunt en het penpictogram gemarkeerd in het rechterdeelvenster.

Een grafiek verwijderen

  • Als u een hoekpunt wilt verwijderen, selecteert u het prullenbakpictogram naast de naam van het hoekpunt.

Filteren op grafiek

  • Als u het grafiekfilter wilt bewerken, voert u een Gremlin-query inen selecteert u filter toepassen.

    Schermopname van Graph geselecteerd in het linkerdeelvenster, met Filter toepassen en het queryvak gemarkeerd in het rechterdeelvenster.

Tabelbeheer

Een tabel maken en wijzigen

  • Een nieuwe tabel maken:

    1. Open Entiteiten in het linkerdeelvenster en selecteer vervolgens Toevoegen.

    2. Bewerk de inhoud in het dialoogvenster Entiteit toevoegen.

    3. Selecteer de knop Eigenschap toevoegen om een eigenschap toe te voegen.

    4. Selecteer Invoegen.

      Schermopname van entiteiten die zijn gemarkeerd in het linkerdeelvenster en waarin Toevoegen, Bewerken, Eigenschap toevoegen en Invoegen zijn gemarkeerd in het rechterdeelvenster.

  • Als u een tabel wilt wijzigen, selecteert u Bewerken, wijzigt u de inhoud en selecteert u vervolgens Bijwerken.

Tabel importeren en exporteren

  • Als u wilt importeren, selecteert u de knop Importeren en kiest u vervolgens een bestaande tabel.

  • Als u wilt exporteren, selecteert u de knop Exporteren en kiest u vervolgens een bestemming.

    Schermopname met de knoppen Importeren en Exporteren gemarkeerd in het rechterdeelvenster.

Entiteiten verwijderen

  • Selecteer de entiteiten en selecteer vervolgens de knop Verwijderen.

    Schermopname met de knop Verwijderen gemarkeerd in het rechterdeelvenster en een bevestigingspop-upvenster met Ja gemarkeerd.

Een query uitvoeren op een tabel

  • Selecteer de knop Query, voer een queryvoorwaarde in en selecteer vervolgens de knop Query uitvoeren. Selecteer de knop Query sluiten om het querydeelvenster te sluiten.

    Schermopname van het rechterdeelvenster met de knop Query uitvoeren en de knop Query sluiten gemarkeerd.

Opgeslagen procedures, triggers en UDF's beheren

  • Een opgeslagen procedure maken:

    1. Klik in de linkerstructuur met de rechtermuisknop op Opgeslagen procedures en selecteer vervolgens Opgeslagen procedure maken.

      Schermopname van het linkerdeelvenster met het menu dat wordt weergegeven nadat u met de rechtermuisknop hebt geklikt, met Opgeslagen procedure maken gemarkeerd.

    2. Voer een naam in aan de linkerkant, voer de opgeslagen procedurescripts in het rechterdeelvenster in en selecteer vervolgens Maken.

  • Als u een bestaande opgeslagen procedure wilt bewerken, dubbelklikt u op de procedure, maakt u de update en selecteert u Vervolgens Bijwerken om op te slaan. U kunt ook Verwijderen selecteren om de wijziging te annuleren.

  • De bewerkingen voor Triggers en UDF zijn vergelijkbaar met opgeslagen procedures.

Problemen oplossen

Hier volgen oplossingen voor veelvoorkomende problemen die zich voordoen wanneer u Azure Cosmos DB in Storage Explorer.

Problemen met aanmelden

Start eerst de toepassing opnieuw op om te zien of het probleem daarmee is opgelost. Als het probleem zich blijft voordoen, gaat u verder met het oplossen van problemen.

Zelfondertekend certificaat in de certificaatketen

Er zijn enkele redenen waarom u deze fout ziet. Dit zijn de twee meest voorkomende:

  • U zit achter een transparante proxy. Iemand, zoals uw IT-afdeling, onderschept HTTPS-verkeer, ontsleutelt het en versleutelt het vervolgens met behulp van een zelf-ondertekend certificaat.

  • U gebruikt software, zoals antivirussoftware. De software injecteert een zelf-ondertekend TLS/SSL-certificaat in de HTTPS-berichten die u ontvangt.

Wanneer Storage Explorer een zelf-ondertekend certificaat vindt, weet het niet of het ONTVANGEN HTTPS-bericht is gemanipuleerd. Als u een kopie van het zelf-ondertekende certificaat hebt, kunt u uw Storage Explorer het vertrouwen. Als u niet zeker weet wie het certificaat heeft geïnjecteerd, kunt u deze stappen volgen om erachter te komen:

  1. OpenSSL installeren:

    • Windows:een van de lichte versies is in orde.
    • macOS en Linux: moet zijn opgenomen in uw besturingssysteem.

  2. OpenSSL uitvoeren:

    • Windows: ga naar de installatiemap, klik vervolgens op /bin/ en dubbelklik op openssl.exe.
    • Mac en Linux: voer openssl uit vanuit een terminal.

  3. Voer s_client -showcerts -connect microsoft.com:443 uit.

  4. Zoek naar zelfondertekende certificaten. Als u niet zeker weet welke zelf-ondertekende zijn, zoek dan overal waar het onderwerp ('s:') en de vergever ('i:') hetzelfde zijn.

  5. Als u zelf-ondertekende certificaten vindt, kopieert en plakt u alles van en inclusief -----BEGIN CERTIFICATE----- tot -----END CERTIFICATE----- naar een nieuwe . CER-bestand voor elk bestand.

  6. Open Storage Explorer en ga vervolgens naar > SSL-certificaten importeren > van certificaten bewerken. Gebruik de bestands picker om de te zoeken, te selecteren en vervolgens te openen. CER-bestanden die u hebt gemaakt.

Als u geen zelf-ondertekende certificaten vindt, kunt u feedback verzenden voor meer hulp.

Kan geen abonnementen ophalen

Als u uw abonnementen niet kunt ophalen nadat u zich hebt aanmelden, kunt u deze suggesties proberen:

  • Controleer of uw account toegang heeft tot de abonnementen. Meld u hiervoor aan bij de Azure Portal.

  • Zorg ervoor dat u bent aangemeld bij de juiste omgeving:

  • Als u zich achter een proxy hebt, moet u ervoor zorgen dat Storage Explorer proxy juist is geconfigureerd.

  • Verwijder het account en voeg het vervolgens opnieuw toe.

  • Verwijder de volgende bestanden uit uw basismap (zoals: C:\Users\ContosoUser) en voeg het account opnieuw toe:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Druk op de toets F12 om de ontwikkelaarsconsole te openen. Bekijk de console voor foutberichten wanneer u zich aanmeldt.

    Schermopname van de console voor ontwikkelhulpprogramma's, waarin Console is gemarkeerd.

Kan de verificatiepagina niet zien

Als u de verificatiepagina niet kunt zien:

  • Afhankelijk van de snelheid van uw verbinding kan het even duren voordat de aanmeldingspagina is geladen. Wacht ten minste één minuut voordat u het verificatiedialoogvenster sluit.
  • Als u zich achter een proxy hebt, moet u ervoor zorgen dat Storage Explorer proxy juist is geconfigureerd.
  • Bekijk in de console voor ontwikkelhulpprogramma's (F12) de antwoorden om te zien of u een aanwijzing kunt vinden waarom verificatie niet werkt.

Kan een account niet verwijderen

Als u een account niet kunt verwijderen of als de koppeling voor opnieuw authenticate niets doet:

  • Verwijder de volgende bestanden uit uw basismap en voeg het account opnieuw toe:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Als u aan SAS gekoppelde opslagbronnen wilt verwijderen, verwijder dan:

    • De map %AppData%/StorageExplorer voor Windows
    • /Users/<your_name>/Library/Application SUpport/StorageExplorer voor macOS
    • ~/.config/StorageExplorer voor Linux

    Notitie

    Als u deze bestanden verwijdert, moet u al uw referenties opnieuw ingeven.

Http/HTTPS-proxyprobleem

U kunt geen lijst Azure Cosmos DB knooppunten in de linkerstructuur wanneer u een HTTP/HTTPS-proxy in ASE configureert. U kunt Azure Cosmos DB data explorer in de Azure Portal als een work-around.

Probleem met het knooppunt 'Ontwikkeling' onder het knooppunt 'Lokaal en gekoppeld'

Er is geen reactie nadat u het knooppunt Ontwikkeling hebt geselecteerd onder het knooppunt Lokaal en gekoppeld in de linkerstructuur. Dit gedrag is verwacht.

Schermopname waarin het knooppunt Ontwikkeling is geselecteerd.

Voeg een Azure Cosmos DB-account toe in de fout lokaal en gekoppeld knooppunt

Als u de volgende fout ziet nadat u een Azure Cosmos DB-account hebt gekoppeld in het knooppunt Lokaal en gekoppeld, moet u ervoor zorgen dat u de juiste connection string.

Schermopname van het pop-upvenster Kan onderliggende resources niet ophalen, waarmee getaddrinfo ENOTFOUND wordt aangegeven.

Fout met uitvouwen van Azure-Cosmos DB-knooppunt

Mogelijk ziet u de volgende fout wanneer u knooppunten in de linkerstructuur probeert uit te vouwen.

Schermopname van het pop-upvenster Kan onderliggende resources niet ophalen, waarin wordt aangegeven dat er geen verbinding kan worden gemaakt met dit Cosmos D B-account.

Probeer de volgende suggesties:

  • Controleer of het Azure Cosmos DB wordt ingericht. Probeer het opnieuw wanneer het account is gemaakt.
  • Als het account zich onder de knooppunten Snelle toegang of Lokaal en Gekoppeld, controleert u of het account is verwijderd. Als dat het zo is, moet u het knooppunt handmatig verwijderen.

Volgende stappen