Eseguire query nelle offerte
È possibile eseguire query sulle risorse offerta emettendo una richiesta POST sulla risorsa offerta, ovvero il percorso URI delle offerte. Questa sezione mostrerà un semplice esempio di recupero delle offerte per una particolare raccolta tramite il collegamento automatico.
Richiesta
| Metodo | URI richiesta | Descrizione |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
Si noti che {databaseaccount} è il nome dell'account Azure Cosmos DB creato nella sottoscrizione. |
Intestazioni
Vedere Intestazioni di richiesta REST di Azure Cosmos DB comuni per le intestazioni usate da tutte le richieste di Cosmos DB.
| Intestazione | Obbligatoria | Descrizione |
|---|---|---|
| Content-Type | Necessario | Deve essere impostato su application/query+json. |
| x-ms-documentdb-isquery | Necessario | Deve essere impostato su True. |
Corpo
| Proprietà | Obbligatoria | Descrizione |
|---|---|---|
| query | Necessario | Il valore di questa proprietà corrisponde all'istruzione SQL da eseguire. |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
Risposta
Restituisce una matrice di risorse oggetto corrispondenti alla query.
Intestazioni
Vedere Intestazioni di risposta REST di Azure Cosmos DB comuni per le intestazioni restituite da tutte le risposte di Cosmos DB.
| Intestazione | Descrizione |
|---|---|
| x-ms-item-count | Numero di elementi restituiti dalla query. |
Codici di stato
La seguente tabella elenca i codici di stato comuni restituiti da questa operazione. Per un elenco completo dei codici di stato, vedere Codici di stato HTTP.
| Codice di stato HTTP | Descrizione |
|---|---|
| 200 Ok | L'operazione è stata completata. |
| 400 - Richiesta non valida | Il corpo JSON non è valido. |
| 401 - Non autorizzato | L'intestazione Authorization o x-ms-date non è impostata. Il codice 401 viene restituito anche quando l'intestazione Authorization è impostata su un token di autorizzazione non valido. |
Corpo
| Proprietà | Descrizione |
|---|---|
| _liberarsi | Si tratta di una proprietà generata dal sistema. Il valore _rid è vuoto per questa operazione. |
| _Conteggio | Questa proprietà mostra il numero di offerte restituite come parte dell'operazione. |
| Offerte | È la matrice contenente le offerte restituite come parte dell'operazione. Vedere Offerte per trovare le proprietà della risorsa offerta. |
{"_rid":"","Offers":[],"_count":0}
Esempio
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}