Partilhar via

Ofertas

  • Artigo

O Azure Cosmos DB é uma base de dados de vários modelos distribuída globalmente que suporta os modelos de dados de documentos, gráficos e chave-valor. O conteúdo nesta secção destina-se a criar, consultar e gerir ofertas com a API SQL através do REST.

Cada coleção do Azure Cosmos DB é aprovisionada com um nível de desempenho associado representado como um recurso de Oferta no modelo REST. O Azure Cosmos DB suporta ofertas que representam níveis de desempenho definidos pelo utilizador e níveis de desempenho predefinidos. Cada oferta tem um limite de taxa de unidade de pedido (RU) associado. É o débito reservado para uma coleção com base no seu nível de desempenho e está disponível exclusivamente para utilização por essa coleção.

O recurso de oferta é representado por ofertas no modelo de recursos do Cosmos DB. Eis um exemplo do URI: https://mydbaccount.documents.azure.com/offers.

O exemplo seguinte ilustra a construção JSON de uma oferta com débito definido pelo utilizador (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  
}
Propriedade Descrição
offerVersion Necessário. V2 é a versão atual do débito baseado em unidades de pedido.
conteúdo Necessário. Contém informações sobre a oferta – para ofertas V2, isto contém o débito da coleção.
recurso Necessário. Ao criar uma nova coleção, esta propriedade é definida para a auto-ligação da coleção, por exemplo, dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Necessário. Durante a criação de uma coleção, esta propriedade é automaticamente associada ao ID do recurso, ou seja, _rid da coleção. No exemplo acima, o _rid da coleção é pLJdAOlEdgA=.
ID É uma propriedade gerada pelo sistema. O ID do recurso de oferta é gerado automaticamente quando é criado. Tem o mesmo valor que o _rid para a oferta.
_rid É uma propriedade gerada pelo sistema. O ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recursos. É utilizado internamente para colocação e navegação da oferta.
_ts É uma propriedade gerada pelo sistema. Especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora.
_self É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo para o recurso.
_etag É uma propriedade gerada pelo sistema que especifica o etag de recursos necessário para o controlo de simultaneidade otimista.

Propriedades do Conteúdo

Propriedade Descrição
offerThroughput Necessário. O débito aprovisionado em unidades de pedido por segundo como um número.
Tem de estar em múltiplos de 100, a partir de 2500.
Para coleções sem uma chave de partição, é válida entre 400 e 10000.

Tarefas

Pode fazer o seguinte com ofertas:

Consulte também