Sdílet prostřednictvím

Připojení k Azure DocumentDB pomocí MongoDB Shell

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. Tento článek vysvětluje, jak se připojit ke clusteru Azure DocumentDB pomocí MongoDB Shell.

Požadavky

  • Předplatné Azure

  • Existující cluster Azure DocumentDB

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.

Připojení pomocí interaktivního ověřování hesla

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. Otevřete terminál.

  2. 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.

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

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

    This server or service appears to be an emulation of MongoDB.

    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).

  4. Ukončete kontext prostředí.

Připojení pomocí připojovacího řetězce a hesla

Teď se připojte ke clusteru z prostředí MongoDB Shell pomocí připojovacího řetězce a parametrů, které obsahují heslo.

  1. Připojte se pomocí připojovacího řetězce a argumentů --username a --password.

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

  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