správa prostředků Azure Cosmos DB pomocí Průzkumník služby Azure Storage

  • Článek
  • 9 min ke čtení

platí pro: SQL api rozhraní API Cassandra Gremlin api rozhraní API pro tabulky Azure Cosmos DB api pro MongoDB

k připojení k Azure Cosmos DB můžete použít aplikaci Azure Storage explorer. umožňuje připojení k účtům Azure Cosmos DB hostovaným v Azure a v cloudech z Windows, macOS nebo Linux.

Použijte stejný nástroj ke správě různých entit Azure na jednom místě. můžete spravovat Azure Cosmos DB entit, manipulovat s daty, aktualizovat uložené procedury a triggery spolu s dalšími entitami Azure, jako jsou objekty blob a fronty služby storage. Průzkumník služby Azure Storage podporuje účty Cosmos nakonfigurované pro rozhraní api SQL, MongoDB, Graph a Table.

Poznámka

Integrace služby Azure Cosmos DB s Průzkumníkem služby Storage je zastaralá. Všechny stávající funkce nebudou odebrány z tohoto vydání nejméně po dobu jednoho roku. místo toho byste měli použít portál azure portal, desktopovou aplikaci azure portal nebo samostatný Azure Cosmos DB Explorer . Tyto alternativní možnosti obsahují mnoho nových funkcí, které Průzkumník služby Storage v současnosti nepodporuje.

Požadavky

účet Cosmos s rozhraním api SQL nebo rozhraní api Azure Cosmos DB pro MongoDB. Pokud účet nemáte, můžete ho vytvořit v Azure Portal. další informace najdete v tématu Azure Cosmos DB: sestavení webové aplikace API SQL pomocí .net a Azure Portal .

Instalace

chcete-li nainstalovat nejnovější Průzkumník služby Azure Storage bitů, přečtěte si téma Průzkumník služby Azure Storage. podporujeme verze Windows, Linux a macOS.

Připojení k předplatnému Azure

  1. po instalaci Průzkumník služby Azure Storage v levém podokně vyberte ikonu modulu plug-in .

    Snímek obrazovky znázorňující ikonu modulu plug-in v levém podokně.

  2. Vyberte Přidat účet Azure a pak vyberte Přihlásit.

    snímek obrazovky s oknem Připojení a Azure Storage zobrazeným tlačítkem přidat přepínač účtu azure a rozevírací nabídkou prostředí azure

  3. V dialogovém okně přihlášení do Azure vyberte Přihlásit se a zadejte svoje přihlašovací údaje Azure.

    Snímek obrazovky okna přihlásit, kde se zobrazí údaje o tom, kde zadat přihlašovací údaje pro vaše předplatné Azure

  4. Vyberte ze seznamu své předplatné a pak vyberte Použít.

    Snímek obrazovky s podoknem Správa účtů zobrazující seznam předplatných a tlačítka použít.

    Podokno Průzkumník aktualizuje a zobrazí účty ve vybraném předplatném.

    Snímek obrazovky podokna Průzkumníka, který se aktualizuje a zobrazí účty ve vybraném předplatném.

    váš účet Cosmos DB je připojený k vašemu předplatnému Azure.

připojení k Azure Cosmos DB pomocí připojovacího řetězce

připojovací řetězec můžete použít pro připojení k Azure Cosmos DB. tato metoda podporuje pouze SQL a rozhraní Table api. Pomocí těchto kroků se připojte s připojovacím řetězcem:

  1. v levém stromě vyhledejte místní a připojené , klikněte pravým tlačítkem na Cosmos DB účty a potom vyberte Připojení a Cosmos DB.

    snímek obrazovky s rozevírací nabídkou po kliknutí pravým tlačítkem myši se zvýrazněnou možností Připojení do Azure Cosmos D B.

  2. v okně Připojení Cosmos DB :

    1. V rozevírací nabídce vyberte rozhraní API.

    2. Do pole připojovací řetězec vložte připojovací řetězec. Informace o tom, jak načíst primární připojovací řetězec, najdete v tématu získání připojovacího řetězce.

    3. Zadejte popisek účtu a kliknutím na tlačítko Další zkontrolujte souhrn.

    4. vyberte Připojení pro připojení k účtu Azure Cosmos DB.

      snímek obrazovky okna Připojení do Cosmos D B zobrazení rozevírací nabídky rozhraní API a pole připojovací řetězec a popisek účtu.

