Použití editoru Visual Studio Code k připojení a dotazování instancí služby Azure Cosmos DB

Visual Studio Code je univerzální editor kódu pro Linux, macOS a Windows, který podporuje řadu rozšíření. V tomto rychlém startu se dozvíte, jak se připojit ke službě Azure Cosmos DB for NoSQL a Azure Cosmos DB for MongoDB pomocí nástroje Visual Studio Code. Zabývá se prováděním základních databázových operací, včetně dotazování, vkládání, aktualizace a odstraňování dat.

Požadavky

• Účet Služby Azure Cosmos DB for NoSQL nakonfigurovaný s databází a kontejnerem K nastavení prostředku použijte některý z těchto rychlých startů:
  • Azure Portal
  • Azure CLI

Nainstalovat rozšíření

Pokud se chcete připojit a spravovat data ve službě Azure Cosmos DB v sadě Visual Studio, nejprve nainstalujte rozšíření Azure Databases .

1. Otevřete Visual Studio Code.
2. Přejděte do podokna Rozšíření výběrem možnosti Zobrazit > rozšíření nebo pomocí klávesové zkratky Ctrl + Shift + X ve Windows a Command + Shift + X v macOS.
3. Na panelu hledání zadejte DocumentDB pro Visual Studio Code a vyberte rozšíření. Pak vyberte Nainstalovat.
4. Po instalaci znovu načtěte Visual Studio Code, pokud se zobrazí výzva.

Připojení ke službě Azure Cosmos DB for NoSQL

1. V editoru Visual Studio Code přejděte do podokna Azure (vyberte ikonu Azure na panelu aktivit).

2. Přihlaste se ke svému účtu Azure Cosmos DB for NoSQL prostřednictvím ID Microsoft Entra:

   Poznámka:

   Při přístupu k prostředkům Azure Cosmos DB použijte řízení přístupu na základě role na základě ID Microsoft Entra.

3. Po přihlášení vyhledejte ve stromovém zobrazení Azure své předplatné Azure a přejděte k podrobnostem ke službě Azure Cosmos DB.

4. Vyberte existující účet nebo kliknutím pravým tlačítkem myši vytvořte nový prostředek.

Dotazování a zobrazení dat

Následující kroky používají Editor dotazů k provedení dotazu a zobrazení výsledků dotazu:

1. V nabídce kolekce kliknutím pravým tlačítkem na kolekci otevřete Editor Power Query v náhledu.

   

2. Spuštěním dotazu poskytnutého v editoru dotazů zobrazte data v zobrazení tabulky:

   

3. Prozkoumejte data v jiných podporovaných zobrazeních:

   • Zobrazení JSON: Podívejte se na nezpracovanou datovou strukturu.

     

   • Stromové zobrazení: Snadno prozkoumáte vnořená data.

     

Zobrazení metrik dotazů a indexů

V editoru dotazů si prohlédněte další metriky dotazů a indexů, které vám pomůžou lépe optimalizovat výkon dotazů.

1. Vyberte kartu Statistiky vedle výsledků dotazu.

2. Další informace o definicích metrik najdete v dokumentaci k metrikám dotazů.

Vkládání, úpravy a odstraňování dokumentů

• Úpravy dokumentů v reálném čase: Umožňuje okamžitě přidávat, zobrazovat, upravovat a odstraňovat dokumenty se změnami, které se projeví v reálném čase.

• Import z JSON: Načtěte data rychle ze souborů JSON.

Export výsledků dotazu

• Výsledky stahování: Stáhněte si výsledky dotazu do souborů CSV nebo JSON.

Související obsah

• Začínáme s rozhraním API pro NoSQL
• Rychlý start pro Node.js
• Rychlý start pro Python
• Rychlý start pro Javu
• Rychlý start pro Go

Požadavky

• Účet Služby Azure Cosmos DB for NoSQL nakonfigurovaný s databází a kontejnerem
• Prostředí MongoDB (Mongosh) nainstalované pro interakce s příkazovým řádkem (volitelné, ale doporučené).

Nainstalovat rozšíření

Pokud se chcete připojit a spravovat data ve službě Azure Cosmos DB, musíte nainstalovat rozšíření Azure Databases pro Visual Studio Code.

1. Otevřete Visual Studio Code.
2. Přejděte do podokna Rozšíření výběrem možnosti Zobrazit > rozšíření nebo pomocí klávesové zkratky Ctrl + Shift + X ve Windows a Command + Shift + X v macOS.
3. Na panelu hledání zadejte DocumentDB pro Visual Studio Code a vyberte rozšíření. Pak vyberte Nainstalovat.
4. Po instalaci znovu načtěte Visual Studio Code, pokud se zobrazí výzva.

Připojení k úloze MongoDB

Teď se připojte k úloze MongoDB ve službě Azure Cosmos DB pro MongoDB.

