Vytvoření tabulky ve službě Azure Cosmos DB pro tabulku pomocí .NET
PLATÍ PRO:
Tabulka
Tabulky ve službě Azure Cosmos DB for Table jsou jednotky správy pro více položek. Před vytvořením nebo správou položek musíte nejprve vytvořit tabulku.
Pojmenování tabulky
Ve službě Azure Cosmos DB je tabulka podobná tabulce v relační databázi.
Poznámka
S rozhraním API pro účty table platí, že když vytvoříte první tabulku, ve vašem účtu Azure Cosmos DB se automaticky vytvoří výchozí databáze.
Tady je několik rychlých pravidel při pojmenování tabulky:
- Zachovat názvy tabulek o délce 3 až 63 znaků
- Názvy tabulek můžou obsahovat jenom malá písmena, číslice nebo znak pomlčky (-).
- Názvy tabulek musí začínat malým písmenem nebo číslicí.
Vytvoření tabulky
Chcete-li vytvořit tabulku, zavolejte jednu z následujících metod:
Asynchronní vytvoření tabulky
Následující příklad vytvoří tabulku asynchronně:
// New instance of TableClient class referencing the server-side table
TableClient tableClient1 = client.GetTableClient(
tableName: "adventureworks-1"
);
await tableClient1.CreateAsync();
Metoda TableCient.CreateAsync vyvolá výjimku, pokud již existuje databáze se stejným názvem.
Vytvoření tabulky asynchronně, pokud ještě neexistuje
Následující příklad vytvoří tabulku asynchronně pouze v případě, že ještě v účtu neexistuje:
// New instance of TableClient class referencing the server-side table
TableClient tableClient2 = client.GetTableClient(
tableName: "adventureworks-2"
);
await tableClient2.CreateIfNotExistsAsync();
Metoda TableClient.CreateIfNotExistsAsync vytvoří novou tabulku jenom v případě, že ještě neexistuje. Tato metoda je užitečná k tomu, abyste se vyhnuli chybám, pokud stejný kód spustíte vícekrát.
Další kroky
Teď, když jste vytvořili tabulku, můžete pomocí dalšího průvodce vytvořit položky.