.NET を使用して Azure Cosmos DB for Table のテーブルを作成する

  • [アーティクル]

適用対象: Table

Azure Cosmos DB for Table のテーブルは、複数の項目の管理単位です。 項目を作成または管理するには、まずテーブルを作成する必要があります。

テーブルに名前を付ける

Azure Cosmos DB では、テーブルはリレーショナル データベースのテーブルに似ています。

Note

Table 用 API アカウントでは、最初のテーブルを作成すると、自分の Azure Cosmos DB アカウント内に既定のデータベースが自動的に作成されます。

テーブルの作成

テーブルを作成するには、次のいずれかのメソッドを呼び出します。

テーブルを非同期的に作成する

次の例では、テーブルを非同期的に作成します。

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

await tableClient1.CreateAsync();

同じ名前のデータベースが既に存在する場合は、TableCient.CreateAsync メソッドは例外をスローします。

テーブルがまだ存在しない場合は、非同期で作成します

次の例では、テーブルがアカウントにまだ存在しない場合にのみ、非同期的にテーブルを作成します。

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

await tableClient2.CreateIfNotExistsAsync();

TableClient.CreateIfNotExistsAsync メソッドは、テーブルがまだ存在しない場合にのみ、新しいテーブルを作成します。 このメソッドは、同じコードを複数回実行する場合にエラーを回避するのに役立ちます。

次のステップ

テーブルを作成したので、次のガイドを使用して項目を作成します。

項目の作成