Compartilhar via


Criar uma tabela no Azure Cosmos DB for Table usando .NET

APLICA-SE AO: Table

As tabelas no Azure Cosmos DB for Table são unidades de gerenciamento de vários itens. Para você criar ou gerenciar itens, é preciso criar uma tabela.

Dar um nome a uma tabela

No Azure Cosmos DB, uma tabela é análoga a uma tabela em um banco de dados relacional.

Observação

Nas contas da API for Table, quando você cria a primeira tabela, um banco de dados padrão é criado automaticamente na sua conta do Azure Cosmos DB.

Criar uma tabela

Para criar uma tabela, chame um dos seguintes métodos:

Criar uma tabela de modo assíncrono

O seguinte exemplo cria uma tabela de modo assíncrono:

// New instance of TableClient class referencing the server-side table
TableClient tableClient1 = client.GetTableClient(
    tableName: "adventureworks-1"
);

await tableClient1.CreateAsync();

O método TableCient.CreateAsync lançará uma exceção se um banco de dados com o mesmo nome já existir.

Criar um banco de dados de modo assíncrono se ele não existir

O seguinte exemplo cria uma tabela de modo assíncrono somente se ela ainda não existir na conta:

// New instance of TableClient class referencing the server-side table
TableClient tableClient2 = client.GetTableClient(
    tableName: "adventureworks-2"
);

await tableClient2.CreateIfNotExistsAsync();

O método TableClient.CreateIfNotExistsAsync só criará uma tabela se ainda não houver uma. Esse método é útil para evitar erros se você executar o mesmo código várias vezes.

Próximas etapas

Agora que você criou uma tabela, use o próximo guia para criar itens.