Začínáme se službou Azure Cosmos DB for NoSQL pomocí JavaScriptu

2025-04-21

PLATÍ PRO: NoSQL

V tomto článku se dozvíte, jak se připojit ke službě Azure Cosmos DB for NoSQL pomocí sady JavaScript SDK. Po připojení můžete provádět operace s databázemi, kontejnery a položkami.

Balíček (npm) | Referenční informace k API | Zdrojový kód knihovny | Poskytněte zpětnou vazbu

Požadavky

Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Účet Azure Cosmos DB pro NoSQL Vytvořte rozhraní API pro účet NoSQL.
Node.js LTS
Rozhraní příkazového řádku Azure (CLI) nebo Azure PowerShell

Nastavení místního projektu

Vytvořte nový adresář pro projekt JavaScriptu v prostředí bash.

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

Pomocí příkazu se šablonou npm init vytvořte novou javascriptovou aplikaci.
```
npm init -y
```
Nainstalujte potřebné závislosti pro Azure Cosmos DB for NoSQL JavaScript SDK.
```
npm install @azure/cosmos
```

Připojení ke službě Azure Cosmos DB for NoSQL

Pokud se chcete připojit k rozhraní API pro NoSQL služby Azure Cosmos DB, vytvořte instanci CosmosClient třídy. Tato třída je výchozím bodem pro provádění všech operací s databázemi.

Pokud se chcete připojit k účtu API pro NoSQL pomocí Microsoft Entra, použijte zabezpečovací prvek. Přesný typ objektu zabezpečení závisí na tom, kde hostujete kód aplikace. Následující tabulka slouží jako stručná referenční příručka.

Kde aplikace běží	Bezpečnostní entita
Místní počítač (vývoj a testování)	Identita uživatele nebo služební účet
Azurový	Spravovaná identita
Servery nebo klienti mimo Azure	Hlavní služba

Importovat @azure/identity

Balíček npm @azure/identity obsahuje základní funkce ověřování, které se sdílí mezi všemi knihovnami sady Azure SDK.

Importujte balíček npm @azure/identity pomocí npm install příkazu.
```
npm install @azure/identity
```

V editoru kódu přidejte závislosti.

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

Vytvoření CosmosClient s výchozí implementací přihlašovacích údajů

Pokud testujete na místním počítači nebo vaše aplikace bude běžet na službách Azure s přímou podporou spravovaných identit, získejte token OAuth vytvořením DefaultAzureCredential instance. Pak vytvořte novou instanci třídy CosmosClient s COSMOS_ENDPOINT proměnnou prostředí a TokenCredential objekt jako parametry.

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

const credential = new DefaultAzureCredential();

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

Sestavení aplikace

Při vytváření aplikace bude váš kód primárně pracovat se čtyřmi typy prostředků:

Rozhraní API pro účet NoSQL, které představuje jedinečný obor názvů nejvyšší úrovně pro vaše data v Azure Cosmos DB.
Databáze, které uspořádají kontejnery ve vašem účtu.
Kontejnery, které obsahují sadu jednotlivých položek v databázi.
Položky, které představují dokument JSON ve vašem kontejneru.

Na následujícím diagramu jsou vztahy těchto prostředků.

Diagram hierarchie služby Azure Cosmos DB, včetně účtů, databází, kontejnerů a položek

Každý typ prostředku je reprezentován jednou nebo více přidruženými třídami. Tady je seznam nejběžnějších tříd:

Třída	Popis
`CosmosClient`	Tato třída poskytuje logickou reprezentaci na straně klienta pro službu Azure Cosmos DB. Objekt klienta slouží ke konfiguraci a spouštění požadavků na službu.
`Database`	Tato třída je odkazem na databázi, která může nebo nemusí existovat ve službě ještě. Databáze je ověřena na straně serveru, když se pokusíte o přístup k databázi nebo provedete operaci s ní.
`Container`	Tato třída je odkazem na kontejner, který ještě nemusí ve službě existovat. Kontejner se ověří na straně serveru, když se s ním pokusíte pracovat.

Následující příručky vám ukážou, jak pomocí každé z těchto tříd sestavit aplikaci.

Průvodce	Popis
Vytvoření databáze	Vytvoření databází
Vytvoření kontejneru	Vytvořte kontejnery
Vytvoření a přečtení položky	Ukázání na konkrétní položku
Položky dotazu	Dotazování na více položek

Viz také

Další kroky

Vytvoření databáze ve službě Azure Cosmos DB for NoSQL pomocí JavaScriptu

Sdílet prostřednictvím