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

  • Cikk

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.

Package (npm) | Samples | API reference | Library source code | Give Feedback

Előfeltételek

A helyi projekt beállítása

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

    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 Azure Cosmos DB NoSQL-hez készült API-hoz való csatlakozáshoz hozza létre az osztály egy példányát CosmosClient . 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 tagot. Az egyszerűség pontos típusa attól függ, hogy hol tárolja 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:

  • Az API for NoSQL-fiók, amely az Azure Cosmos DB-adatok egyedi legfelső szintű névtere.

  • 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 még létezik a szolgáltatásban. Az adatbázis kiszolgálóoldali érvényesítve van, amikor megpróbálja 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ó kiszolgálóoldali érvényesítve lesz, amikor megpróbál dolgozni vele.

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ására
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