Criar um banco de dados no Azure Cosmos DB para NoSQL usando JavaScript

Artigo
10/04/2024

APLICA-SE A: NoSQL

Os bancos de dados no Azure Cosmos DB são unidades de gerenciamento para um ou mais contêineres. Antes de criar ou gerenciar contêineres, você deve primeiro criar um banco de dados.

Nomear um banco de dados

No Azure Cosmos DB, um banco de dados é análogo a um namespace. Quando você cria um banco de dados, o nome do banco de dados forma um segmento do URI usado para acessar o recurso de banco de dados e quaisquer recursos filho.

Uma vez criado, o URI de um banco 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 um banco de dados a partir de duas chamadas diferentes:

createIfNotExists - Cria um banco de dados se ele não existir. Se existir, retorne o banco de dados.
create - Cria um banco de dados. Se existir, retorne o erro 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 });

O statusCode é um código de resposta HTTP. Uma resposta bem-sucedida está na faixa de 200-299.

Aceder a uma base de dados

Um banco de dados é acessado a partir do objeto Database diretamente ou por meio 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): Utilizadas para criar novas bases de dados ou consultar/ler todas as bases de dados.
Banco de dados (singular): usado para ler, atualizar ou excluir um banco de dados existente por ID ou acessar contêineres pertencentes a esse banco de dados.

Eliminar uma base de dados

Depois de obter o objeto Database , você pode usar o objeto Database para excluir o banco de dados:

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

O statusCode é um código de resposta HTTP. Uma resposta bem-sucedida está na faixa de 200-299.

Próximos passos

Agora que você criou um banco de dados, use o próximo guia para criar contêineres.

Criar um contêiner

Partilhar via