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

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.

Aqui estão algumas regras rápidas ao nomear uma base de dados:

• Os nomes das bases de dados não devem estar vazios.
• Os nomes das bases de dados não podem ter mais de 256 caracteres.

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

Para criar uma base de dados, chame um dos seguintes métodos:

• CreateDatabaseAsync
• CreateDatabaseIfNotExistsAsync

Criar uma base de dados assíncrona

O exemplo seguinte cria uma base de dados de forma assíncrona:

// New instance of Database class referencing the server-side database
Database database1 = await client.CreateDatabaseAsync(
    id: "adventureworks-1"
);

O CosmosClient.CreateDatabaseAsync método lança uma exceção se já existir uma base de dados com o mesmo nome.

Crie uma base de dados assíncrona se ainda não existir

O exemplo seguinte cria uma base de dados de forma assíncrona apenas se esta não existir já na conta:

// New instance of Database class referencing the server-side database
Database database2 = await client.CreateDatabaseIfNotExistsAsync(
    id: "adventureworks-2"
);

O CosmosClient.CreateDatabaseIfNotExistsAsync método só cria uma nova base de dados se esta ainda não existir. Esse método é útil para evitar erros se você executar o mesmo código várias vezes.

Analisar a resposta

Em todos os exemplos até agora, a resposta do pedido assíncrono foi convertida imediatamente para o tipo Database. Pode querer analisar metadados sobre a resposta, incluindo cabeçalhos e o código de estado HTTP. O verdadeiro tipo de retorno para os métodos CosmosClient.CreateDatabaseAsync e CosmosClient.CreateDatabaseIfNotExistsAsync é DatabaseResponse.

O exemplo seguinte mostra o método CosmosClient.CreateDatabaseIfNotExistsAsync a devolver uma DatabaseResponse. Uma vez devolvido, pode analisar as propriedades da resposta e eventualmente obter o objeto Base de Dados subjacente:

// New instance of Database response class referencing the server-side database
DatabaseResponse response = await client.CreateDatabaseIfNotExistsAsync(
    id: "adventureworks-3"
);
// Parse additional response properties
Database database3 = response.Database;

Próximos passos

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