Azure Cosmos DB-példányok csatlakoztatása és lekérdezése a Visual Studio Code használatával

A KÖVETKEZŐKRE VONATKOZIK: NoSQL MongoDB

A Visual Studio Code egy sokoldalú kódszerkesztő Linuxhoz, macOS-hez és Windowshoz, és számos bővítményt támogat. Ez a rövid útmutató bemutatja, hogyan csatlakozhat a NoSQL-hez készült Azure Cosmos DB-hez és a MongoDB-hez készült Azure Cosmos DB-fürthöz (vCore) a Visual Studio Code használatával. Az alapvető adatbázis-műveletek elvégzésére terjed ki, beleértve az adatok lekérdezését, beszúrását, frissítését és törlését.

Előfeltételek

Mielőtt hozzákezdene, győződjön meg arról, hogy a következők vannak:

• Egy Azure Cosmos DB-fiók, amely a NoSQL API adatbázisával és gyűjteményével van konfigurálva. Az alábbi rövid útmutatók bármelyikével állíthat be erőforrást:

  • Portál
  • Azure CLI

• Ha a Visual Studióban szeretné csatlakoztatni és kezelni az adatokat az Azure Cosmos DB-ben, először telepítse az Azure Databases bővítményt .

  1. Nyissa meg a Visual Studio Code-ot.
  2. A Bővítmények panel eléréséhez válassza > megtekintése lehetőséget, vagy használja a Ctrl + Shift + X billentyűparancsot Windows rendszeren, a Command + Shift + X parancsot MacOS rendszeren.
  3. A keresősávba írja be a DocumentDB for VS Code kifejezést, és válassza ki a bővítményt. Ezután kattintson a Telepítés gombra.
  4. Ha a rendszer kéri, a telepítés után töltse be újra a Visual Studio Code-ot.

Csatlakozás a NoSQL-hez készült Azure Cosmos DB-hez

1. A Visual Studio Code-ban nyissa meg az Azure panelt (válassza az Azure ikont a tevékenységsávon).
2. Jelentkezzen be Azure-fiókjába az Entra-azonosítón keresztül: Megjegyzés: Javasoljuk, hogy mindig a Microsoft Entra ID RBAC-t használja az Azure Cosmos DB-erőforrások elérésekor (fiókkulcsok helyett) a legbiztonságosabb hitelesítési módszerhez.
3. Miután bejelentkezett, az Azure Fa nézetben keresse meg az Azure-előfizetését, és részletezse le az Azure Cosmos DB-t.
4. Válasszon ki egy meglévő fiókot, vagy kattintson a jobb gombbal egy új erőforrás létrehozásához.

Adatok lekérdezése és megjelenítése

A következő lépések a Lekérdezésszerkesztő használatával hajtják végre a lekérdezést, és megtekinthetik a lekérdezés eredményeit:

1. A gyűjtemény menüjében kattintson a jobb gombbal a gyűjteményre a Lekérdezésszerkesztő előnézetben való megnyitásához.

   

2. Futtassa a lekérdezésszerkesztőben megadott lekérdezést az adatok táblanézetben való megjelenítéséhez:

   

3. Az adatok feltárása más támogatott nézetekben:

• JSON-nézet: Tekintse meg a nyers adatstruktúrát.
• Fanézet: Egyszerűen feltárhatja a beágyazott adatokat.

Lekérdezési és indexmetrikák megtekintése

A lekérdezésszerkesztőben további lekérdezési és indexmetrikákat tekinthet meg a lekérdezési teljesítmény jobb optimalizálása érdekében.

1. Válassza a Lekérdezés eredményei melletti Statisztika fület.

2. A metrikadefiníciókkal kapcsolatos további információkért tekintse meg a lekérdezési metrikák dokumentációját.

Dokumentumok beszúrása, szerkesztése és törlése

• Valós idejű dokumentumszerkesztés: Dokumentumok hozzáadása, megtekintése, szerkesztése és törlése azonnal, valós idejű módosításokkal.
• Importálás JSON-ból: Adatok gyors betöltése JSON-fájlokból.

Lekérdezési eredmények exportálása

• Eredmények letöltése: Lekérdezési eredmények letöltése CSV- vagy JSON-fájlokba.

Következő lépések

