Bien démarrer avec Azure Cosmos DB for NoSQL à l’aide de Javascript

Article
10/04/2024

S’APPLIQUE À : NoSQL

Cet article vous montre comment vous connecter à Azure Cosmos DB for NoSQL à l’aide du SDK JavaScript. Une fois connecté, vous pouvez effectuer des opérations sur des bases de données, des conteneurs et des éléments.

Package (npm) | Exemples | Référence API | Code source de la bibliothèque | Envoyer des commentaires

Prérequis

Compte Azure avec un abonnement actif. Créez un compte gratuitement.
Compte Azure Cosmos DB for NoSQL. Créer une API pour un compte NoSQL.
Node.js LTS
Interface de ligne de commande (CLI) Azure ou Azure PowerShell

Configurez votre projet local

Créez un répertoire pour votre projet JavaScript dans un interpréteur de commandes bash.
```
mkdir cosmos-db-nosql-javascript-samples && cd ./cosmos-db-nosql-javascript-samples
```
Créez une application JavaScript à l’aide de la commande npm init avec le modèle de console.
```
npm init -y
```
Installez la dépendance requise pour le Kit de développement logiciel (SDK) JavaScript Azure Cosmos DB for NoSQL.
```
npm install @azure/cosmos
```

Se connecter à Azure Cosmos DB for NoSQL

Pour vous connecter à l’API pour NoSQL de Azure Cosmos DB, créez une instance de la classe CosmosClient. Cette classe est le point de départ pour effectuer toutes les opérations sur des bases de données.

Pour vous connecter à votre compte API pour NoSQL à l’aide de Microsoft Entra, utilisez un principal de sécurité. Le type exact de principal dépend de l’emplacement où vous hébergez votre code d’application. Le tableau ci-dessous sert de guide de référence rapide.

Emplacement d’exécution de l’application	Principal de sécurité
Ordinateur local (développement et test)	Identité de l’utilisateur ou principal du service
Azure	Identité managée
Serveurs ou clients en dehors d’Azure	Principal du service

Importez @azure/identity

Le package npm @azure/identity contient les fonctionnalités d’authentification principales partagées entre toutes les bibliothèques du kit de développement logiciel (SDK) Azure.

Importez le package npm @azure/identity à l’aide de la commande npm install.
```
npm install @azure/identity
```

Dans votre éditeur de code, ajoutez les dépendances.

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

Créer CosmosClient avec l’implémentation des informations d’identification par défaut

Si vous testez sur une machine locale ou que votre application s’exécute sur des services Azure avec prise en charge directe des identités managées, obtenez un jeton OAuth en créant une instance DefaultAzureCredential. Puis créez une instance de la classe CosmosClient avec la variable d’environnement COSMOS_ENDPOINT et l’objet TokenCredential en tant que paramètres.

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

const credential = new DefaultAzureCredential();

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

Générer votre application

À mesure que vous générez votre application, votre code interagit principalement avec quatre types de ressources :

Le compte d’API for NoSQL qui est l’unique espace de noms de niveau supérieur pour vos données Azure Cosmos DB.
Bases de données, qui organisent les conteneurs dans votre compte.
Conteneurs, qui contiennent un ensemble d’éléments individuels dans votre base de données.
Éléments, qui représentent un document JSON dans votre conteneur.

Le diagramme suivant montre la relation entre ces ressources.

Diagramme de la hiérarchie d’Azure Cosmos DB comprenant les comptes, les bases de données, les conteneurs et les éléments.

Chaque type de ressource est représenté par une ou plusieurs classes associées. Voici une liste des classes les plus courantes :

Classe	Description
`CosmosClient`	Cette classe fournit une représentation logique du côté client pour le service Azure Cosmos DB. Ce client est utilisé pour configurer et exécuter des requêtes sur le service.
`Database`	Cette classe est une référence à une base de données qui peut, ou non, exister dans le service. La base de données est validée côté serveur lorsque vous tentez d’y accéder ou d’effectuer une opération sur celle-ci.
`Container`	Cette classe est une référence à un conteneur qui n’existe pas encore dans le service. Le conteneur est validé côté serveur lorsque vous tentez de l’utiliser.

Les guides suivants vous montrent comment utiliser chacune de ces classes pour générer votre application.

Guide	Description
Créer une base de données	Créer des bases de données
Créer un conteneur	Créer des conteneurs
Créer et lire un élément	Pointer et lire un élément spécifique
Éléments de requête	Interroger plusieurs éléments

Voir aussi

Étapes suivantes

Créer une base de données dans Azure Cosmos DB for NoSQL à l’aide de JavaScript

Partager via