1. Na panelu Pracovní prostor rozbalte část Účty MongoDB.

2. Tady můžete zobrazit všechny účty MongoDB. Připojte se k novému účtu MongoDB pomocí svých přihlašovacích údajů.

   Poznámka:

   Všechny úspěšně připojené clustery MongoDB zůstanou uvedené v části Účty MongoDB i po zavření nástroje Visual Studio Code.

Intuitivní Správa dat

Snadno spravovat databáze v editoru Visual Studio Code:

• Vytváření a odstraňování databází/kolekcí: Vytváření nebo odstraňování databází a kolekcí pomocí místní nabídky v účtu, databázi nebo kolekci na panelu prostředků.

• Import z JSON: Rychle naimportujte data ze souborů JSON do vaší kolekce.

  • Zahájit import
    1. Klikněte pravým tlačítkem myši na název kolekce v zobrazení prostředků a vyberte Importovat dokumenty do kolekce.
    2. Můžete také otevřít "Zobrazení kolekce" kliknutím na položku Dokumenty v kolekci a následným výběrem tlačítka Importovat .
  • Výběr souboru JSON
    1. Vyhledejte soubor *.json obsahující vaše data.
    2. Potvrďte spuštění procesu importu.

• Export dat: Ukládání kolekcí nebo výsledků dotazu jako JSON pro zálohování nebo sdílení

  • Zahájit export:
    • Možnost 1
      1. Klikněte pravým tlačítkem myši na název kolekce v zobrazení prostředků a výběrem možnosti Exportovat dokumenty z kolekce exportujte celou kolekci.
    • Možnost 2
      1. Kliknutím na položku Dokumenty v kolekci otevřete zobrazení kolekce a pak vyberte tlačítko Exportovat .
      2. Zvolte, jestli chcete exportovat celou kolekci, nebo výsledky aktuálního dotazu.
  • Zadejte cílový soubor:
    1. Zadejte název a umístění cílového souboru *.json.
    2. Potvrďte export a začněte ukládat data.

• Úpravy dokumentů v reálném čase: Okamžité přidávání, zobrazování, úpravy a odstraňování dokumentů s aktualizacemi v reálném čase

  • Otevřít úpravy dokumentu:
    • Přístup k možnostem úprav dokumentů přímo v zobrazení kolekce Tyto ovládací prvky jsou pohodlně umístěné nad zobrazením dat pro snadný přístup.
  • Dostupné akce:
    • Přidat: Vytvořte nové dokumenty v kolekci.
    • Zobrazení: Umožňuje zobrazit obsah vybraného dokumentu.
    • Upravit: Umožňuje upravit obsah vybraných dokumentů.
    • Odstranit: Odeberte vybrané dokumenty se změnami, které se projeví okamžitě.

Výkonné nástroje pro dotazy

Bezproblémově spouštět a upřesňovat dotazy:

• Okamžité výsledky: Okamžité zobrazení výsledků dotazu ve vašem preferovaném formátu – tabulka, JSON nebo stromové zobrazení.

  • Pomocí rozevírací nabídky Zobrazit můžete snadno přepínat zobrazení.

• Přímé spouštění dotazů: Psaní a spouštění dotazů MongoDB s funkcemi, jako je zvýrazňování syntaxe a automatické dokončování

  • Pokud chcete dotaz spustit, vyberte tlačítko Najít dotaz nebo stiskněte Ctrl/Cmd+Enter v editoru dotazů.

Poznámka:

V současné době se podporují pouze vyhledávací dotazy s rozšířenými možnostmi dotazů.

Flexibilní zobrazení dat

Prozkoumejte data pomocí více zobrazení pro různé perspektivy:

• Zobrazení JSON: Podívejte se na nezpracovanou datovou strukturu JSON.

  

• Stromové zobrazení: Snadno procházejte a prozkoumejte vnořená data.

  

• Zobrazení tabulky: Umožňuje rychle zkontrolovat data a přejít k podrobnostem vnořených dokumentů.

  • Přechod k podrobnostem: Vyhledejte položky s ikonou {} , která označuje vložené objekty. Poklikáním rozbalíte a zobrazíte obsah.

  • Zpět: Vraťte se na předchozí úrovně pomocí navigačních popisů cesty pod zobrazením tabulky.

  

Integrace prostředí Mongo Shell

Funkce příkazového řádku jsou k dispozici:

• Spuštění: Spusťte mongoshpokročilé příkazy MongoDB přímo ze sady Visual Studio Code.

Poznámka:

Prostředí MongoDB (mongosh) není součástí rozšíření. Musí se nainstalovat samostatně a nakonfigurovat ručně.

Správa clusteru

Mějte přehled o prostředcích:

• Zobrazení podrobností o clusteru: Zkontrolujte úroveň clusteru, verzi serveru a využití prostředků.

• Správa značek: Uspořádejte clustery pomocí značek, které se synchronizují s webem Azure Portal.