次の方法で共有

Azure Cosmos DB for MongoDB でコレクションを作成する

  • [アーティクル]

適用対象: MongoDB

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

注意

コンテナーとコレクションは、リレーショナル データベースのテーブルに似ています。 Azure Cosmos DB for NoSQL では、また Azure portal 全体でコンテナーという用語が使われていますが、Azure Cosmos DB for MongoDB の文脈では、Mongo DB で使用される用語に合わせてコレクションという用語を使用します。

この記事では、Azure Cosmos DB for MongoDB でコレクションを作成するさまざまな方法について説明します。 別の API を使用している場合は、コレクションを作成する方法について、NoSQL 用 API、Cassandra 用 API、Gremlin 用 API、Table 用 API の記事をご覧ください。

注意

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

Azure portal を使用した作成

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

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

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

    • 新しいデータベースを作成するか、既存のデータベースを使用するかを指定します。
    • コンテナー ID を入力します。
    • シャード キーを入力します。
    • プロビジョニングするスループットを入力します (例: 1,000 RU)。
    • [OK] を選択します。

    Azure Cosmos DB for MongoDB の [コンテナーの追加] ダイアログ ボックスのスクリーンショット

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

var bson = new BsonDocument
{
    { "customAction", "CreateCollection" },
    { "collection", "<CollectionName>" },//update CollectionName
    { "shardKey", "<ShardKeyName>" }, //update ShardKey
    { "offerThroughput", 400} //update Throughput
};
var shellCommand = new BsonDocumentCommand<BsonDocument>(bson);
// Create a collection with a partition key by using Mongo Driver:
db.RunCommand(shellCommand);

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

Azure CLI を使用して作成する

Azure CLI を使用して Azure Cosmos DB for MongoDB API のコレクションを作成します。 すべての Azure Cosmos DB API にわたる Azure CLI の全サンプルの一覧については、「Azure Cosmos DB の Azure CLI サンプル」を参照してください。

PowerShell を使用して作成する

Powershell を使用して Azure Cosmos DB for MongoDB API のコレクションを作成します。 すべての Azure Cosmos DB API にわたる PowerShell の全サンプルの一覧については、「Azure Cosmos DB 用 Azure PowerShell サンプル」を参照してください

Azure Resource Manager テンプレートを使用してコレクションを作成する

Azure Resource Manager テンプレートを使用して Azure Cosmos DB for MongoDB API のコレクションを作成します。

次のステップ