Jaa

Liittimen kehittäminen Power Query SDK:n avulla

  • Artikkeli

Power Query SDK on joukko työkaluja, joiden avulla voit luoda Power Query -liittimiä. Näitä liittimiä kutsutaan usein mukautetuiksi liittiminä tai Power Query -laajennuksina.

Mukautettujen liittimien avulla voit luoda uusia tietolähteitä tai mukauttaa ja laajentaa olemassa olevaa lähdettä. Yleisiä käyttötapauksia ovat seuraavat:

  • Yritysanalyytikkoja suosivan näkymän luominen REST-ohjelmointirajapinnalle.
  • Tuotemerkin tarjoaminen lähteelle, jota Power Query tukee olemassa olevalla liittimellä (kuten OData-palvelulla tai ODBC-ohjaimella).
  • OAuth v2 -todentamisen työnkulun toteuttaminen SaaS-tarjoomalle.
  • Rajoitetun tai suodatetun näkymän näyttäminen tietolähteestä käytettävyyden parantamiseksi.
  • DirectQueryn käyttöönotto tietolähteelle ODBC-ohjaimen avulla.

Power Query SDK:n asentaminen

Asenna Visual Studio Code Power Query SDK Visual Studio Marketplacen Visual Studio Code -osiosta. Asenna SDK valitsemalla Asenna .

Näyttöyhteys täi kehitysprosessi

Seuraavissa osioissa kuvataan korkealla tasolla yleisin prosessi Power Query -liittimen luomiseksi SDK:n avulla.

Uuden laajennuksen luominen

Kun luot uutta työtilaa (Visual Studio Code Power Query SDK), aloitat seuraavista ydintiedostoista:

  • Näyttöyhteys or-määritystiedosto (<connectorName.pq>)
  • Kyselytiedosto (<connectorName.query.pq>)
  • Merkkijonon resurssitiedosto (resources.resx)
  • Kuvakkeiden luonnissa käytettävät erikokoiset PNG-tiedostot

Liittimen määritystiedosto alkaa tyhjällä tietolähteen kuvauksella. Saat lisätietoja tietolähteestä Power Query SDK:n kontekstissa tietojen käytön käsittelyä käsittelevästä artikkelista.

Testataan

Power Query SDK tarjoaa kyselyn suorittamisen perusominaisuudet, joiden avulla voit testata laajennustasi vaihtamatta Power BI Desktopiin.

Kyselytestitiedostosta

Laajennustiedoston lisäksi Data Näyttöyhteys or-projekteissa voi olla kyselytiedosto (name.query.pq). Tämän tiedoston avulla voidaan suorittaa testikyselyitä Visual Studio Codessa. Kyselyn arviointi sisältää automaattisesti laajennuskoodisi ilman. Sinun ei tarvitse rekisteröidä.pqx-tiedostoa, joten voit kutsua tai testata mitään jaettuja funktioita laajennuskoodissasi.

Kyselytiedosto voi sisältää yhden lausekkeen (esimerkiksi), lausekkeen let (kuten sen, HelloWorld.Contents()mitä Power Query loisi) tai osaasiakirjan.

Koonti ja käyttöönotto

Projektin rakentaminen tuottaa .mez-tiedoston tai laajennustiedoston.

Power Query -laajennukset niputetaan ZIP-tiedostoon ja niille annetaan .mez-tiedostotunniste. Power BI Desktop lataa suorituksen aikana laajennuksia kohteesta [Documents]\Microsoft Power BI Desktop\Custom Näyttöyhteys ors.

Muistiinpano

Tietojen Näyttöyhteys projektit eivät tue mukautetun julkaisun koontivaiheita laajennustiedoston kopioimiseksi [Tiedostot]\Microsoft Power BI Desktop\Custom Näyttöyhteys ors -hakemistoosi. Jos haluat tehdä tämän, haluat ehkä käyttää kolmannen osapuolen laajennusta.

Laajennukset määritetään M-osan asiakirjassa. Osan asiakirja on muotoltaan hieman erilainen kuin Power Queryssa luodut kyselyasiakirjat. Power Querystä tuotava koodi edellyttää yleensä muokkausta osan asiakirjaan, mutta muutokset ovat vähäisiä. Osan asiakirjan erot, jotka sinun tulee ottaa huomioon, ovat seuraavat:

  • Ne alkavat osa-esittelyllä (esimerkiksi section HelloWorld;).
  • Jokainen lauseke päättyy puolipisteeksi (esimerkiksi a = 1; tai b = let c = 1 + 2 in c;).
  • Kaikki funktiot ja muuttujat ovat paikallisia osan asiakirjassa, ellei niitä ole merkitty jaetuiksi. Jaetut funktiot tulevat näkyviin muille kyselyille/funktioille, ja niitä voidaan ajatella laajennuksen vientinä (eli niistä tulee kutsuttavia Power Querysta).

Lisätietoja M-osan asiakirjoista löytyy M-kielen määrityksestä.

Tietoliittimien jakauma

Power Query -liittimiä voidaan käyttää Power BI Desktopissa tai Power Query Online -käyttökokemuksessa, kuten Power BI -tietovoissa, Power BI -tietomalleissa ja muissa käyttökokemuksissa.

Power BI Desktop

Power BI Desktopin käyttäjät voivat käyttää Power Queryn mukautettua liitintä noudattamalla seuraavia ohjeita:

  1. Kopioi laajennustiedosto (.mez tai.pqx) tiedostoon [Tiedostot]/Power BI Desktop/Custom Näyttöyhteys ors.
  2. Valitse Power BI Desktopissa (Ei suositeltu) Salli minkä tahansa laajennuksen lataaminen ilman vahvistusta tai varoitusta -vaihtoehto kohdassa TiedostoAsetukset>ja vaihtoehdot>Asetukset>Tietoturvatietolaajennukset.>
  3. Käynnistä Power BI Desktop uudelleen.

Power BI Desktop lataa laajennukset automaattisesti uudelleenkäynnistyksen jälkeen.

Vaihtoehtoisesti voit tietolähteen ja liittimen omistajana lähettää liittimesi Power Query Näyttöyhteys tai sertifiointiohjelmaan, jotta se toimitetaan Power BI Desktopin kanssa joka julkaisuversiossa.

Power Query Online

Power Query Onlinessa näytetään vain sertifioidut Power Query -liittimet. Jos haluat lisätietoja Power Query -liittimen sertifiointiohjelmasta, siirry kohtaan Power Query Näyttöyhteys tai sertifiointi.