Nabídky
Azure Cosmos DB je globálně distribuovaná databáze s více modely, která podporuje modely dokumentů, grafů a datových modelů klíč-hodnota. Obsah v této části je určený k vytváření, dotazování a správě nabídek pomocí rozhraní SQL API přes REST.
Každá kolekce Azure Cosmos DB má přidruženou úroveň výkonu reprezentovanou jako prostředek nabídky v modelu REST. Azure Cosmos DB podporuje nabídky představující uživatelem definované úrovně výkonu i předdefinované úrovně výkonu. Ke každé nabídce je přidružený limit přenosové rychlosti jednotek žádostí (RU). Jedná se o propustnost, která je vyhrazená pro kolekci na základě její úrovně výkonu a je k dispozici výhradně pro tuto kolekci.
Prostředek nabídky jsou reprezentovány nabídkami v modelu prostředků Cosmos DB. Tady je příklad identifikátoru URI: https://mydbaccount.documents.azure.com/offers
.
Následující příklad znázorňuje konstruktor JSON nabídky s uživatelsky definovanou propustností (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
}
Vlastnost | Popis |
---|---|
verze nabídky |
Povinné.
V2 je aktuální verze propustnosti na základě jednotek žádosti. |
Obsah | Povinné. Obsahuje informace o nabídce – u nabídek V2 obsahuje propustnost kolekce. |
Zdrojů | Povinné. Při vytváření nové kolekce se tato vlastnost nastaví na odkaz kolekce na sebe, například dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
offerResourceId | Povinné. Při vytváření kolekce se tato vlastnost automaticky přidružuje k ID prostředku, tj. _rid kolekce. Ve výše uvedeném příkladu je _rid pro kolekci pLJdAOlEdgA=. |
ID | Jedná se o systémem vygenerovanou vlastnost. ID prostředku nabídky se automaticky vygeneruje při jeho vytvoření. Má stejnou hodnotu jako _rid nabídky. |
_Zbavit | Jedná se o systémem vygenerovanou vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Používá se interně k umístění a navigaci v nabídce. |
_Ts | Jedná se o systémem vygenerovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko. |
_Vlastní | Jedná se o systémem vygenerovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku. |
_Etag | Jedná se o systémem vygenerovanou vlastnost, která určuje etag prostředku vyžadovanou pro optimistické řízení souběžnosti. |
Vlastnosti obsahu
Vlastnost | Popis |
---|---|
offerThroughput |
Povinné. Zřízená propustnost v jednotkách žádostí za sekundu jako číslo. Musí být v násobku 100 počínaje číslem 2500. Pro kolekce bez klíče oddílu platí 400–10 000. |
Úlohy
S nabídkami můžete provádět následující akce: