Tworzenie tabeli w usłudze Azure Cosmos DB dla tabel przy użyciu platformy .NET
DOTYCZY: Stół
Tabele w usłudze Azure Cosmos DB dla tabel to jednostki zarządzania dla wielu elementów. Przed utworzeniem elementów lub zarządzanie nimi należy najpierw utworzyć tabelę.
Nazwij tabelę
W usłudze Azure Cosmos DB tabela jest analogiczna do tabeli w relacyjnej bazie danych.
Uwaga
Przy użyciu interfejsu API dla kont tabel podczas tworzenia pierwszej tabeli domyślna baza danych jest automatycznie tworzona na koncie usługi Azure Cosmos DB.
Utwórz tabelę
Aby utworzyć tabelę, wywołaj jedną z następujących metod:
Tworzenie tabeli asynchronicznie
Poniższy przykład tworzy tabelę asynchronicznie:
// New instance of TableClient class referencing the server-side table
TableClient tableClient1 = client.GetTableClient(
tableName: "adventureworks-1"
);
await tableClient1.CreateAsync();
Metoda TableCient.CreateAsync
zgłosi wyjątek, jeśli baza danych o tej samej nazwie już istnieje.
Utwórz tabelę asynchronicznie, jeśli jeszcze nie istnieje
Poniższy przykład tworzy tabelę asynchronicznie tylko wtedy, gdy jeszcze nie istnieje na koncie:
// New instance of TableClient class referencing the server-side table
TableClient tableClient2 = client.GetTableClient(
tableName: "adventureworks-2"
);
await tableClient2.CreateIfNotExistsAsync();
Metoda TableClient.CreateIfNotExistsAsync
utworzy nową tabelę tylko wtedy, gdy jeszcze nie istnieje. Ta metoda jest przydatna do unikania błędów w przypadku wielokrotnego uruchamiania tego samego kodu.
Następne kroki
Po utworzeniu tabeli użyj następnego przewodnika, aby utworzyć elementy.