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

Article
10/04/2024

S’APPLIQUE À : NoSQL

Les bases de données dans Azure Cosmos DB sont des unités de gestion pour un ou plusieurs conteneurs. Avant de pouvoir créer ou gérer des conteneurs, vous devez d’abord créer une base de données.

Nommer une base de données

Dans Azure Cosmos DB, une base de données est analogue à un espace de noms. Lorsque vous créez une base de données, le nom de la base de données forme un segment de l’URI utilisé pour accéder à la ressource de base de données et à toutes les ressources enfants.

Une fois créé, l’URI d’une base de données est au format suivant :

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>

Création d'une base de données

Une fois que vous avez créé CosmosClient, utilisez le client pour créer une base de données à partir de deux appels différents :

createIfNotExists : crée une base de données s’il n’en existe pas. S’il en existe une, retourne la base de données.
create : crée une base de données. S’il en existe une, retourne l’erreur statusCode.

const databaseName = 'myDb';

// Possible results:
// Create then return database
// Return existing database
// Return error statusCode
const {statusCode, database } = await client.databases.createIfNotExists({ id: databaseName });

// Possible results: 
// Create then return database
// Return error statusCode, reason includes database already exists
const {statusCode, database } = await client.databases.create({ id: databaseName });

Le statusCode est un code de réponse HTTP. Une réponse positive est comprise entre 200 et 299.

Accéder à une base de données

Une base de données est accessible à partir de l’objet de base de données directement ou via un résultat de requête à partir de CosmosClient.

const databaseName = 'myDb';

// Direct - assumes database already exists
const { database, statusCode } = await client.database(databaseName);

// Query - assumes database already exists   
const { resources } = await client.databases
.query({
    query: `SELECT * FROM root r where r.id =@dbId`,
    parameters: [
    {
        name: '@dbId',
        value: databaseName
    }
    ]
})
.fetchAll();

Accès par objet :

Bases de données (au pluriel) : utilisé pour créer des bases de données, ou interroger ou lire toutes les bases de données.
Base de données (au singulier) : utilisé pour lire, mettre à jour ou supprimer une base de données existante par ID, ou pour accéder aux conteneurs appartenant à cette base de données.

Supprimer une base de données

Une fois que vous avez obtenu l’objet de base de données, vous pouvez utiliser l’objet de base de données pour supprimer la base de données :

const {statusCode } = await database.delete();

Le statusCode est un code de réponse HTTP. Une réponse positive est comprise entre 200 et 299.

Étapes suivantes

Maintenant que vous avez créé une base de données, utilisez le guide suivant pour créer des conteneurs.

Créer un conteneur

Partager via