Azure Cosmos DB for MongoDB リソースのデータベース、コンテナー、または自動スケールスループットのプロビジョニング

[アーティクル]
06/01/2023

適用対象: MongoDB

この記事では、Azure Cosmos DB for MongoDB のスループットをプロビジョニングする方法について説明します。標準 (手動) または自動スケーリングのスループットは、コンテナーを対象にプロビジョニングできるほか、データベースを対象にプロビジョニングして、それをデータベース内の複数のコンテナーで共有することもできます。スループットは、Azure portal、Azure CLI、Azure Cosmos DB SDK のいずれかを使用してプロビジョニングできます。

別の API を使っている場合は、NoSQL 用 API、Cassandra 用 API、Gremlin 用 API のスループットプロビジョニングに関する記事を参照してください。

Azure portal

Azure portal にサインインします。
新しい Azure Cosmos DB アカウントを作成するか、既存の Azure Cosmos DB アカウントを選びます。
[データエクスプローラー] ウィンドウを開いて [新しいコレクション] を選択します。次に、以下の詳細を指定します。
- 新しいデータベースを作成するか、既存のデータベースを使用するかを指定します。データベースレベルでスループットをプロビジョニングする場合は、 [データベースのスループットのプロビジョニング] オプションを選択します。
- コレクション ID を入力します。
- パーティションキーの値 (ItemID など) を入力します。
- プロビジョニングするスループットを入力します (例: 1,000 RU)。
- [OK] を選択します。

注意

Azure Cosmos DB for MongoDB を使って構成された Azure Cosmos DB アカウントのコンテナーに対するスループットをプロビジョニングする場合は、パーティションキーのパスとして myShardKey を使います。

.NET SDK

// refer to MongoDB .NET Driver
// https://docs.mongodb.com/drivers/csharp

// Create a new Client
String mongoConnectionString = "mongodb://DB AccountName:Password@DB AccountName.documents.azure.com:10255/?ssl=true&replicaSet=globaldb";
mongoUrl = new MongoUrl(mongoConnectionString);
mongoClientSettings = MongoClientSettings.FromUrl(mongoUrl);
mongoClient = new MongoClient(mongoClientSettings);

// Change the database name
mongoDatabase = mongoClient.GetDatabase("testdb");

// Change the collection name, throughput value then update via MongoDB extension commands
// https://learn.microsoft.com/azure/cosmos-db/mongodb-custom-commands#update-collection

var result = mongoDatabase.RunCommand<BsonDocument>(@"{customAction: ""UpdateCollection"", collection: ""testcollection"", offerThroughput: 400}");

Azure Resource Manager

Azure Resource Manager テンプレートを使用すると、すべての Azure Cosmos DB API に対して、データベースまたはコンテナーレベルのリソースへの自動スケーリングのスループットをプロビジョニングできます。サンプルについては、「Azure Cosmos DB の Azure Resource Manager テンプレート」を参照してください。

Azure CLI

Azure CLI を使用すると、すべての Azure Cosmos DB API に対して、データベースまたはコンテナーレベルのリソースへの自動スケーリングのスループットをプロビジョニングできます。サンプルについては、「Azure Cosmos DB の Azure CLI サンプル」を参照してください。

Azure PowerShell

Azure PowerShell を使用すると、すべての Azure Cosmos DB API に対して、データベースまたはコンテナーレベルのリソースへの自動スケーリングのスループットをプロビジョニングできます。サンプルについては、「Azure Cosmos DB 用 Azure PowerShell サンプル」を参照してください。

次のステップ

Azure Cosmos DB でのスループットのプロビジョニングについては、次の記事を参照してください。

Azure Cosmos DB における要求ユニットとスループット
Azure Cosmos DB に移行する容量計画を実行しようとしていますか? 容量計画のために、既存のデータベースクラスターに関する情報を使用できます。
- 既存のデータベースクラスター内の仮想コアとサーバーの数のみがわかっている場合は、仮想コア数または仮想 CPU 数を使用した要求ユニットの見積もりに関するページを参照してください
- 現在のデータベースワークロードに対する通常の要求レートがわかっている場合は、Azure Cosmos DB Capacity Planner を使用した要求ユニットの見積もりに関するページを参照してください

Azure Cosmos DB for MongoDB リソースのデータベース、コンテナー、または自動スケール スループットのプロビジョニング