Offers
Azure Cosmos DB 是全域散發的多模型資料庫,可支援檔、圖形和索引鍵/值資料模型。 本節中的內容是透過 REST 使用 SQL API 來建立、查詢和管理供應專案。
每個 Azure Cosmos DB 集合都會以 REST 模型中的 供應 專案資源表示的相關效能等級來布建。 Azure Cosmos DB 支援代表使用者定義效能等級和預先定義的效能等級的供應專案。 每個供應專案都有相關聯的要求單位, (RU) 速率限制。 它是根據集合效能等級保留給集合的輸送量,而且可供該集合獨佔使用。
供應專案資源是由 Cosmos DB 資源模型中的供應專案表示。 以下是 URI 的範例: https://mydbaccount.documents.azure.com/offers
。
下列範例說明供應專案的 JSON 建構,其中包含使用者定義的輸送量 (V2) :
{
"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 供應專案,這包含集合的輸送量。 |
資源 | 必要。 建立新的集合時,這個屬性會設定為集合的自我連結,例如 dbs/pLJdAA==/colls/pLJdAOlEdgA=/。 |
offerResourceId | 必要。 在建立集合期間,此屬性會自動與資源識別碼相關聯,也就是 集合_rid 。 在上述範例中,集合 的_rid 是 pLJdAOlEdgA=。 |
識別碼 | 這是系統產生的屬性。 建立供應專案資源時,會自動產生供應專案的 識別碼 。 其值與供應專案的 _rid 相同。 |
_擺脫 | 這是系統產生的屬性。 資源識別碼 (_rid) 是資源模型上每個資源堆疊也是階層式的唯一識別碼。 在內部用來放置和導覽供應項目。 |
_Ts | 這是系統產生的屬性。 代表資源的上次更新時間戳記。 值為時間戳記。 |
_自我 | 這是系統產生的屬性。 代表資源的唯一可定址 URI。 |
_Etag | 這是系統產生的屬性,指定開放式平行存取控制所需的資源 etag。 |
內容的屬性
屬性 | Description |
---|---|
offerThroughput |
必要。 以每秒要求單位為單位的布建輸送量,以數位表示。 必須位於 100 的倍數,從 2500 開始。 對於沒有分割區索引鍵的集合,有效介於 400-10000 之間。 |
工作
您可以使用供應專案執行下列動作: