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.
Hier sind einige schnelle Regeln für das Benennen einer Tabelle aufgeführt:
- Verwenden Sie Tabellennamen mit einer Länge zwischen 3 und 63 Zeichen.
- Tabellennamen dürfen nur Kleinbuchstaben, Ziffern oder einen Bindestrich (-) enthalten.
- Tabellennamen müssen mit einem Kleinbuchstaben oder einer Ziffer beginnen.
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.