Ebben az oktatóanyagban megtanulta, hogyan kérdezhet le adatokat a VS Code-ban, hogyan exportálhatja a lekérdezési eredményeket, hogyan tekintheti meg a lekérdezési és indexmetrikákat a lekérdezési teljesítmény finomhangolásához, és hogyan jelenítheti meg az adatokat több támogatott nézetben. Mostantól az Azure Databases VS Code-bővítmény használatával áttekintheti az adatbázisban lévő valós adatokat.

• Ismerkedés a NoSQL API-val
• Node.js rövid útmutató
• Python – gyorsútmutató
• Java – gyorsútmutató
• Rövid útmutató

Előfeltételek

Mielőtt hozzákezdene, győződjön meg arról, hogy a következők vannak:

• Egy Azure Cosmos DB-fiók, amely egy adatbázissal van konfigurálva a MongoDB-hez készült Azure Cosmos DB-ben. Adatbázis beállításához használja az alábbi rövid útmutatókat:
  • Portál
  • Azure CLI
• Az Adatok Azure Cosmos DB-ben való csatlakoztatásához és kezeléséhez telepítenie kell a Visual Studio Code Azure Databases bővítményét.
  1. Nyissa meg a Visual Studio Code-ot.
  2. A Bővítmények panel eléréséhez válassza > megtekintése lehetőséget, vagy használja a Ctrl + Shift + X billentyűparancsot Windows rendszeren, a Command + Shift + X parancsot MacOS rendszeren.
  3. A keresősávba írja be a DocumentDB for VS Code kifejezést, és válassza ki a bővítményt. Ezután kattintson a Telepítés gombra.
  4. Ha a rendszer kéri, a telepítés után töltse be újra a Visual Studio Code-ot.
• Parancssori interakciókhoz telepített MongoDB-rendszerhéj (mongosh) (nem kötelező, de ajánlott).

---

Csatlakozás MongoDB-számítási feladathoz

Csatlakozás a MongoDB-hez készült Azure Cosmos DB-fürthöz

1. Az Azure Databases bővítményben bontsa ki az Azure-erőforrások szakaszt.
2. Keresse meg a MongoDB-számítási feladathoz tartozó előfizetést . A kívánt előfizetés alatt láthatja az Azure Cosmos DB for MongoDB (vCore) ágat. Bontsa ki az ágat a fürtök és adatbázisok megtekintéséhez.
3. Válassza ki az Azure Cosmos DB for MongoDB (vCore) fürtöt a kibontott listából.
4. Amikor a rendszer kéri, adja meg a fürt rendszergazdai jelszavát.
5. A hitelesítés után hozzáférést kap a fürthöz.

Feljegyzés

A jelszó csak hitelesítéshez használatos, és nincs tárolva.

Feljegyzés

Számos vállalati környezetben a fejlesztői gép IP-címei vpn vagy más vállalati hálózati beállítások miatt rejtve vannak. Ezekben az esetekben javasoljuk, hogy az engedélyezési lista finomítása előtt először a 0.0.0.0 – 255.255.255.255 tűzfalszabály hozzáadásával engedélyezze az összes IP-cím elérését.

Csatlakozás bármely MongoDB-fürthöz

1. A Munkaterület panelen bontsa ki a MongoDB-fiókok szakaszt.
2. Itt megtekintheti az összes MongoDB-fiókját. Ha új MongoDB-fiókhoz szeretne csatlakozni egy kapcsolati sztring használatával, kattintson az Új kapcsolat gombra, és adja meg a kapcsolati sztring, amikor a rendszer kéri.
   • Szükség esetén előfordulhat, hogy meg kell adnia a felhasználónevet és a jelszót a hitelesítéshez.

Feljegyzés

A sikeresen csatlakoztatott MongoDB-fürtök a VS Code bezárása után is megjelennek a MongoDB-fiókok szakaszban.

Intuitív adatkezelés

Az adatbázisok egyszerűen kezelhetők a Visual Studio Code-on belül:

• Adatbázisok/gyűjtemények létrehozása és elvetése: Az erőforráspanelen kattintson a jobb gombbal a fiókjára, adatbázisára vagy gyűjteményére adatbázisok és gyűjtemények létrehozásához vagy törléséhez.

• Importálás JSON-ból: Adatok gyors importálása JSON-fájlokból a gyűjteménybe.

  • Importálás kezdeményezése
    1. Kattintson a jobb gombbal a gyűjtemény nevére az erőforrásnézetben, és válassza a Dokumentumok importálása gyűjteménybe lehetőséget.
    2. Másik lehetőségként nyissa meg a Gyűjtemény nézetet a gyűjtemény Dokumentumok bejegyzésére kattintva, majd kattintson az Importálás gombra.
  • JSON-fájl kiválasztása
    1. Keresse meg az adatokat tartalmazó *.json fájlt.
    2. Győződjön meg arról, hogy elindítja az importálási folyamatot.

