Stöd för OData (Azure AI Search)
Azure AI tjänsten Search API använder Open Data Protocol (OData) för indexfrågor. Azure AI Search stöder OData version 4.
OData-syntax i HTTP-begärandehuvuden
OData definierar några HTTP-begärandehuvuden som du kan ange. Du kan använda OData-specifika värden för Accept-huvudet som application/json;odata.metadata=none
för att styra mängden metadata som ingår i svaret. Standardvärdet är odata.metadata=minimal
. Av utrymmesskäl förutsätter odata.metadata=none
alla exempel i det här dokumentet .
En annan rubrik som du kan ange är OData-MaxVersion
. API:et för Azure AI Search Service stöder OData V4, så du bör ange OData-MaxVersion
till "4.0". Detta instruerar API:et att förvänta sig OData V4-formatet i begärandetexten och att skicka svar i OData V4-format. I framtiden när vi lägger till stöd för nyare versioner av OData-protokollet kan du ange det här huvudet till ett annat värde. Azure AI-tjänsten Search-API:et stöder inte versioner av OData som är äldre än V4.
Mer information om hur du använder OData i filter och sorteringsuttryck finns i OData-uttryckssyntax för Azure AI Search . Se Enkel frågesyntax i Azure AI Search för alternativ syntax.
tjänsten Search API med alternativ OData-syntax
API:et tjänsten Search stöder OData-syntax för entitetssökning. Detta gäller både för både dokument i ett index och för själva indexen (där indexnamnet är entitetsnyckeln). Här är en sammanfattning av alla API:er som har alternativ OData-syntax:
Uppdatera ett index
PUT /indexes('[index name]')?api-version=2015-02-28
Hämta ett index
GET /indexes('[index name]')?api-version=2015-02-28
Hämta indexstatistik
GET /indexes('[index name]')/stats?api-version=2015-02-28
Ta bort ett index
DELETE /indexes('[index name]')?api-version=2015-02-28
Lägga till och ta bort data i ett index
POST /indexes('[index name]')/docs/index?api-version=2015-02-28
Sök
GET /indexes('[index name]')/docs?[query parameters]
Sökning
GET /indexes('[index name]')/docs('[key]')?[query parameters]
Count
GET /indexes('[index name]')/docs/$count?api-version=2015-02-28
Förslag
GET /indexes('[index name]')/docs/suggest?[query parameters]