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.