Supporto per OData (Ricerca di intelligenza artificiale di Azure)
L'API servizio di ricerca di intelligenza artificiale di Azure usa Open Data Protocol (OData) per le query sugli indici. Ricerca intelligenza artificiale di Azure supporta OData versione 4.
Sintassi di OData nelle intestazioni della richiesta HTTP
OData definisce alcune intestazioni della richiesta HTTP che è possibile impostare facoltativamente. È possibile usare valori specifici di OData per l'intestazione Accept, come application/json;odata.metadata=none, per controllare la quantità di metadati inclusi nella risposta. Il valore predefinito è odata.metadata=minimal. Per brevità, in tutti gli esempi del documenti si presuppone odata.metadata=none.
È anche possibile impostare l'intestazione OData-MaxVersion. L'API del servizio Ricerca intelligenza artificiale di Azure supporta OData V4, quindi è consigliabile impostare OData-MaxVersion su "4.0". Ciò indica all'API di aspettarsi il formato OData V4 nel corpo della risposta e di inviare risposte in formato OData V4. Poiché in futuro è possibile che venga aggiunto il supporto per versioni più recenti del protocollo OData, è possibile che l'intestazione venga impostata su un valore diverso. L'API di servizio di ricerca di intelligenza artificiale di Azure non supporta le versioni di OData precedenti alla versione 4.
Vedere Sintassi delle espressioni OData per Ricerca intelligenza artificiale di Azure per informazioni dettagliate sull'uso di OData nei filtri e nelle espressioni di ordinamento. Per una sintassi alternativa, vedere sintassi di query semplice in Ricerca di intelligenza artificiale di Azure.
API del servizio di ricerca con sintassi alternativa di OData
L'API del servizio di ricerca supporta la sintassi di OData per la ricerca di entità, sia nei documenti di un indice, sia negli indici stessi (in cui il nome dell'indice è la chiave di entità). Di seguito è disponibile un riepilogo di tutte le API che hanno una sintassi alternativa di OData:
Aggiornamento di un indice
PUT /indexes('[index name]')?api-version=2015-02-28
Recupero di un indice
GET /indexes('[index name]')?api-version=2015-02-28
Recupero di statistiche dell'indice
GET /indexes('[index name]')/stats?api-version=2015-02-28
Eliminazione di un indice
DELETE /indexes('[index name]')?api-version=2015-02-28
Aggiunta ed eliminazione di dati in un indice
POST /indexes('[index name]')/docs/index?api-version=2015-02-28
Ricerca
GET /indexes('[index name]')/docs?[query parameters]
Ricerca
GET /indexes('[index name]')/docs('[key]')?[query parameters]
Numero
GET /indexes('[index name]')/docs/$count?api-version=2015-02-28
Suggerimenti
GET /indexes('[index name]')/docs/suggest?[query parameters]