オファー
Azure Cosmos DB は、ドキュメント、グラフ、キー値のデータ モデルをサポートするグローバル分散マルチモデル データベースです。 このセクションの内容は、REST 経由で SQL API を使用してオファーを作成、クエリ、および管理するための内容です。
各 Azure Cosmos DB コレクションは、REST モデルの オファー リソースとして表される関連するパフォーマンス レベルでプロビジョニングされます。 Azure Cosmos DB では、ユーザー定義のパフォーマンス レベルと定義済みのパフォーマンス レベルの両方を表すオファーがサポートされています。 各オファーには、関連する要求ユニット (RU) レート制限があります。 パフォーマンス レベルに基づいてコレクション用に予約され、そのコレクションでのみ使用できるスループットです。
オファー リソースは、Cosmos DB リソース モデルのオファーによって表されます。 URI の例を次に示します https://mydbaccount.documents.azure.com/offers
。
次の例は、ユーザー定義スループット (V2) を持つオファーの JSON 構成を示しています。
{
"offerVersion": "V2",
"offerType": "Invalid",
"_rid": "Hu+t",
"content": {
"offerThroughput": 500
},
"resource": "dbs/yEcCAA==/colls/yEcCAPX6aAw=/",
"offerResourceId": "yEcCAPX6aAw=",
"id": "Hu+t",
"_self": "offers/Hu+t/",
"_etag": "\"00009100-0000-0000-0000-56fa9a1f0000\"",
"_ts": 1459264031
}
プロパティ | Description |
---|---|
offerVersion |
[必須] 。
V2 は、要求ユニットベースのスループットの現在のバージョンです。 |
content | [必須] 。 オファーに関する情報が含まれます。V2 オファーの場合、これにはコレクションのスループットが含まれます。 |
resource | [必須] 。 新しいコレクションを作成する場合、このプロパティはコレクションのセルフリンクに設定されます (例: dbs/pLJdAA==/colls/pLJdAOlEdgA=/)。 |
offerResourceId | [必須] 。 コレクションの作成時に、このプロパティはリソース ID (つまり、コレクションの _rid ) に自動的に関連付けられます。 上記の例では、コレクションの _rid は pLJdAOlEdgA= です。 |
ID | これは、システムによって生成されるプロパティです。 オファー リソースの ID は、作成時に自動的に生成されます。 オファーの _rid と同じ値を持っています。 |
_解消 | これは、システムによって生成されるプロパティです。 リソース ID (_rid) は、リソース モデル上のリソース スタックごとに階層化された一意識別子です。 プランの配置とナビゲーションのために内部的に使用されます。 |
_Ts | これは、システムによって生成されるプロパティです。 リソースの最終更新タイムスタンプを示します。 値は、タイムスタンプです。 |
_自己 | これは、システムによって生成されるプロパティです。 リソースの一意のアドレス指定が可能な URI です。 |
_Etag | これは、オプティミスティック コンカレンシー制御に必要なリソース etag を指定するシステム生成プロパティです。 |
コンテンツのプロパティ
プロパティ | Description |
---|---|
offerThroughput |
[必須] 。 プロビジョニングされたスループット (1 秒あたりの要求ユニット数) を数値として指定します。 2500 から 100 の倍数にする必要があります。 パーティション キーのないコレクションの場合は、400 から 10000 の間で有効です。 |
タスク
オファーでは、次の操作を行うことができます。