Oferty

  • Artykuł

Usługa Azure Cosmos DB to globalnie rozproszona wielomodelowa baza danych, która obsługuje modele danych dokumentów, grafów i klucz-wartość. Zawartość tej sekcji służy do tworzenia ofert, wykonywania zapytań i zarządzania nimi przy użyciu interfejsu API SQL za pośrednictwem interfejsu API REST.

Każda kolekcja usługi Azure Cosmos DB jest aprowizowana ze skojarzonym poziomem wydajności reprezentowanym jako zasób oferty w modelu REST. Usługa Azure Cosmos DB obsługuje oferty reprezentujące zarówno poziomy wydajności zdefiniowane przez użytkownika, jak i wstępnie zdefiniowane poziomy wydajności. Każda oferta ma skojarzony limit szybkości jednostki żądania (RU). Jest to przepływność zarezerwowana dla kolekcji na podstawie poziomu wydajności i jest dostępna do użytku wyłącznie przez kolekcję.

Zasób oferty jest reprezentowany przez oferty w modelu zasobów usługi Cosmos DB. Oto przykład identyfikatora URI: https://mydbaccount.documents.azure.com/offers.

W poniższym przykładzie przedstawiono konstrukcję JSON oferty z zdefiniowaną przez użytkownika przepływnością (wersja 2):

{  
  "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  
}
Właściwość Opis
offerVersion Wymagane. V2 jest bieżącą wersją przepływności opartej na jednostkach żądań.
Zawartości Wymagane. Zawiera informacje o ofercie — w przypadku ofert w wersji 2 zawiera przepływność kolekcji.
Zasobów Wymagane. Podczas tworzenia nowej kolekcji ta właściwość jest ustawiona na link własny kolekcji, na przykład dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Wymagane. Podczas tworzenia kolekcji ta właściwość jest automatycznie skojarzona z identyfikatorem zasobu, czyli _rid kolekcji. W powyższym przykładzie _rid kolekcji to pLJdAOlEdgA=.
ID (Identyfikator) Jest to właściwość wygenerowana przez system. Identyfikator zasobu oferty jest generowany automatycznie podczas jego tworzenia. Ma taką samą wartość jak _rid dla oferty.
_Rid Jest to właściwość wygenerowana przez system. Identyfikator zasobu (_rid) to unikatowy identyfikator, który jest również hierarchiczny dla stosu zasobów w modelu zasobów. Jest on używany wewnętrznie do umieszczania i nawigacji oferty.
_Ts Jest to właściwość wygenerowana przez system. Określa ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu.
_Własny Jest to właściwość wygenerowana przez system. Jest to unikatowy adresowy identyfikator URI zasobu.
_Etag Jest to właściwość wygenerowana przez system, która określa tag zasobu wymagany do optymistycznej kontrolki współbieżności.

Właściwości zawartości

Właściwość Opis
offerThroughput Wymagane. Aprowizowana przepływność w jednostkach żądań na sekundę jako liczba.
Musi znajdować się w wielokrotności 100, począwszy od 2500.
W przypadku kolekcji bez klucza partycji ważne jest od 400 do 10000.

Zadania

Możesz wykonać następujące czynności za pomocą ofert:

Zobacz też