Creare un database NoSQL in Azure Cosmos DB utilizzando JavaScript

I database in Azure Cosmos DB sono unità di gestione per uno o più contenitori. Prima di poter creare o gestire i contenitori, è necessario creare un database.

Dare un nome a un database

In Azure Cosmos DB un database è analogo a uno spazio dei nomi. Quando si crea un database, il nome del database costituisce un segmento dell'URI usato per accedere alla risorsa di database e alle risorse figlio.

Dopo la creazione, l'URI per un database è in questo formato:

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

Creazione di un database

Dopo aver creato CosmosClient, usare il client per creare un database da due chiamate diverse:

• createIfNotExists : crea un database se non esiste. Se esiste, restituisci il database.
• create : crea un database. Se esiste, restituisce statusCode di errore.

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 è un codice di risposta HTTP. Una risposta con esito positivo è nell'intervallo 200-299.

Accedere a un database

È possibile accedere a un database dall'oggetto Database direttamente o tramite un risultato della query da 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();

Accesso per oggetto:

• Database (plurale): usato per la creazione di nuovi database o l'esecuzione di query o la lettura di tutti i database.
• Database (singolare): usato per la lettura, l'aggiornamento o l'eliminazione di un database esistente in base all'ID o all'accesso ai contenitori appartenenti a tale database.

Eliminare un database

Dopo aver visualizzato l'oggetto Database , è possibile utilizzare l'oggetto Database per eliminare il database:

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

StatusCode è un codice di risposta HTTP. Una risposta con esito positivo è nell'intervallo 200-299.

Passaggi successivi

Dopo aver creato un database, usare la guida successiva per creare contenitori.

Creare un contenitore