オファー

  • [アーティクル]

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 の間で有効です。

タスク

オファーでは、次の操作を行うことができます。

参照