Запросы предложений

  • Статья

Можно выполнять запросы по ресурсам предложений, выдавая метод POST для ресурсов предложений, т. е. путь URI предложения. В этом разделе показан простой пример получения предложений для определенной коллекции по ее самосвязи.

Запрос

Метод Универсальный код ресурса (URI) запроса Описание
POST https://{databaseaccount}.documents.azure.com/offers Обратите внимание, что {databaseaccount} — это имя учетной записи Azure Cosmos DB, созданной в рамках подписки.

Заголовки

Заголовки, используемые всеми запросами Cosmos DB, см. в статье Общие заголовки запросов REST Azure Cosmos DB .

Заголовок Обязательно Описание
Content-Type Обязательно Для параметра должно быть задано значение application/query+json.
x-ms-documentdb-isquery Обязательно Должно быть задано значение True.

Текст

Свойство Обязательно Описание
запрос Обязательно Значение этого свойства для выполнения инструкции SQL. 
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}

Ответ

Возвращает массив ресурсов объектов, соответствующих запросу.

Заголовки

Заголовки, возвращаемые всеми ответами Cosmos DB, см. в статье Общие заголовки ответов REST Azure Cosmos DB .

Header Описание
x-ms-item-count Это количество элементов, возвращаемых запросом.

Коды состояния

В таблице ниже указаны стандартные коды состояния, возвращаемые этой операцией. Полный список кодов состояния см. в разделе Коды состояния HTTP.

Код состояния HTTP Описание
200 (ОК) Операция выполнена успешно.
400 — недопустимый запрос Недопустимый текст JSON.
401 — недостаточно прав Не указан заголовок Authorization или x-ms-date. Код 401 также возвращается, если для заголовка Authorization задан недопустимый маркер авторизации.

Текст

Свойство Описание
_Избавить Это свойство, созданное системой. Значение _rid пусто для этой операции.
_Рассчитывать Это свойство показывает количество предложений, возвращенных в рамках операции.
Предложения Это массив, содержащий предложения, возвращенные в рамках операции.
Сведения о свойствах ресурса предложения см. в разделе Предложения .		 
{"_rid":"","Offers":[],"_count":0}

Пример

POST https://querydemo.documents.azure.com/offers HTTP/1.1  
x-ms-continuation:   
x-ms-documentdb-isquery: True  
x-ms-documentdb-query-enablecrosspartition: False  
x-ms-date: Tue, 29 Mar 2016 18:07:41 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3d0si%2fhno2pKTQhgvdkojNqlQlYdoguwQEBt79XvpobMc%3d  
Cache-Control: no-cache  
User-Agent: Microsoft.Azure.Documents.Client/1.6.0.0 samples-net/3  
x-ms-version: 2015-12-16  
Accept: application/json  
Content-Type: application/query+json  
Host: querydemo.documents.azure.com  
Content-Length: 94  
Expect: 100-continue  
  
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
  

HTTP/1.1 200 Ok  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Transfer-Encoding: chunked  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Fri, 25 Mar 2016 21:27:20.035 GMT  
x-ms-item-count: 0  
x-ms-schemaversion: 1.1  
x-ms-request-charge: 3.94  
x-ms-serviceversion: version=1.6.52.5  
x-ms-activity-id: b151cbe4-aae0-4949-959f-189b9884478d  
x-ms-session-token: M:8166  
x-ms-gatewayversion: version=1.6.52.5  
Date: Tue, 29 Mar 2016 18:07:41 GMT  
  
{"_rid":"","Offers":[],"_count":0}

См. также: