Partager via


Offres

Azure Cosmos DB est une base de données multimodèle distribuée à l’échelle mondiale qui prend en charge les modèles de données de document, de graphique et de clé-valeur. Le contenu de cette section est destiné à la création, à l’interrogation et à la gestion des offres à l’aide de l’API SQL via REST.

Chaque collection Azure Cosmos DB est approvisionnée avec un niveau de performances associé représenté en tant que ressource d’offre dans le modèle REST. Azure Cosmos DB prend en charge des offres représentant à la fois des niveaux de performances définis par l’utilisateur et des niveaux de performances prédéfinis. Chaque offre a une limite de débit d’unité de requête (RU) associée. Il s’agit du débit qui est réservé à une collection en fonction de son niveau de performances et qui peut être utilisé exclusivement par cette collection.

La ressource d’offre est représentée par les offres dans le modèle de ressource Cosmos DB. Voici un exemple de l’URI : https://mydbaccount.documents.azure.com/offers.

L’exemple suivant illustre la construction JSON d’une offre avec un débit défini par l’utilisateur (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  
}  
  
Propriété Description
offerVersion Requis. V2 est la version actuelle pour le débit basé sur les unités de requête.
content Requis. Contient des informations sur l’offre : pour les offres V2, elles contiennent le débit de la collection.
resource Requis. Lors de la création d’une collection, cette propriété est définie sur l’auto-liaison de la collection, par exemple, dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Requis. Lors de la création d’une collection, cette propriété est automatiquement associée à l’ID de ressource, c’est-à-dire _rid de la collection. Dans l’exemple ci-dessus, le _rid de la collection est pLJdAOlEdgA=.
Identifiant Il s’agit d’une propriété générée par le système. L’ID de la ressource d’offre est généré automatiquement lors de sa création. Il a la même valeur que le _rid de l’offre.
_Débarrasser Il s’agit d’une propriété générée par le système. L’ID de ressource (_rid) est un identificateur unique qui est également hiérarchique en fonction de la pile de ressources sur le modèle de ressource. Il est utilisé en interne pour le positionnement et la navigation dans l'offre.
_Ts Il s’agit d’une propriété générée par le système. Elle spécifie l'horodateur de la dernière mise à jour de la ressource. La valeur est un horodateur.
_self Il s’agit d’une propriété générée par le système. Il s'agit de l'URI adressable unique pour la ressource.
_Etag Il s’agit d’une propriété générée par le système qui spécifie l’etag de ressource requis pour le contrôle d’accès concurrentiel optimiste.

Propriétés du contenu

Propriété Description
offerThroughput Requis. Débit provisionné en unités de requête par seconde sous forme de nombre.
Doit être dans le multiple de 100, à partir de 2500.
Pour les collections sans clé de partition, valide entre 400 et 10 000.

Tâches

Vous pouvez effectuer les opérations suivantes avec des offres :

Voir aussi