Ofertas

  • Artículo

Azure Cosmos DB es una base de datos multimodelo distribuida globalmente que admite los modelos de datos de documento, gráfico y clave-valor. El contenido de esta sección es para crear, consultar y administrar ofertas mediante la API de SQL a través de REST.

Cada colección de Azure Cosmos DB se aprovisiona con un nivel de rendimiento asociado representado como un recurso de oferta en el modelo REST. Azure Cosmos DB admite ofertas que representan tanto los niveles de rendimiento definidos por el usuario como los niveles de rendimiento predefinidos. Cada oferta tiene un límite de frecuencia de unidad de solicitud (RU) asociado. Es el rendimiento que se reserva para una colección en función de su nivel de rendimiento y está disponible para su uso exclusivo por esa colección.

El recurso de oferta se representa mediante ofertas en el modelo de recursos de Cosmos DB. Este es un ejemplo del URI: https://mydbaccount.documents.azure.com/offers.

En el ejemplo siguiente se muestra la construcción JSON de una oferta con rendimiento definido por el usuario (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  
}
Propiedad Descripción
offerVersion Requerido. V2 es la versión actual para el rendimiento basado en unidades de solicitud.
content Requerido. Contiene información sobre la oferta: para las ofertas V2, contiene el rendimiento de la colección.
resource Requerido. Al crear una colección, esta propiedad se establece en el auto link de la colección, por ejemplo, dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Requerido. Durante la creación de una colección, esta propiedad se asocia automáticamente al identificador de recurso, es decir, _rid de la colección. En el ejemplo anterior, el _rid de la colección es pLJdAOlEdgA=.
ID Es una propiedad generada por el sistema. El identificador del recurso de oferta se genera automáticamente cuando se crea. Tiene el mismo valor que el _rid de la oferta.
_Librar Es una propiedad generada por el sistema. El identificador de recurso (_rid) es un identificador único que también es jerárquico por la pila de recursos en el modelo de recursos. Se usa internamente para la colocación y desplazamiento de la oferta.
_Ts Es una propiedad generada por el sistema. Especifica la última marca de tiempo actualizada del recurso. El valor es una marca de tiempo.
_propio Es una propiedad generada por el sistema. Es el URI direccionable único para el recurso.
_Etag Se trata de una propiedad generada por el sistema que especifica la etag de recursos necesaria para el control de simultaneidad optimista.

Propiedades del contenido

Propiedad Descripción
offerThroughput Requerido. Rendimiento aprovisionado en unidades de solicitud por segundo como un número.
Debe estar en múltiplo de 100 a partir de 2500.
Para las colecciones sin una clave de partición, válida entre 400 y 10000.

Tareas

Puede hacer lo siguiente con ofertas:

Consulte también