Aan de slag met Azure Cosmos DB for NoSQL met behulp van JavaScript

Artikel
10/02/2024

VAN TOEPASSING OP: NoSQL

In dit artikel leest u hoe u verbinding maakt met Azure Cosmos DB for NoSQL met behulp van de JavaScript SDK. Zodra u verbinding hebt gemaakt, kunt u bewerkingen uitvoeren op databases, containers en items.

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

Vereisten

Een Azure-account met een actief abonnement. Gratis een account maken
Azure Cosmos DB for NoSQL-account. Maak een API voor een NoSQL-account.
Node.js LTS
Azure-opdrachtregelinterface (CLI) of Azure PowerShell

Uw lokale project instellen

Maak een nieuwe map voor uw JavaScript-project in een bash-shell.

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

Maak een nieuwe JavaScript-toepassing met behulp van de npm init opdracht met de consolesjabloon .
```
npm init -y
```
Installeer de vereiste afhankelijkheid voor de Azure Cosmos DB for NoSQL JavaScript SDK.
```
npm install @azure/cosmos
```

Verbinding maken met Azure Cosmos DB for NoSQL

Als u verbinding wilt maken met de API voor NoSQL van Azure Cosmos DB, maakt u een exemplaar van de CosmosClient klasse. Deze klasse is het startpunt om alle bewerkingen uit te voeren op databases.

Als u verbinding wilt maken met uw API voor NoSQL-account met behulp van Microsoft Entra, gebruikt u een beveiligingsprincipaal. Het exacte type principal is afhankelijk van waar u uw toepassingscode host. De onderstaande tabel fungeert als een snelzoekgids.

Waar de toepassing wordt uitgevoerd	Beveiligingsprincipal
Lokale machine (ontwikkelen en testen)	Gebruikersidentiteit of service-principal
Azure	Beheerde identiteit
Servers of clients buiten Azure	Service-principal

Importeren @azure/identity

Het npm-pakket @azure/identity bevat kernverificatiefunctionaliteit die wordt gedeeld tussen alle Azure SDK-bibliotheken.

Importeer het npm-pakket @azure/identity met behulp van de npm install opdracht.
```
npm install @azure/identity
```

Voeg in de code-editor de afhankelijkheden toe.

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

CosmosClient maken met standaardreferentie-implementatie

Als u test op een lokale computer of uw toepassing wordt uitgevoerd op Azure-services met directe ondersteuning voor beheerde identiteiten, moet u een OAuth-token verkrijgen door een DefaultAzureCredential exemplaar te maken. Maak vervolgens een nieuw exemplaar van de CosmosClient-klasse met de COSMOS_ENDPOINT omgevingsvariabele en het TokenCredential-object als parameters.

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

const credential = new DefaultAzureCredential();

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

Uw toepassing bouwen

Tijdens het bouwen van uw toepassing werkt uw code voornamelijk met vier typen resources:

De API voor NoSQL-account, de unieke naamruimte op het hoogste niveau voor uw Azure Cosmos DB-gegevens.
Databases, die de containers in uw account organiseren.
Containers, die een set afzonderlijke items in uw database bevatten.
Items, die een JSON-document in uw container vertegenwoordigen.

Het volgende diagram geeft de relatie tussen deze resources weer.

Diagram van de Azure Cosmos DB-hiërarchie, waaronder accounts, databases, containers en items.

Elk type resource wordt vertegenwoordigd door een of meer gekoppelde klassen. Hier volgt een lijst met de meest voorkomende klassen:

Klas	Beschrijving
`CosmosClient`	Deze klasse biedt een logische weergave aan de clientzijde voor de Azure Cosmos DB-service. Het clientobject wordt gebruikt om aanvragen aan de service te configureren en uitvoeren.
`Database`	Deze klasse is een verwijzing naar een database die al dan niet bestaat in de service. De database wordt gevalideerd aan de serverzijde wanneer u deze probeert te openen of een bewerking uitvoert.
`Container`	Deze klasse is een verwijzing naar een container die mogelijk nog niet bestaat in de service. De container wordt gevalideerd aan de serverzijde wanneer u ermee probeert te werken.

In de volgende handleidingen ziet u hoe u elk van deze klassen gebruikt om uw toepassing te bouwen.

Guide	Beschrijving
Een database maken	Databases maken
Een container maken	Maak containers
Een item maken en lezen	Een specifiek item lezen
Query's uitvoeren op items	Query's uitvoeren op meerdere items

Zie ook

Volgende stappen

Een database maken in Azure Cosmos DB for NoSQL met behulp van JavaScript

Delen via