Freigeben über


Erstellen einer Tabelle in Azure Cosmos DB for Table mithilfe von .NET

GILT FÜR: Tabelle

Tabellen in Azure Cosmos DB for Table sind Verwaltungseinheiten für mehrere Elemente. Bevor Sie Elemente erstellen oder verwalten können, müssen Sie zunächst eine Tabelle erstellen.

Benennen einer Tabelle

In Azure Cosmos DB verhält sich eine Tabelle wie eine Tabelle in einer relationalen Datenbank.

Hinweis

Wenn Sie in Verbindung mit „API für Table“-Konten die erste Tabelle erstellen, wird in Ihrem Azure Cosmos DB-Konto automatisch eine Standarddatenbank erstellt.

Erstellen einer Tabelle

Rufen Sie zum Erstellen einer Tabelle eine der folgenden Methoden auf:

Asynchrones Erstellen einer Tabelle

Im folgenden Beispiel wird eine Tabelle asynchron erstellt:

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

await tableClient1.CreateAsync();

Die TableCient.CreateAsync-Methode wirft eine Ausnahme aus, wenn eine Datenbank mit demselben Namen bereits vorhanden ist.

Asynchrones Erstellen einer Tabelle, falls sie noch nicht vorhanden ist

Im folgenden Beispiel wird eine Tabelle asynchron erstellt, falls sie nicht bereits im Konto vorhanden ist:

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

await tableClient2.CreateIfNotExistsAsync();

Die Methode TableClient.CreateIfNotExistsAsync erstellt nur dann eine neue Tabelle, wenn sie noch nicht existiert. Diese Methode ist nützlich, um Fehler zu vermeiden, wenn Sie denselben Code mehrmals ausführen.

Nächste Schritte

Nachdem Sie eine Tabelle erstellt haben, können Sie anhand der nächsten Anleitung Elemente erstellen.