Poznámka

pokud Průzkumník služby Azure Storage ukáže, že připojovací řetězec Azure Cosmos DB má neplatný formát, ujistěte se, že připojovací řetězec obsahuje středník ( ; ) na konci. příklad platného připojovacího řetězce Azure Cosmos DB by byl:AccountEndpoint=https://accountname.documents.azure.com:443;AccountKey=accountkey==;

připojení k Azure Cosmos DB pomocí místního emulátoru

pomocí následujících kroků se připojte k Azure Cosmos DB pomocí emulátoru. tato metoda podporuje pouze účty SQL.

  1. nainstalujte Cosmos DB Emulator a pak ho otevřete. postup instalace emulátoru najdete v tématu Cosmos DB Emulator.

  2. v levém stromě vyhledejte místní a připojené , klikněte pravým tlačítkem na Cosmos DB účty a potom vyberte Připojení Cosmos DB Emulator.

    snímek obrazovky zobrazující nabídku, která se zobrazí po kliknutí pravým tlačítkem myši s Připojení do Azure Cosmos D B Emulator zvýrazněna.

  3. v okně Připojení Cosmos DB :

    1. Do pole připojovací řetězec vložte připojovací řetězec. Informace o načtení primárního připojovacího řetězce najdete v tématu získání připojovacího řetězce.

    2. Zadejte popisek účtu a kliknutím na tlačítko Další zkontrolujte souhrn.

    3. vyberte Připojení pro připojení k účtu Azure Cosmos DB.

      snímek obrazovky okna Připojení do Cosmos D B, které zobrazuje pole připojovací řetězec a popisek účtu.

Správa prostředků Azure Cosmos DB

ke správě účtu Azure Cosmos DB použijte následující operace:

  • Otevřete účet v Azure Portal.
  • Přidejte prostředek do seznamu rychlý přístup.
  • Hledání a aktualizace prostředků
  • Vytváření a odstraňování databází.
  • Vytvářejte a odstraňujte kolekce.
  • Vytváření, úpravy, odstraňování a filtrování dokumentů.
  • Spravujte uložené procedury, triggery a uživatelsky definované funkce.

Úlohy rychlého přístupu

Můžete kliknout pravým tlačítkem na předplatné v podokně Průzkumník a provést mnoho běžných úloh, například:

  • klikněte pravým tlačítkem myši na účet Azure Cosmos DB nebo databázi a potom vyberte otevřít na portálu pro správu prostředků v prohlížeči v Azure Portal.

    Snímek obrazovky zobrazující nabídku, která se zobrazí po kliknutí pravým tlačítkem myši s zvýrazněnou možností otevřít na portálu

  • klikněte pravým tlačítkem myši na účet Azure Cosmos DB, databázi nebo kolekci a pak vyberte možnost přidat k rychlému přístupu a přidejte ji do nabídky rychlý přístup.

  • Pokud chcete povolit hledání klíčových slov v rámci vybrané cesty, vyberte Hledat odsud.

    Snímek obrazovky znázorňující zvýrazněné pole hledání

Správa databází a kolekcí

Vytvoření databáze

  1. klikněte pravým tlačítkem na účet Azure Cosmos DB a pak vyberte vytvořit databázi.

    Snímek obrazovky zobrazující nabídku, která se zobrazí po kliknutí pravým tlačítkem myši s zvýrazněnou možností vytvořit databázi.

  2. Zadejte název databáze a potom stisknutím klávesy ENTER dokončete akci.

Odstranění databáze

  1. Klikněte pravým tlačítkem na databázi a pak vyberte odstranit databázi.

    Snímek obrazovky zobrazující nabídku, která se zobrazí po kliknutí pravým tlačítkem myši s zvýrazněnou možností odstranit databázi.

  2. V automaticky otevíraném okně vyberte Ano . Uzel databáze se odstraní a účet služby Azure Cosmos DB se automaticky aktualizuje.

    Snímek obrazovky s oknem potvrzení se zvýrazněným tlačítkem Ano

