Megosztás a következőn keresztül:

Az Azure Cosmos DB for NoSQL használatának első lépései JavaScript használatával

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Ez a cikk bemutatja, hogyan csatlakozhat az Azure Cosmos DB for NoSQL-hez a JavaScript SDK használatával. A csatlakozás után műveleteket hajthat végre adatbázisokon, tárolókon és elemeken.

Csomag (npm) | API-referencia | kódtár forráskódja | Visszajelzés küldése

Előfeltételek

A helyi projekt beállítása

  1. Hozzon létre egy új könyvtárat a JavaScript-projekthez egy bash shellben.

    mkdir cosmos-db-nosql-javascript-samples && cd ./cosmos-db-nosql-javascript-samples

  2. Hozzon létre egy új JavaScript-alkalmazást a npm init konzolsablonnal rendelkező paranccsal.

    npm init -y

  3. Telepítse a szükséges függőséget az Azure Cosmos DB for NoSQL JavaScript SDK-hoz.

    npm install @azure/cosmos

Csatlakozás az Azure Cosmos DB for NoSQL-hez

Az API-hoz való csatlakozáshoz az Azure Cosmos DB NoSQL-hez hozza létre a CosmosClient osztály egy példányát. Ez az osztály a kiindulópont az adatbázisokon végzett összes művelet végrehajtásához.

Ha a Microsoft Entra használatával szeretne csatlakozni az API for NoSQL-fiókjához, használjon egy biztonsági azonosítót. A fő összetevő pontos típusa attól függ, hogy hol helyezi el az alkalmazás kódját. Az alábbi táblázat rövid útmutatóként szolgál.

Az alkalmazás futtatásának helye Rendszerbiztonsági tag
Helyi gép (fejlesztés és tesztelés) Felhasználói identitás vagy szolgáltatásnév
Azure Felügyelt identitás
Azure-on kívüli kiszolgálók vagy ügyfelek Szolgáltatásnév

Importál @azure/identity

A @azure/identity npm csomag olyan alapvető hitelesítési funkciókat tartalmaz, amelyek az összes Azure SDK-kódtár között megosztva találhatók.

  1. Importálja a @azure/identity npm-csomagot a npm install paranccsal.

    npm install @azure/identity

  2. A kódszerkesztőben adja hozzá a függőségeket.

    const { DefaultAzureCredential } = require("@azure/identity");

CosmosClient létrehozása az alapértelmezett hitelesítő adatok implementálásával

Ha helyi gépen tesztel, vagy az alkalmazás a felügyelt identitások közvetlen támogatásával fog futni az Azure-szolgáltatásokban, szerezze be az OAuth-jogkivonatot egy DefaultAzureCredential példány létrehozásával. Ezután hozzon létre egy új CosmosClient-példányt a COSMOS_ENDPOINT környezeti változóval és a TokenCredential objektummal paraméterként.

const { CosmosClient } = require("@azure/cosmos");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();

const cosmosClient = new CosmosClient({ 
    endpoint, 
    aadCredentials: credential
});

Az alkalmazás összeállítása

Az alkalmazás létrehozásakor a kód elsősorban négy erőforrástípussal fog működni:

  • A NoSQL API-fiók, amely az Azure Cosmos DB adataihoz tartozó egyedi legfelső szintű névtér.

  • Adatbázisok, amelyek rendszerezik a tárolókat a fiókjában.

  • Tárolók, amelyek az adatbázis egyes elemeit tartalmazzák.

  • Elemek, amelyek egy JSON-dokumentumot jelölnek a tárolóban.

Az alábbi ábra az ezen erőforrások közötti kapcsolatot mutatja be.

Az Azure Cosmos DB-hierarchia diagramja, beleértve a fiókokat, adatbázisokat, tárolókat és elemeket.

Minden erőforrástípust egy vagy több társított osztály jelöl. Íme a leggyakoribb osztályok listája:

Osztály Leírás
CosmosClient Ez az osztály ügyféloldali logikai reprezentációt biztosít az Azure Cosmos DB szolgáltatáshoz. Az ügyfélobjektum a szolgáltatással kapcsolatos kérések konfigurálására és végrehajtására szolgál.
Database Ez az osztály egy olyan adatbázisra mutató hivatkozás, amely lehet, hogy létezik, vagy nem létezik a szolgáltatásban. Az adatbázist kiszolgáló oldalon érvényesítik, amikor megkísérli elérni, vagy műveletet hajt végre rajta.
Container Ez az osztály egy olyan tárolóra mutató hivatkozás, amely még nem létezik a szolgáltatásban. A tároló a kiszolgálóoldalon lesz érvényesítve, amikor megpróbálja használni.

Az alábbi útmutatók bemutatják, hogyan használhatja ezeket az osztályokat az alkalmazás létrehozásához.

Útmutató Leírás
Adatbázis létrehozása Adatbázisok létrehozása
Tároló létrehozása Tárolók létrehozása
Elem létrehozása és olvasása Adott elem pontolvasása
Lekérdezési elemek Több elem lekérdezése

Lásd még

Következő lépések

Adatbázis létrehozása az Azure Cosmos DB for NoSQL-ben JavaScript használatával