• Adatok exportálása: Gyűjtemények vagy lekérdezési eredmények mentése JSON-ként biztonsági mentéshez vagy megosztáshoz.

  • Exportálás kezdeményezése:
    • 1\. lehetőség
      1. Kattintson a jobb gombbal a gyűjtemény nevére az erőforrásnézetben, és válassza a Dokumentumok exportálása gyűjteményből lehetőséget a teljes gyűjtemény exportálásához.
    • 2\. lehetőség
      1. Nyissa meg a Gyűjtemény nézetet a gyűjtemény Dokumentumok bejegyzésére kattintva, majd kattintson az Exportálás gombra.
      2. Válassza a teljes gyűjtemény vagy az aktuális lekérdezés eredményeinek exportálását.
  • Célfájl megadása:
    1. Adja meg a cél *.json fájl nevét és helyét.
    2. Erősítse meg az exportálást az adatok mentésének megkezdéséhez.

• Valós idejű dokumentumszerkesztés: Valós idejű frissítésekkel azonnal hozzáadhat, megtekinthet, szerkeszthet és törölhet dokumentumokat.

  • Dokumentumszerkesztés megnyitása:
    • Közvetlenül a Gyűjtemény nézeten belül érheti el a dokumentumszerkesztési beállításokat. Ezek a vezérlők kényelmesen találhatók az adatnézet felett a könnyű hozzáférés érdekében.
  • Elérhető műveletek:
    • Hozzáadás: Új dokumentumok létrehozása a gyűjteményben.
    • Nézet: A kijelölt dokumentum tartalmának megtekintése.
    • Szerkesztés: A kijelölt dokumentumok tartalmának szerkesztése.
    • Törlés: A kijelölt dokumentumok eltávolítása azonnal megjelenő módosításokkal.

Hatékony lekérdezési eszközök

A lekérdezések zökkenőmentes futtatása és finomítása:

• Azonnali eredmények: Azonnal megtekintheti a lekérdezési eredményeket a kívánt formátumban – Tábla, JSON vagy Fa nézetben.

  • A Nézet legördülő menüvel egyszerűen válthat nézeteket.

• Lekérdezések közvetlen végrehajtása: MongoDB-lekérdezések írása és végrehajtása olyan funkciókkal, mint a szintaxiskiemelés és az automatikus kiegészítés.

  • A lekérdezés futtatásához kattintson a Lekérdezés keresése gombra, vagy nyomja le Ctrl/Cmd+Enter a lekérdezésszerkesztőben.

Feljegyzés

Jelenleg csak a keresési szűrő lekérdezések támogatottak, és hamarosan bővülnek a lekérdezési képességek.

Rugalmas adatnézetek

Több nézetet használva vizsgálhatja meg az adatokat különböző perspektívákhoz:

• JSON-nézet: Tekintse meg a nyers JSON-adatstruktúrát.

• Fanézet: Könnyedén navigálhat és vizsgálhat meg beágyazott adatokat.

• Táblázatnézet: Gyorsan beolvassa az adatokat, és részletezi a beágyazott dokumentumokat.

  • Részletezés: Beágyazott objektumokat jelző, ikonnal ellátott {} bejegyzések keresése. Kattintson duplán a tartalom kibontásához és megtekintéséhez.
  • Visszalépés: A Táblázat nézet alatti navigációs szélességekkel térjen vissza a korábbi szintekre.

Mongo Shell-integráció

Parancssori funkciók érhetők el:

• Indítás mongosh: Speciális MongoDB-parancsok végrehajtása közvetlenül a Visual Studio Code-ból.

Feljegyzés

A MongoDB-rendszerhéj (mongosh) nem része a bővítménynek. Külön kell telepíteni, és manuálisan kell konfigurálni.

Fürtkezelés

Maradjon az erőforrások tetején:

• Fürt részleteinek megtekintése: Ellenőrizze a fürt szintjét, a kiszolgáló verzióját és az erőforrás-használatot.

• Címkék kezelése: A fürtök rendszerezése az Azure Portallal szinkronizált címkékkel.

Következő lépések

MongoDB-számítási feladat migrálása az Azure Cosmos DB-be