Vytvoření kolekce

  1. Klikněte pravým tlačítkem na databázi a potom vyberte vytvořit kolekci.

    Snímek obrazovky zobrazující nabídku, která se zobrazí po kliknutí pravým tlačítkem myši se zvýrazněnou možností vytvořit kolekci.

  2. v okně vytvořit kolekci zadejte požadované informace, jako je ID kolekce a Storage kapacita atd. Kliknutím na tlačítko OK dokončete.

    snímek obrazovky okna vytvořit kolekci zobrazující kolekci I D a tlačítka Storage kapacity

  3. Vyberte možnost neomezeno , abyste mohli zadat klíč oddílu, a potom kliknutím na tlačítko OK dokončete akci.

    Poznámka

    Pokud se při vytváření kolekce použije klíč oddílu, po vytvoření se už hodnota klíče oddílu v kolekci nedá změnit.

    snímek obrazovky okna vytvořit kolekci zobrazující neomezený počet vybraný pro Storageou kapacitu a zvýrazněné pole klíč oddílu

Odstranění kolekce

  • Klikněte pravým tlačítkem na kolekci, vyberte Odstranit kolekci a pak v automaticky otevíraném okně vyberte Ano .

    Uzel kolekce se odstraní a databáze se automaticky aktualizuje.

    Snímek obrazovky zobrazující nabídku, která se zobrazí po kliknutí pravým tlačítkem myši s zvýrazněnou možností odstranit kolekci

Správa dokumentů

Vytváření a úpravy dokumentů

  • V levém podokně otevřete Dokumenty, vyberte Nový dokument, upravte obsah v pravém podokně a pak vyberte Uložit.

  • Můžete také aktualizovat existující dokument a pak vybrat Uložit. Pokud chcete změny zahodit, vyberte Zahodit.

    Snímek obrazovky znázorňující zvýrazněné dokumenty v levém podokně V pravém podokně jsou zvýrazněné části Nový dokument, Uložit a Zahodit.

Odstranění dokumentu

  • Výběrem tlačítka Odstranit odstraňte vybraný dokument.

Dotazování dokumentů

  • Pokud chcete filtr dokumentu upravit, zadejte SQL dotazua pak vyberte Použít.

    Snímek obrazovky s pravým podoknem a zvýrazněnou tlačítkem Filtr a Použít, číslem ID a polem dotazu

Správa grafů

Vytvoření a úprava vrcholu

  • Pokud chcete vytvořit nový vrchol, otevřete Graph v levém podokně, vyberte Nový vrchol, upravte obsah a pak vyberte OK.

  • Pokud chcete upravit existující vrchol, vyberte ikonu pera v pravém podokně.

    Snímek obrazovky Graph v levém podokně vybraná možnost Nový vrchol a zvýrazněná ikona pera v pravém podokně

Odstranění grafu

  • Pokud chcete odstranit vrchol, vyberte ikonu koše vedle názvu vrcholu.

Filtrování grafu

  • Pokud chcete filtr grafu upravit, zadejte dotaz Gremlina pak vyberte Použít filtr.

    Snímek obrazovky Graph v levém podokně vybraná možnost Použít filtr a zvýrazněné pole dotazu v pravém podokně

Správa tabulek

Vytvoření a úprava tabulky

  • Vytvoření nové tabulky:

    1. V levém podokně otevřete Entities (Entity) a pak vyberte Add (Přidat).

    2. V dialogovém okně Přidat entitu upravte obsah.

    3. Vyberte tlačítko Přidat vlastnost a přidejte vlastnost.

    4. Vyberte Vložit.

      Snímek obrazovky znázorňující zvýrazněné entity v levém podokně a zvýrazněné položky Přidat, Upravit, Přidat vlastnost a Vložit v pravém podokně

  • Pokud chcete tabulku upravit, vyberte Upravit, upravte obsah a pak vyberte Aktualizovat.

