Предложения

  • Статья

Azure Cosmos DB — это глобально распределенная база данных с несколькими моделями, которая поддерживает модели данных документов, графов и ключей и значений. Содержимое этого раздела предназначено для создания предложений, запросов и управления ими с помощью API SQL через REST.

Каждая коллекция Azure Cosmos DB подготавливается с соответствующим уровнем производительности, представленным в модели REST в виде ресурса Предложения . Azure Cosmos DB поддерживает предложения, представляющие как определяемые пользователем уровни производительности, так и предварительно определенные уровни производительности. У каждого предложения есть соответствующая единица запроса (ЕЗ) ограничения скорости. Это пропускная способность, которая зарезервирована для коллекции на основе ее уровня производительности и доступна для использования исключительно этой коллекцией.

Ресурс предложения представлен предложениями в модели ресурсов Cosmos DB. Ниже приведен пример универсального кода ресурса (URI): https://mydbaccount.documents.azure.com/offers.

В следующем примере показана конструкция JSON предложения с определяемой пользователем пропускной способностью (версия 2):

{  
  "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  
}
Свойство Описание
OfferVersion Обязательно. V2 — это текущая версия пропускной способности на основе единиц запроса.
content Обязательно. Содержит сведения о предложении . Для предложений версии 2 это содержит пропускную способность коллекции.
resource Обязательно. При создании новой коллекции этому свойству присваивается самостоятельная связь коллекции, например dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Обязательно. Во время создания коллекции это свойство автоматически связывается с идентификатором ресурса, то есть _rid коллекции. В приведенном выше примере _rid для коллекции — pLJdAOlEdgA=.
Идентификатор Это свойство, созданное системой. Идентификатор ресурса предложения создается автоматически при его создании. Он имеет то же значение, что и _rid для предложения.
_rid Это свойство, созданное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется системой для размещения предложения и перемещения по нему.
_Ts Это свойство, созданное системой. Оно представляет метку времени последнего обновления ресурса. Значение — метка времени.
_Самостоятельно Это свойство, созданное системой. Это уникальный адресуемый URI для ресурса.
_etag Это системное свойство, указывающее тег ресурса, необходимый для управления оптимистическим параллелизмом.

Свойства содержимого

Свойство Описание
offerThroughput Обязательно. Подготовленная пропускная способность в единицах запроса в секунду в виде числа.
Должно быть кратно 100, начиная с 2500.
Для коллекций без ключа секции допустимо в диапазоне от 400 до 10 000.

Задания

С предложениями можно выполнить следующие действия:

См. также: