Udostępnij za pośrednictwem


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.