Jaa

Liittimen kehittäminen Power Query SDK:n avulla

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:

  • Power BI Desktopin

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 HelloWorld.Contents() (kuten sen, letmitä 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 yhdistimien itsejakelu

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 yhdistimet voidaan ladata kahteen 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 Desktop: power BI Desktopin kaltaisissa kokemuksissa.

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

  • Last updated on