Share via

Offerte

  • Articolo

Azure Cosmos DB è un database multimodello distribuito a livello globale che supporta i modelli di dati document, graph e key-value. Il contenuto di questa sezione consiste nel creare, eseguire query e gestire le offerte usando l'API SQL tramite REST.

Ogni raccolta di Azure Cosmos DB viene eseguita con un livello di prestazioni associato rappresentato come risorsa Offerta nel modello REST. Azure Cosmos DB supporta offerte che rappresentano sia i livelli di prestazioni definiti dall'utente che i livelli di prestazioni predefiniti. Ogni offerta ha un limite di frequenza di unità richiesta associato. È la velocità effettiva riservata a una raccolta in base al livello di prestazioni ed è disponibile esclusivamente per l'uso da parte di tale raccolta.

La risorsa offerta è rappresentata dalle offerte nel modello di risorse Cosmos DB. Ecco un esempio dell'URI: https://mydbaccount.documents.azure.com/offers.

Nell'esempio seguente viene illustrato il costrutto JSON di un'offerta con velocità effettiva definita dall'utente (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  
}
Proprietà Descrizione
offerVersion Obbligatorio. V2 è la versione corrente per la velocità effettiva basata su unità di richiesta.
content Obbligatorio. Contiene informazioni sull'offerta: per le offerte V2, che contiene la velocità effettiva della raccolta.
resource Obbligatorio. Quando si crea una nuova raccolta, questa proprietà viene impostata sul collegamento automatico della raccolta, ad esempio dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Obbligatorio. Durante la creazione di una raccolta, questa proprietà viene associata automaticamente all'ID risorsa, ovvero _rid della raccolta. Nell'esempio precedente il _rid per la raccolta è pLJdAOlEdgA=.
ID Si tratta di una proprietà generata dal sistema. L'ID per la risorsa offerta viene generato automaticamente al momento della creazione. Ha lo stesso valore della _rid per l'offerta.
_rid Si tratta di una proprietà generata dal sistema. L'ID risorsa (_rid) è un identificatore univoco che è anche gerarchico per ogni stack di risorse nel modello di risorsa. Viene usato internamente per il posizionamento e l'esplorazione dell'offerta.
_Ts Si tratta di una proprietà generata dal sistema. Indica il timestamp dell'ultimo aggiornamento della risorsa. Il valore è un timestamp.
_stesso Si tratta di una proprietà generata dal sistema. URI indirizzabile univoco per la risorsa.
_Etag Si tratta di una proprietà generata dal sistema che specifica l'etag della risorsa necessaria per il controllo di concorrenza ottimistica.

Proprietà del contenuto

Proprietà Descrizione
offerThroughput Obbligatorio. Velocità effettiva con provisioning nelle unità di richiesta al secondo come numero.
Deve essere in più di 100, a partire da 2500.
Per le raccolte senza una chiave di partizione, valida tra 400-10000.

Attività

È possibile eseguire le operazioni seguenti con le offerte:

Vedere anche