Crie uma base de dados no Azure Cosmos DB para NoSQL usando JavaScript

As bases de dados no Azure Cosmos DB são unidades de gestão para um ou mais contentores. Antes de poder criar ou gerir contentores, deve primeiro criar uma base de dados.

Nomeie uma base de dados

No Azure Cosmos DB, uma base de dados é análoga a um namespace. Quando cria uma base de dados, o nome dessa base de dados constitui um segmento do URI utilizado para aceder ao recurso da base de dados e a quaisquer recursos descendentes.

Uma vez criado, o URI de uma base de dados está neste formato:

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

Criar uma base de dados

Depois de criar o CosmosClient, use o cliente para criar uma base de dados a partir de duas chamadas diferentes:

• createIfNotExists - Cria uma base de dados se esta não existir. Caso exista, devolver base de dados.
• criar - Cria uma base de dados. Se existir, devolva o código de estado do erro.

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

O statusCode é um código de resposta HTTP. Uma resposta bem-sucedida situa-se na faixa dos 200-299.

Aceder a uma base de dados

Uma base de dados é acedida a partir do objeto Base de Dados , seja diretamente ou através de um resultado de consulta do 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();

Acesso por objeto:

• Bases de Dados (plural): Usadas para criar novas bases de dados ou para consultar/ler todas as bases de dados.
• Base de dados (singular): Usada para ler, atualizar ou eliminar uma base de dados existente por ID ou aceder a contentores pertencentes a essa base de dados.

Excluir um banco de dados

Depois de obteres o objeto Base de Dados , podes usar o objeto Base de Dados para eliminar a base de dados:

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

O statusCode é um código de resposta HTTP. Uma resposta bem-sucedida situa-se na faixa dos 200-299.

Próximos passos

Agora que criou uma base de dados, use o guia seguinte para criar contentores.