Azure Cosmos DB for Apache Cassandra でコンテナーを作成する

適用対象: Cassandra

この記事では、Azure Cosmos DB for Apache Cassandra でコンテナーを作成するさまざまな方法について説明します。 Azure portal、Azure CLI、PowerShell、またはサポートされている SDK を使用して、コンテナーを作成する方法が示されます。 この記事では、コンテナーを作成してパーティション キーを指定し、スループットをプロビジョニングする方法を紹介します。

この記事では、Azure Cosmos DB for Apache Cassandra でコンテナーを作成するさまざまな方法について説明します。 異なる API を使っている場合、コンテナーの作成については、MongoDB 用 API、Gremlin 用 API、Table 用 API、NoSQL 用 API の記事を参照してください。

Note

コンテナーを作成するときは、同じ名前で大文字と小文字が異なる 2 つのコンテナーを作成しないようにしてください。 これは、Azure プラットフォームの一部で大文字と小文字が区別されないため、このような名前のコンテナーでテレメトリとアクションの混同や衝突が発生する可能性があるためです。

Azure portal を使用した作成

1. Azure portal にサインインします。

2. 新しい Azure Cosmos DB アカウントを作成するか、既存のアカウントを選びます。

3. [データ エクスプローラー] ウィンドウを開いて [新しいテーブル] を選択します。 次に、以下の詳細を指定します。

   • 新しいキースペースを作成するか、既存のキースペースを使用するかを指定します。
   • テーブルの名前を入力します。
   • プロパティを入力し、主キーを指定します。
   • プロビジョニングするスループットを入力します (例: 1,000 RU)。
   • [OK] を選択します。

   

注意

Cassandra 用 API では、主キーがパーティション キーとして使われます。

.NET SDK を使用して作成する

// Create a Cassandra table with a partition/primary key and provision 1000 RU/s throughput.
session.Execute(CREATE TABLE myKeySpace.myTable(
    user_id int PRIMARY KEY,
    firstName text,
    lastName text) WITH cosmosdb_provisioned_throughput=1000);

コレクションの作成時にタイムアウト例外が発生した場合は、コレクションが正常に作成されたかどうかを確認する読み取り操作を実行します。 この読み取り操作では、コレクションの作成操作が成功するまで例外がスローされます。 作成操作でサポートされている状態コードの一覧については、記事「Azure Cosmos DB の HTTP 状態コード」を参照してください。

Azure CLI を使用して作成する

Azure CLI を使用して Cassandra テーブルを作成します。 すべての Azure Cosmos DB API にわたる Azure CLI の全サンプルの一覧については、「Azure Cosmos DB の Azure CLI サンプル」を参照してください。

PowerShell を使用して作成する

Powershell を使用して Cassandra テーブルを作成します。 すべての Azure Cosmos DB API にわたる PowerShell の全サンプルの一覧については、「Azure Cosmos DB 用 Azure PowerShell サンプル」を参照してください

次のステップ

• Azure Cosmos DB でのパーティション分割
• Azure Cosmos DB の要求ユニット
• コンテナーとデータベースのスループットのプロビジョニング
• Azure Cosmos DB アカウントの使用