Import a export tabulky

  • Importujete tak, že vyberete tlačítko Importovat a pak zvolíte existující tabulku.

  • Pokud chcete exportovat, vyberte tlačítko Exportovat a pak zvolte cíl.

    Snímek obrazovky se zvýrazněnou tlačítky Importovat a Exportovat v pravém podokně

Odstranění entit

  • Vyberte entity a pak vyberte tlačítko Odstranit.

    Snímek obrazovky znázorňující zvýrazněné tlačítko Odstranit v pravém podokně a automaticky otevírané okno pro potvrzení se zvýrazněnou možností Ano

Dotazování tabulky

  • Vyberte tlačítko Dotaz, zadejte podmínku dotazu a pak vyberte tlačítko Provést dotaz. Pokud chcete podokno dotazu zavřít, vyberte tlačítko Zavřít dotaz.

    Snímek obrazovky pravého podokna se zvýrazněnou tlačítkem Execute Query (Spustit dotaz) a tlačítkem Close Query (Zavřít dotaz)

Správa uložených procedur, triggerů a funkcí definovaných uživatelem

  • Vytvoření uložené procedury:

    1. V levém stromu klikněte pravým tlačítkem na Uložené procedury a pak vyberte Vytvořit uloženou proceduru.

      Snímek obrazovky s levým podoknem zobrazující nabídku, která se zobrazí po kliknutí pravým tlačítkem a zvýrazněnou možností Vytvořit uloženou proceduru

    2. Vlevo zadejte název, v pravém podokně zadejte skripty uložené procedury a pak vyberte Vytvořit.

  • Pokud chcete upravit existující uloženou proceduru, poklikejte na proceduru, proveďte aktualizaci a pak výběrem možnosti Aktualizovat ji uložte. Pokud chcete změnu zrušit, můžete také vybrat Zahodit.

  • Operace triggerů a UDF se podobají uloženým procedurám.

Řešení potíží

Níže najdete řešení běžných problémů, ke které dochází při používání Azure Cosmos DB v Průzkumník služby Storage.

Problémy s přihlášením

Nejprve restartujte aplikaci, abyste viděli, jestli se tím problém vyřešil. Pokud problém přetrvává, pokračujte v řešení potíží.

Certifikát podepsaný svým držitelem v řetězu certifikátů

Tato chyba se může zobrazit z několika důvodů, mezi nejběžnější dva důvody můžou být následující:

  • Jste za transparentním proxy serverem. Někdo, stejně jako vaše IT oddělení, zachycuje provoz HTTPS, dešifruje ho a pak ho zašifruje pomocí certifikátu podepsaného svým držitelem.

  • Používáte software, jako je antivirový software. Software vloží certifikát TLS/SSL podepsaný svým držitelem do zpráv HTTPS, které obdržíte.

Když Průzkumník služby Storage certifikát podepsaný svým držitelem, neví, jestli se zpráva HTTPS, se kterou obdrží, manipuloval. Pokud máte kopii certifikátu podepsaného svým držitelem, můžete mu Průzkumník služby Storage důvěřovat. Pokud si nejste jistí, kdo certifikát injektoval, můžete to zkusit zjistit pomocí těchto kroků:

  1. Nainstalujte OpenSSL:

    • Windows:Všechny světlé verze jsou v pořádku.
    • macOS a Linux: Měl by být součástí vašeho operačního systému.

  2. Spusťte OpenSSL:

    • Windows: Přejděte do instalačního adresáře, pak na /bin/ a poklikejte na openssl.exe.
    • Mac a Linux: Z terminálu spusťte příkaz openssl.

  3. Spusťte s_client -showcerts -connect microsoft.com:443 .

  4. Vyhledejte certifikáty podepsané svým držitelem. Pokud si nejste jistí, které jsou podepsané svým držitelem, hledejte všude, kde je předmět ("s:") stejný jako vystavitel ("i:").

  5. Pokud najdete nějaké certifikáty podepsané svým držitelem, zkopírujte a vložte všechno z a včetně -----BEGIN CERTIFICATE----- do -----END CERTIFICATE----- na nový . Soubor CER pro každý z nich.

  6. Otevřete Průzkumník služby Storage a pak přejděte na Upravit > certifikáty SSL Import > certifikátů. Pomocí nástroje pro výběr souborů vyhledejte, vyberte a pak otevřete . Soubory CER, které jste vytvořili.

