Aanbiedingen
Azure Cosmos DB is een wereldwijd gedistribueerde database met meerdere modellen die ondersteuning biedt voor document-, grafiek- en sleutelwaardegegevensmodellen. De inhoud in deze sectie is bedoeld voor het maken, opvragen en beheren van aanbiedingen met behulp van de SQL API via REST.
Elke Azure Cosmos DB-verzameling wordt ingericht met een gekoppeld prestatieniveau dat wordt weergegeven als een aanbiedingsresource in het REST-model. Azure Cosmos DB ondersteunt aanbiedingen die zowel door de gebruiker gedefinieerde prestatieniveaus als vooraf gedefinieerde prestatieniveaus vertegenwoordigen. Elke aanbieding heeft een bijbehorende limiet voor aanvraageenheden (RU). Het is de doorvoer die is gereserveerd voor een verzameling op basis van het prestatieniveau en die uitsluitend beschikbaar is voor gebruik door die verzameling.
De aanbiedingsresource wordt vertegenwoordigd door aanbiedingen in het Cosmos DB-resourcemodel. Hier volgt een voorbeeld van de URI: https://mydbaccount.documents.azure.com/offers
.
In het volgende voorbeeld ziet u de JSON-constructie van een aanbieding met door de gebruiker gedefinieerde doorvoer (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
}
Eigenschap | Beschrijving |
---|---|
offerVersion |
Vereist.
V2 is de huidige versie voor doorvoer op basis van aanvraageenheden. |
Inhoud | Vereist. Bevat informatie over de aanbieding: voor V2-aanbiedingen bevat deze de doorvoer van de verzameling. |
Resource | Vereist. Wanneer u een nieuwe verzameling maakt, wordt deze eigenschap ingesteld op de zelfkoppeling van de verzameling, bijvoorbeeld dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
offerResourceId | Vereist. Tijdens het maken van een verzameling wordt deze eigenschap automatisch gekoppeld aan de resource-id, dat wil _rid van de verzameling. In het bovenstaande voorbeeld is de _rid voor de verzameling pLJdAOlEdgA=. |
Id | Het is een door het systeem gegenereerde eigenschap. De id voor de aanbiedingsresource wordt automatisch gegenereerd wanneer deze wordt gemaakt. Deze heeft dezelfde waarde als de _rid voor de aanbieding. |
_Ontdoen | Het is een door het systeem gegenereerde eigenschap. De resource-id (_rid) is een unieke id die ook hiƫrarchisch is per resourcestack in het resourcemodel. Het wordt intern gebruikt voor plaatsing en navigatie van de aanbieding. |
_Ts | Het is een door het systeem gegenereerde eigenschap. Hiermee geeft u de laatst bijgewerkte tijdstempel van de resource op. De waarde is een tijdstempel. |
_Zelf | Het is een door het systeem gegenereerde eigenschap. Dit is de unieke adresseerbare URI voor de resource. |
_etag | Het is een door het systeem gegenereerde eigenschap die de resource-etag aangeeft die is vereist voor optimistisch gelijktijdigheidsbeheer. |
Eigenschappen van inhoud
Eigenschap | Beschrijving |
---|---|
offerThroughput |
Vereist. De ingerichte doorvoer in aanvraageenheden per seconde als een getal. Moet in veelvoud van 100 zijn, beginnend bij 2500. Voor verzamelingen zonder partitiesleutel, geldig tussen 400-10000. |
Taken
U kunt het volgende doen met aanbiedingen:
- Een aanbieding krijgen
- Aanbiedingen weergeven
- Een aanbieding vervangen
- Query's uitvoeren op aanbiedingen