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

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éer 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’existe pas. S’il existe, retournez la base de données.
• create - Crée une base de données. S’il existe, retournez le code d’état d’erreur.

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 });

StatusCode est un code de réponse HTTP. Une réponse réussie se trouve dans la plage 200-299.

Accéder à une base de données

Une base de données est accessible à partir de l’objet 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 (plural) : utilisées pour créer de nouvelles bases de données, ou interroger/lire toutes les bases de données.
• Base de données (singular) : utilisée pour lire, mettre à jour ou supprimer une base de données existante par ID ou accès aux conteneurs appartenant à cette base de données.

Supprimer une base de données

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

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

StatusCode est un code de réponse HTTP. Une réponse réussie se trouve dans la plage 200-299.

Étapes suivantes

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