Sdílet prostřednictvím

Připojení k Azure DocumentDB pomocí webu Azure Portal

MongoDB Shell (mongosh) je prostředí JavaScript a Node.js pro interakci s nasazeními MongoDB. Je to oblíbený nástroj komunity pro testování dotazů a interakci s daty v clusteru Azure DocumentDB. Azure Portal obsahuje několik nástrojů pro dotazování dat MongoDB včetně Azure Cloud Shellu. Azure Cloud Shell je interaktivní a ověřený terminál přístupný z prohlížeče pro správu prostředků Azure. Tento článek vysvětluje, jak se připojit ke clusteru Azure DocumentDB pomocí Prostředí MongoDB v rámci Azure Cloud Shellu.

Požadavky

  • Předplatné Azure

  • Existující cluster Azure DocumentDB

  • Pravidla brány firewall, která klientům ve vašich sítích umožňují připojení ke clusteru. Další informace najdete v tématu konfigurace brány firewall.

  • (Volitelné) Tyto požadavky se vyžadují jenom v případě, že používáte Azure Cloud Shell ve virtuální síti, která je stejná nebo je v partnerském vztahu s Azure DocumentDB.

    • Jedna nebo více existujících virtuálních sítí Azure s podsítěmi pro nasazení Azure Cloud Shell a Azure DocumentDB.

    • Privátní koncový bod pro cluster Azure DocumentDB. Další informace najdete v tématu konfigurace privátního propojení.

    • Azure Cloud Shell nasazený do stejné nebo partnerské virtuální sítě s připojením k privátnímu koncovému bodu Azure DocumentDB. Další informace najdete v tématu Nasazení Cloud Shellu do virtuální sítě.

Povolení přístupu ke clusteru z Azure Cloud Shellu

Nejprve se ujistěte, že Azure Cloud Shell má přístup k vašemu clusteru Azure DocumentDB povolením jeho IP adres v bráně firewall.

  1. Přihlaste se k webu Azure Portal (https://portal.azure.com).

  2. Přejděte do clusteru Azure DocumentDB.

  3. V navigační nabídce vyberte Sítě .

  4. Na stránce Sítě v části Veřejný přístup vyberte možnost + Přidat IP adresy Azure Cloud Shellu , aby se aktuální IP adresa automaticky přidala do seznamu povolených.

  5. Chcete-li použít změny, vyberte Uložit .

Poznámka:

Pokud chcete zajistit připojení, ujistěte se, že jsou povolené konkrétní IP adresy pro vaši oblast. Další informace najdete v tématu IP adresy pro Azure DocumentDB.

Připojení pomocí Azure Cloud Shellu z rychlého startu

Pokud se chcete připojit přímo k Azure DocumentDB pomocí MongoDB Shell, použijte Rychlý start dostupný na stránce prostředku v Azure portálu.

  1. Na stránce prostředků clusteru vyberte v navigační nabídce rychlý start (Preview ).

  2. Pak vyberte Otevřít prostředí MongoDB.

  3. Počkejte, než se spustí prostředí MongoDB.

  4. Jakmile je prostředí připravené, zadejte Y a přijměte oznámení.

    Poznámka:

    Pokud po přijetí oznámení dochází k problému s připojením pomocí Prostředí MongoDB Shell, ujistěte se, že má Azure Cloud Shell přístup k vašemu clusteru.

  5. Teď zadejte heslo pro připojení clusteru ke Cloud Shellu.

Získání přihlašovacích údajů clusteru

Získejte připojovací řetězec, který potřebujete pro připojení k tomuto clusteru.

  1. Přihlaste se k webu Azure Portal (https://portal.azure.com).

  2. Přejděte do existujícího clusteru Azure DocumentDB.

Získejte přihlašovací údaje, které používáte pro připojení ke clusteru.

  1. Na stránce clusteru vyberte v nabídce prostředků možnost Připojovací řetězce .

  2. V části Připojovací řetězce zkopírujte nebo poznamenejte hodnotu z pole Připojovací řetězec .

Snímek obrazovky znázorňující možnost připojovacích řetězců

Důležité

Připojovací řetězec na portálu neobsahuje hodnotu hesla. Zástupný symbol musíte nahradit <password> přihlašovacími údaji, které jste zadali při vytváření clusteru, nebo interaktivně zadat heslo.

Ruční konfigurace Prostředí MongoDB v Azure Cloud Shellu

Nainstalujte klienta MongoDB Shellu (mongosh) do vaší instance Azure Cloud Shellu pomocí Node Package Manageru (npm).

  1. Otevřete Azure Cloud Shell nakonfigurovaný s prostředím skriptování Bash.

  2. Nainstalujte si místně ve svém uživatelském adresáři verzi 1 prostředí MongoDB Shell.

    npm install mongosh@1

  3. Počkejte na dokončení instalace.

  4. Ověřte, že instalace proběhla úspěšně, získáním verze mongosh nástroje.

    npx mongosh --version

Připojení ke clusteru

Připojte se ke clusteru pomocí prostředí MongoDB Shell s připojovacím řetězcem, který neobsahuje heslo. V rámci kroků připojení použijte interaktivní výzvu k zadání hesla.

  1. Připojte se zadáním hesla do příkazového řádku Prostředí MongoDB. V tomto kroku použijte připojovací řetězec bez hesla.

    npx mongosh "mongodb+srv://<username>@<cluster-name>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"

  2. Po zadání hesla a úspěšném ověření se podívejte na upozornění, které se zobrazí.

    ------
   Warning: Non-Genuine MongoDB Detected
   This server or service appears to be an emulation of MongoDB rather than an official MongoDB product.
------

    Návod

    Toto upozornění můžete klidně ignorovat. Toto upozornění se vygeneruje, protože připojovací řetězec obsahuje cosmos.azure. Azure DocumentDB je nativní nabídka platformy Azure jako služby (PaaS).

Provádění testovacích dotazů

Ověřte, že jste úspěšně připojení ke clusteru provedením řady testovacích příkazů a dotazů.

  1. Spuštěním connectionStatus příkazu zkontrolujte stav připojení.

    db.runCommand({connectionStatus: 1})

    {
  ...
  ok: 1
}

  2. Vypište databáze v clusteru.

    show dbs

  3. Přepněte na konkrétní databázi. <database-name> Zástupný symbol nahraďte názvem jakékoli databáze v clusteru.

    use <database-name>

    Návod

    Pokud je inventorynapříklad název databáze , příkaz by byl use inventory.

  4. Vypíše kolekce v databázi.

    show collections

  5. Najděte prvních pět položek v konkrétní kolekci. <collection-name> Zástupný symbol nahraďte názvem libovolné kolekce v clusteru.

    db.<collection-name>.find().limit(5)

    Návod

    Pokud je equipmentnapříklad název kolekce , příkaz by byl db.equipment.find().limit(5).

Související obsah

  • Last updated on