Pokud nenajdete žádné certifikáty podepsané svým držitelem, můžete odeslat zpětnou vazbu a získat další pomoc.

Nelze načíst předplatná

Pokud se vám po přihlášení nedaří načíst předplatná, vyzkoušejte tyto návrhy:

  • Ověřte, že váš účet má přístup k předplatným. Pokud to chcete udělat, přihlaste se k Azure Portal.

  • Ujistěte se, že jste přihlášeni ke správnému prostředí:

  • Pokud se nacházíte za proxy serverem, ujistěte se, že je Průzkumník služby Storage proxy server správně nakonfigurovaný.

  • Odeberte účet a pak ho znovu přidejte.

  • Odstraňte následující soubory z domovského adresáře (například C:\Users\ContosoUser) a pak znovu přidejte účet:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Stisknutím klávesy F12 otevřete konzolu pro vývojáře. Při přihlášení sledujte v konzole všechny chybové zprávy.

    Snímek obrazovky konzoly vývojářských nástrojů se zvýrazněnou konzolou

Ověřovací stránka se nezobrazuje

Pokud se vám nezobrazuje ověřovací stránka:

  • V závislosti na rychlosti připojení může načtení přihlašovací stránky chvíli trvat. Před zavřením dialogového okna ověřování počkejte alespoň jednu minutu.
  • Pokud se nacházíte za proxy serverem, ujistěte se, že je Průzkumník služby Storage proxy server správně nakonfigurovaný.
  • Na konzole vývojářských nástrojů (F12) sledujte odpovědi, abyste zjistili, jestli nenajdete nějaké vodítko, proč ověřování nefunguje.

Nejde odebrat účet.

Pokud nemůžete odebrat účet, nebo pokud odkaz na opětovné ověření nedělá cokoli:

  • Odstraňte následující soubory z domovského adresáře a pak znovu přidejte účet:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Pokud chcete odebrat prostředky služby Storage připojené sdíleným přístupovým podpisem, odstraňte:

    • Složku %AppData%/StorageExplorer ve Windows.
    • /Users/<your_name>/Library/Application Support podpora/StorageExplorer pro macOS
    • Složku ~/.config/StorageExplorer v Linuxu.

    Poznámka

    Pokud tyto soubory odstraníte, musíte znovu zadat všechny přihlašovací údaje.

Problém s proxy HTTP/HTTPS

když nakonfigurujete proxy server HTTP/HTTPS v pomocném mechanismu služby, nemůžete v levém stromu zobrazit seznam uzlů Azure Cosmos DB. Azure Cosmos DB průzkumníku dat v Azure Portal můžete použít jako práci.

Problém s uzlem Vývoj v uzlu Místní a připojené

Po výběru uzlu pro vývoj pod místním a připojeným uzlem v levém stromu není žádná odpověď. Jedná se o očekávané chování.

Snímek obrazovky znázorňující vybraný vývojový uzel

při chybě místního a připojeného uzlu připojit Azure Cosmos DB účet

pokud se po připojení Azure Cosmos DB účtu v místním a připojeném uzlu zobrazí následující chyba, ujistěte se, že používáte správný připojovací řetězec.

Snímek obrazovky s automaticky otevíraných oknem chyby při načítání podřízených prostředků, který označuje getaddrinfo ENOTFOUND.

Chyba rozbalení uzlu služby Azure Cosmos DB

Při pokusu o rozbalení uzlů v levém stromu se může zobrazit následující chyba.

snímek obrazovky s místním oknem pro chyby nelze načíst podřízené prostředky, což značí, že se nemůže připojit k tomuto Cosmos účtu D B.

Vyzkoušejte tyto návrhy:

  • ověřte, zda Azure Cosmos DB účet probíhá zřizování. Zkuste to znovu, až se účet úspěšně vytvoří.
  • Pokud je účet pod rychlým přístupem nebo místními a připojenými uzly, ověřte, jestli je účet odstraněný. Pokud ano, budete muset uzel odebrat ručně.

Další kroky