Pāriet uz galveno saturu

Pielāgoti OData vaicājumi

Gan uz aktīviem vērsts OData pakalpojums, gan datu modelēšanas OData pakalpojums atbalsta pielāgotus vaicājumus, tāpēc tajos var filtrēt rekvizītus, kā arī izgūt noteiktu datu kopas.

Pielāgotu vaicājumu URL​

Uz aktīviem vērsta OData pakalpojuma piemērs​

Lai filtrētu pēc resursa tipa rekvizīta:

GET .../{resourceType}/?$filter={Filter}

Kur:

  • {resourceType}: resursa tips, piemēram Assets, TimeSeries, Events utt.
  • {Filter}: OData filtra izteiksme.

Datu modelēšanas OData pakalpojuma piemērs​

Lai filtrētu datu modeļa view rekvizītu:

GET .../{view}/?$filter={Filter}

Kur:

  • {view}: view nosaukums jūsu datu modelī.
  • {Filter}: OData filtra izteiksme.

Pielāgotu vaicājumu piemēri​

Vienkāršs atbilstības filtrs​

Atbilstības filtram tiek izmantots formāts AttributeName eq 'AttributeValue':

GET .../Assets?$filter=Name eq '23-TE-96116-04'

Datu modelēšanas filtri​

Filtrs, kas tiek lietots tieši datu modeļa rekvizītam view:

GET .../City?$filter=iso2 eq 'MX'

Metadatu filtrēšana​

Metadatu gadījumā tiek filtrēti metadatu objektā ligzdotie rekvizīti.

GET .../Assets?$filter=MetaData/RES_ID eq '525283'

Apvienotais filtrs​

GET .../Assets?$filter=MetaData/RES_ID eq '525283' and Name eq '23-TE-96116-04'

Funkciju izmantošana filtros​

OData atbalsta tādas funkcijas kā startswith, endswith un contains.

Piemēram, lai filtrētu laika rindas, kur ExternalId sākas ar 'Sensor':

GET .../TimeSeries?$filter=startswith(ExternalId,'Sensor')

Piezīme. Ne visas funkcijas tiek atbalstītas novirzīšanai uz CDF. Pārbaudiet konkrētā resursa tipa filtrēšanas iespējas.

Vairāku vaicājuma parametru apvienošana​

Lai izgūtu vēl precīzākus datus, varat apvienot vairākas vaicājumu opcijas.

Piemēram, lai izgūtu aktīvus, kur Name sākas ar 'Pump', atlasiet tikai Id un Name un kārtojiet tos pēc Name:

GET .../Assets?$filter=startswith(Name,'Pump')&$select=Id,Name&$orderby=Name asc

Pielāgotu vaicājumu atkļūdošana​

  • Izmantojiet atsevišķus rīkus. Ar tādu rīku kā Fiddler iespējams pārbaudīt HTTP datplūsmu starp klientu un serveri.
  • Pārbaudiet filtru sintaksi. Pārliecinieties, ka filtri ir formatēti saskaņā ar OData specifikāciju.
  • Pārskatiet atbalstītos filtrus. Skatiet sadaļu Vienumu filtrēšana datu modeļos un Uz aktīviem vērstu resursu veidu filtrēšana, lai uzzinātu par OData pakalpojumu atbalstītajām filtrēšanas iespējām.

Ierobežojumi​

Ne visas OData funkcijas un līdzekļi tiek atbalstīti. Sīkāku informāciju par atbalstītajām funkcijām un ierobežojumiem skatiet attiecīgā pakalpojuma dokumentācijā .

Pēdējoreiz atjaunināts:,