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 .

Liittimen 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:

  • Liittimen 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 perussuoritusominaisuuksia, joiden avulla voit testata laajennustasi vaihtamatta toiseen asiakassovellukseen. Voit testata liitintä tarkemmin esimerkiksi seuraavassa sovelluksessa:

Kyselytestitiedostosta

Laajennustiedoston lisäksi Data Connector -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.

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ä.

Power Query -liittimien jakelu

Sinulla on kaksi polkua, joiden kautta voit jakaa liittimen:

  • Itsejakauma
  • Liitinsertifiointi

Itsejakauma

Omatoiminen mekanismi, jossa voit käyttää Power Queryn mukautettuja liittimiä soveltuvissa tuotekokemuksissa

Kun liitin on luotu, voit lähettää tämän tiedoston haluamallasi tavalla käyttäjille. He voivat käyttää liitintä soveltuvissa tuotekokemuksissa, kuten Microsoft Power BI:ssä.

Microsoft Power BI

Voit käyttää omia mukautettuja liittimiäsi Microsoft Power BI Desktopissa ja Microsoft Power BI -palvelun semanttisissa malleissa päivittämiseen ja liittämiseen pilvipalvelussa.

Power Query -liittimet voidaan ladata kolmeen käyttökokemukseen:

  • Paikallinen tietoyhdyskäytävä: Liitin voidaan ladata yhdyskäytävän kautta Microsoft Fabric- ja Microsoft Power BI -palveluissa käytettäväksi
  • Power Query Online: käyttökokemuksissa, kuten Power BI Datamarts, Fabric Dataflow Gen2 ja monet muut
  • Power Query Desktop: power BI Desktopin kaltaisissa kokemuksissa.

Lisätietoja mukautetun liittimen käyttämisestä itsejakeluun on seuraavissa artikkeleissa:

Liitinsertifiointi

Data Factory -liittimen sertifiointiohjelman avulla voit lähettää liittimesi Microsoftin sertifiointiin, jossa Microsoft huolehtii liittimesi julkaisemisesta ja jakamisesta sekä Microsoft Fabricissa että Microsoft Power BI:ssä soveltuvissa tuotteissa ja käyttökokemuksissa:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Microsoft Fabric -tietovuo Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI -tietovuo Gen1 ja muut
  • Paikallinen tietoyhdyskäytävä: Sekä Microsoft Fabricille että Microsoft Power BI:lle, jotka käyttävät yhdyskäytävää todennettuun päivitykseen tai yhteyteen.

Lue lisätietoja Data Factory Connector -sertifiointiohjelmasta.