Azure Cosmos DB for MongoDB リソースのデータベース、コンテナー、または自動スケール スループットのプロビジョニング
適用対象: 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 を使用した要求ユニットの見積もりに関するページを参照してください