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

Importante

Você está procurando uma solução de banco de dados para cenários de alta escala com um contrato de nível de serviço (SLA) de disponibilidade de 99.999%, dimensionamento automático instantâneo e failover automático em várias regiões? Considere Azure Cosmos DB para NoSQL.

As tabelas no Azure Cosmos DB for Table são unidades de gerenciamento para vários itens. Antes de criar ou gerenciar itens, você deve primeiro criar uma tabela.

Nomear uma tabela

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

Observação

Com a API para contas de tabela, quando você cria sua primeira tabela, um banco de dados padrão é criado automaticamente em sua conta do Azure Cosmos DB.

Criar uma tabela

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

Criar uma tabela de forma assíncrona

O exemplo a seguir cria uma tabela de forma assíncrona:

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

await tableClient1.CreateAsync();

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

Criar uma tabela de forma assíncrona, se ela ainda não existir

O exemplo a seguir cria uma tabela de forma assíncrona 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 TableClient.CreateIfNotExistsAsync método só criará uma nova tabela se ela ainda não existir. Esse método é útil para evitar erros se você executar o mesmo código várias vezes.

Passos seguintes

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