Ofertas

  • Artigo

O Azure Cosmos DB é um banco de dados multimodelo distribuído globalmente que dá suporte aos modelos de dados de documento, grafo e chave-valor. O conteúdo nesta seção é para criar, consultar e gerenciar ofertas usando a API do SQL por meio de REST.

Cada coleção do Azure Cosmos DB é provisionada com um nível de desempenho associado representado como um recurso offer no modelo REST. O Azure Cosmos DB dá suporte a ofertas que representam níveis de desempenho definidos pelo usuário e níveis de desempenho predefinidos. Cada oferta tem um limite de taxa de RU (unidade de solicitação) associado. É a taxa de transferência reservada para uma coleção com base em seu nível de desempenho e está disponível exclusivamente para uso por essa coleção.

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

O exemplo a seguir ilustra o constructo JSON de uma oferta com taxa de transferência definida pelo usuário (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 Obrigatório. V2 é a versão atual para a taxa de transferência baseada em unidade de solicitação.
content Obrigatório. Contém informações sobre a oferta – para ofertas V2, isso contém a taxa de transferência da coleção.
recurso Obrigatório. Ao criar uma nova coleção, essa propriedade é definida como o auto-link da coleção, por exemplo, dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Obrigatório. Durante a criação de uma coleção, essa propriedade é automaticamente associada à ID do recurso, ou seja, _rid da coleção. No exemplo acima, o _rid da coleção é pLJdAOlEdgA=.
ID É uma propriedade gerada pelo sistema. A ID do recurso de oferta é gerada automaticamente quando ele é criado. Ele tem o mesmo valor que o _rid para a oferta.
_Livrar É uma propriedade gerada pelo sistema. A ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recurso. Ela é usada internamente para posicionamento 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.
_Auto É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo do recurso.
_Etag É uma propriedade gerada pelo sistema que especifica a etag de recurso necessária para o controle de simultaneidade otimista.

Propriedades do Conteúdo

Propriedade Descrição
offerThroughput Obrigatório. A taxa de transferência provisionada em unidades de solicitação por segundo como um número.
Deve estar em vários de 100, começando em 2500.
Para coleções sem uma chave de partição, válido entre 400-10000.

Tarefas

Você pode fazer o seguinte com ofertas:

Consulte Também