Power BI REST API funkcijas

Šajā rakstā ir detalizēti aprakstītas pieejamās Power BI REST API funkcijas.

Beta

Šajā sadaļā aprakstītie līdzekļi noteiktiem lietotājiem pašlaik ir beta testēšanas stadijā un var tikt mainīti.

GetCDF

Izmantojiet šo funkciju, lai ienestu datus no CDF API, izmantojot HTTP GET metodi. Funkcija automātiski segmentē CDF, līdz pieprasījuma kursors ir visu izdarījis. Lai nodrošinātu optimālu veiktspēju, skatiet Cognite API specifikāciju galapunktiem, kas atbalsta šo HTTP metodi, un maksimālo atbalstīto lapas izmēru katram galapunktam.

Parametrs	Tips	Apraksts
url	Teksts	URL ceļš pieprasījuma veikšanai, kas atrodas tieši blakus projekta nosaukumam. Piemēri: "/timeseries", "/assets".

PostCDF

Ar šo funkciju varat ienest datus no CDF API, izmantojot HTTP POST metodi. Funkcija automātiski segmentē CDF, līdz pieprasījuma kursors ir visu izdarījis. Lai nodrošinātu optimālu veiktspēju, skatiet Cognite API specifikāciju galapunktiem, kas atbalsta šo HTTP metodi.

Parametrs	Tips	Apraksts
url	Teksts	URL ceļš pieprasījuma veikšanai, kas atrodas tieši blakus projekta nosaukumam. Piemēri: "/timeseries/list", "/assets/list".
body	Teksts	JSON pamatteksta attēlojums, kas jānosūta kopā ar pieprasījumu. Piemēri: "{}", "{"limit": 1000}". Ja iespējams, iestatiet limit parametru uz maksimālo galapunktam atbalstīto vērtību. Lai nodrošinātu optimālu veiktspēju, skatiet Cognite API specifikāciju. Izsaucot šo funkciju ar Power BI, vaicājums tiek parādīts kā vairākrindu teksta apgabals. Dubultpēdiņas ir pieļaujamas. Ja norādāt nederīgu JSON pamattekstu, funkcija rādīs CogniteConnectorError tipa kļūdu.

piezīme

Funkcija PostCDF piedāvā automātisko segmentēšanu vienkāršiem pieprasījumiem, kuros kursora pieprasījums ir pamatteksta augšējā līmenī. Sarežģītākiem pieprasījumiem jums ir jāuzraksta pielāgota segmentēšanas loģika, izmantojot Power Query M valodu. Skatiet rakstu par Power Query funkcijām un vaicājumu piemēriem.

GraphQL

Izmantojiet šo funkciju, lai ar CDF palīdzību ienestu datus no GraphQL datu modeļa.

Parametrs	Tips	Apraksts
space	Teksts	Datu modeļa vietas ārējais ID.
datamodel	Teksts	Datu modeļa ārējais ID.
version	Teksts	Datu modeļa versija.
query	Teksts	Teksta attēlojums GraphQL vaicājumam, kas jānosūta pieprasījumā. Iekļaujiet vaicājumā after:$cursor and pageInfo { hasNextPage endCursor }, lai iespējotu automātisko segmentēšanu. Lai nodrošinātu optimālu veiktspēju, apsveriet iespēju iestatīt first parametru uz 1000 (maksimālā atbalstītā robeža). Piemērs: "query MyQuery($cursor: String) { listMovies(first: 1000, after: $cursor) { items { name } pageInfo { endCursor hasNextPage }}}". Izsaucot šo funkciju ar Power BI, vaicājums tiek parādīts kā vairākrindu teksta apgabals. Dubultpēdiņas ir pieļaujamas. Ja norādāt nederīgu GraphQL vaicājumu, funkcija rādīs CogniteAPIError tipa kļūdu.
variables	Teksts	Teksta attēlojums JSON mainīgajiem, kas jānosūta pieprasījumā. Piemērs: "{""country"": ""Norway""}". Neiekļaujiet parametrā cursor mainīgo variables. To automātiski pārvalda savienotājs. Ja norādāt nederīgu JSON pamattekstu, funkcija rādīs CogniteConnectorError tipa kļūdu.

piezīme

Funkcija GraphQL piedāvā automātisko segmentēšanu GraphQL vaicājumiem, kas ietver tikai vienu vaicājuma izteiksmi ar vienu segmentēšanas mērķi, ko identificē lauki after: $cursor un pageInfo { hasNextPage endCursor }. Ja vaicājumi ir sarežģītāki, ir jāuzraksta pielāgota segmentēšanas loģika, izmantojot Power Query M valodu. Skatiet arī rakstu Power Query funkcijas un vaicājumu piemēri. Pirms vaicājumu un mainīgo izmantošanas platformā Power BI, vienmēr pārbaudiet tos ar CDF Query Explorer, lai pārliecinātos, ka tie ir pareizi.

ODataCDF

Izmantojiet šo funkciju, lai iegūtu datus no Cognite ODatapakalpojumiem.

Parametrs	Tips	Apraksts
url	Teksts	URL ceļš uz OData pieprasījumu, tostarp projekta nosaukums. Piemēri: "publicdata", "publicdata/Timeseries".
apiVersion	Teksts (nav obligāts)	OData pakalpojuma API versija, ko izmantot ar pieprasījumu. Noklusējums: "v1". Jaunākā uz aktīviem orientētā OData pakalpojuma versija ir "v1". Datu modelēšanas OData pakalpojuma jaunākā versija ir "20230821".

ODataDataModel

Iegūt datus no CDF datu modeļa, izmantojot datu modelēšanas OData pakalpojumu.

Parametrs	Tips	Apraksts
space	Teksts	Datu modeļa vietas ārējais ID.
datamodel	Teksts	Datu modeļa ārējais ID.
version	Teksts	Datu modeļa versija.
apiVersion	Teksts (nav obligāts)	OData pakalpojuma API versija, kas jāizmanto, veicot pieprasījumu. Noklusējums: "20230821". Jaunākā datu modelēšanas OData pakalpojuma versija ir "20230821".