Partilhar via

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

  • Artigo

APLICA-SE A: Tabela

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.

Nota

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.

Aqui estão algumas regras rápidas ao nomear uma tabela:

  • Manter nomes de tabelas entre 3 e 63 caracteres
  • Os nomes das tabelas só podem conter letras minúsculas, números ou o caractere traço (-).
  • Os nomes das tabelas devem começar com uma letra ou número minúsculo.

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.

Próximos passos

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

Criar um item