Csatlakozás az Azure DocumentDB-hez a MongoDB Shell használatával

A MongoDB Shell (mongosh) egy JavaScript- és Node.js-környezet a MongoDB üzemelő példányaival való interakcióhoz. Ez egy népszerű közösségi eszköz a lekérdezések teszteléséhez és az Azure DocumentDB-fürt adatainak kezeléséhez. Ez a cikk bemutatja, hogyan csatlakozhat egy Azure DocumentDB-fürthöz a MongoDB Shell használatával.

Előfeltételek

• Azure-előfizetés

  • Ha nem rendelkezik Azure-előfizetéssel, hozzon létre egy ingyenes fiókot

• Meglévő Azure DocumentDB-fürt

  • Ha nincs klasztere, hozzon létre egy új klasztert

• MongoDB Shell. További információ: MongoDB-rendszerhéj telepítése

• Tűzfalszabályok, amelyek lehetővé teszik az ügyfél számára a fürthöz való csatlakozást. További információ: tűzfal konfigurálása.

Szerezze be a fürt hitelesítő adatait

Kérje le a fürthöz való csatlakozáshoz szükséges kapcsolati karakterláncot.

1. Jelentkezzen be az Azure Portalra (https://portal.azure.com).

2. Navigáljon a meglévő Azure DocumentDB klaszterre.

Szerezd be a fürthöz való csatlakozáshoz használt hitelesítő adatokat.

1. A fürtoldalon válassza a Kapcsolati láncokat lehetőséget az erőforrás menüjében.

2. A Kapcsolati sztringek szakaszban másolja vagy rögzítse a Kapcsolati sztring mező értékét.

Fontos

A portál kapcsolati sztringje nem tartalmazza a jelszó értékét. A <password> helyettesítő szöveget le kell cserélnie a fürt létrehozásakor megadott hitelesítő adatokkal, vagy interaktívan be kell írnia a jelszót.

Csatlakozás interaktív jelszóhitelesítéssel

Csatlakozzon a klaszterhez a MongoDB Shell használatával egy olyan csatlakozási karakterlánccal, amely nem tartalmaz jelszót. Az interaktív jelszókéréssel adja meg a jelszót a csatlakozási lépések részeként.

1. Nyisson meg egy terminált.

2. Csatlakozzon a MongoDB Shell parancssorában található jelszó megadásával. Ehhez a lépéshez használjon jelszó nélküli kapcsolati sztringet.

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

3. A jelszó megadása és a sikeres hitelesítés után figyelje meg a megjelenő figyelmeztetést

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

   Jótanács

   Az üzenet biztonságosan figyelmen kívül hagyható – Ez a figyelmeztetés azért jön létre, mert a kapcsolati sztring tartalmaz cosmos.azure. Az Azure DocumentDB egy natív Azure-platform szolgáltatásként (PaaS).

4. Lépjen ki a rendszerhéj-környezetből.

Csatlakozás kapcsolati sztringgel és jelszóval

Csatlakozzon most a klaszterhez a MongoDB Shellből egy, a jelszót is tartalmazó kapcsolati sztringgel és paraméterekkel.

1. Csatlakozzon kapcsolati sztring és a --username és --password argumentumok használatával.

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

2. A jelszó megadása és a sikeres hitelesítés után figyelje meg a megjelenő figyelmeztetést.

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

   Jótanács

   Az üzenet biztonságosan figyelmen kívül hagyható – Ez a figyelmeztetés azért jön létre, mert a kapcsolati sztring tartalmaz cosmos.azure. Az Azure DocumentDB egy natív Azure-platform szolgáltatásként (PaaS).

Teszt lekérdezések végrehajtása

Tesztparancsok és lekérdezések sorozatával ellenőrizze, hogy sikeresen csatlakozott-e a klaszterhez.

1. Ellenőrizze a kapcsolat állapotát a connectionStatus parancs futtatásával.

   db.runCommand({connectionStatus: 1})
   

   {
     ...
     ok: 1
   }
   

2. Listázhatja a fürtön lévő adatbázisokat.

   show dbs
   

3. Váltás egy adott adatbázisra. Cserélje le a <database-name> helyőrzőt a fürtben levő bármely adatbázisának nevére.

   use <database-name>
   

   Jótanács

   Ha például az adatbázis neve , inventoryakkor a parancs az lesz use inventory.

4. Az adatbázison belüli gyűjtemények listázása.

   show collections
   

5. Keresse meg az első öt elemet egy adott gyűjteményben. Cserélje le a <collection-name> helyőrzőt bármely gyűjtemény nevére a fürtben.

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

   Jótanács

   Ha például a gyűjtemény neve , equipmentakkor a parancs az lenne db.equipment.find().limit(5).

Kapcsolódó tartalom

• Csatlakozás az Azure Cloud Shell használatával
• Tűzfal konfigurálása
• Áttelepítési lehetőségek