Jaa

Data Factory Connector -sertifiointi

  • Artikkeli

Muistiinpano

Tässä artikkelissa kuvataan Data Factory -liittimen sertifioinnin edellytykset ja lähettämisprosessi. Lue koko artikkeli ennen sertifiointiprosessin aloittamista.

Tietolähteen omistajat, jotka kehittävät tietolähteelleen mukautetun liittimen, haluavat ehkä jakaa mukautetun liittimensä laajemmin Data Factory -käyttäjille. Kun loppukäyttäjät ovat luoneet, käyttäneet ja vahvistaneet mukautetun liittimen, tietolähteen omistaja voi lähettää sen Microsoftin sertifiointiin.

Data Factory -liittimen sertifiointi tuo liittimen yleisesti saataville valmiina Microsoft Fabric Data Factoryna ja Microsoft Power BI:nä seuraavissa käyttökokemuksissa:

  • Microsoft Fabric -tietovuo Gen2
  • Microsoft Power BI -tietovuo Gen1
  • Microsoft Power BI Datamart
  • Semanttinen Microsoft Power BI -malli (Power BI -palvelussa)
  • Microsoft Power BI Desktop
  • Paikallinen tietoyhdyskäytävä Microsoft Fabricille ja Microsoft Power BI:lle

Sertifioidut liittimet ovat seuraavat:

  • Kumppanikehittäjän ylläpitämä

  • Kumppanikehittäjän tukema

  • Microsoftin sertifioima

  • Microsoftin jakelema

Pyrimme yhdessä kumppaneiden kanssa varmistamaan, että niillä on tuki ylläpidossa, mutta itse liittimeen liittyvät asiakasongelmat ohjataan kumppanikehittäjälle.

Muistiinpano

Tällä hetkellä voit power query SDK:n avulla luoda liittimen, joka voidaan sertifioida Data Factory -liittimen sertifiointiohjelman kautta. Siirry Power Query SDK:n yleiskatsaukseen , niin saat lisätietoja tästä työkalusta.

Sertifioinnin yleiskatsaus

Edellytykset

Jotta voimme varmistaa asiakkaillemme parhaan mahdollisen käyttökokemuksen, harkitsemme vain liittimiä, jotka täyttävät sertifioinnin edellytykset:

  • Liittimen on oltava julkista tuotetta varten.

  • Liittimen on katsottava olevan koodin valmis ensijulkaisuversiota varten. Ohjelma mahdollistaa usein toistuvat iteraatiot ja päivitykset. Microsoft ei tarjoa teknistä apua tai mukautettujen liittimien kehityskonsultointia. Suosittelemme käyttämään julkisia resursseja, kuten SDK-dokumentaatiota ja mallisäilöä. Jos tarvitset lisäapua, voimme jakaa luettelon tunnetuista kolmannen osapuolen toimialan mukautetun liittimen kehityskonsulteista, joiden haluat ehkä ryhtyä suoraan yhteistyöhön, erilleen Microsoft-ohjelmasta tai -kumppanuudesta. Microsoft ei ole sidoksissa näihin konsultteihin, eikä se vastaa heidän palveluidensa käytöstä. Microsoft tarjoaa luettelon avuksesi ja ilman takeita, suosituksia tai takeita. Saat lisätietoja ottamalla yhteyttä Microsoft-sertifiointikontaktiin.

  • Kehittäjän on annettava arvio nykyisestä ja tulevasta käytöstä.

  • Liittimen on oltava suoraan asiakkaiden käytettävissä, jotta käyttäjä tarvitsee tai toteuttaa liiketoimintaskenaarion. Tämä ehto voidaan täyttää yksityisellä esikatseluohjelmalla jakamalla valmis liitin suoraan käyttäjille ja organisaatioille. Suosittelemme, että liittimien kehittäjät käyttävät itsejakaumamekanismia ja suorittavat omien liittimien sisäisen testauksen iteroidakseen liittimiään valvotussa ryhmässä. Kunkin käyttäjän tai organisaation pitäisi pystyä antamaan palautetta ja vahvistusta siitä, että liittimen liiketoimintatarve on olemassa ja että liitin toimii onnistuneesti liiketoimintavaatimusten täyttämiseksi.

  • Liittimen on toimittava onnistuneesti odotetulla asiakkaiden käyttötasolla.

  • Fabric Ideas -keskustelupalstalla on oltava keskusteluketju, jonka vetäjänä ovat asiakkaat, jotta liitin olisi julkisesti saatavilla Data Factoryssa ja/tai Power BI:ssä. Osallistumisen kynnystä ei ole määritetty. Mitä enemmän sitoutumista kuitenkin on, sitä vahvempi todistettu kysyntä liittimelle.

Näiden edellytysten avulla voidaan varmistaa, että sertifioitavien liittimien käytössä on merkittävä asiakas ja liiketoiminta, ja että niitä on käytettävä sertifioinnin jälkeen ja että niitä on tuettava sen jälkeen.

Prosessi ja aikajanat

Sertifioidut liittimet julkaistaan Power BI Desktopin kuukausittaisten julkaisujen myötä, joten kunkin julkaisuversion määräajat ovat peräisin kustakin Power BI Desktop -julkaisupäivämäärästä. Sertifiointiprosessin odotettu kesto rekisteröinnistä julkaisuun vaihtelee liittimen lähetyksen laadun ja monimutkaisuuden mukaan. Microsoft ei tarjoa mitään erityisiä aikajanatakuita liittimen tarkistamisesta ja hyväksynnästä. Kunkin liittimen tarkistuksen määräajat on määritetty seuraavissa vaiheissa, mutta Microsoft ei takaa näiden aikajanan noudattamista.

  • Rekisteröinti: ilmoitus aikomuksesta sertifioida mukautettu liitin. Tämän rekisteröinnin on tapahduttava kuukauden 15. päivä, kaksi kuukautta ennen kohdennettua Power BI Desktop -julkaisua.

    • Esimerkiksi huhtikuun Power BI Desktop -julkaisun määräaika on 15. helmikuuta.

  • Lähetys: liitintiedostojen lähettäminen Microsoft review'ta varten. Tämän lähetyksen on tapahduttava kohteena olevaa Power BI Desktop -julkaisua edeltävän kuukauden ensimmäiseen versioon mennessä.

    • Esimerkiksi huhtikuun Power BI Desktop -julkaisun määräaika on 1. maaliskuuta.

  • Tekninen katsaus: liitintiedostojen viimeistely, Microsoftin tarkistuksen ja sertifioinnin välittäminen. Tämä tarkistus on tehtävä 15. kuukauteen mennessä ennen kohdennettua Power BI Desktop -julkaisua.

    • Esimerkiksi huhtikuun Power BI Desktop -julkaisun määräaika on 15. maaliskuuta.

Teknisten tarkistusten ja mahdollisten viiveiden, uudelleenjärjestelyn ja testausongelmien monimutkaisuuden vuoksi suosittelemme, että lähetät aikaisessa vaiheessa ensimmäistä julkaisua ja sertifiointia varten pitkän toimitusajan.

Sertifioinnin edellytykset

Sertifioinnille on tiettyjä vaatimuksia. Ymmärrämme, että kaikki kehittäjät eivät täytä näitä vaatimuksia, ja toivomme, että otamme käyttöön ominaisuusjoukon, joka käsittelee kehittäjän tarpeita lyhyessä järjestyksessä.

Lähetystiedostot (artefaktit)

Varmista, että lähetykseesi sisältyy seuraavat liitintiedostot:

  • Liitintiedosto (.mez)

    • .mez-tiedoston tulee noudattaa tyylistandardeja ja nimetä samalla tavalla kuin tuotteen tai palvelun nimi. Sen ei pitäisi sisältää sanoja kuten "Fabric", "Power BI", "Connector" tai "API".
    • Anna .mez-tiedoston nimeksi: ProductName.mez

  • Power BI Desktop (.pbix) -tiedosto testausta varten

    • Liittimen testaamiseen tarvitaan Power BI -malliraportti (.pbix).
    • Raportin tulee sisältää vähintään yksi kysely, jotta voit testata jokaista siirtymistaulukon kohdetta.
    • Jos määritettyä rakennetta (esimerkiksi tietokantoja) ei ole, raportissa on oltava kysely kullekin liittimen mahdollisesti käsittelemille taulukkotyypeille.

  • Testaa tili tietolähteeseen

    • Käytämme testitiliä liittimen testaamiseen ja vianmääritykseen.
    • Anna testitili, joka on pysyvä, jotta voimme sertifioida tulevat päivitykset samalla tilillä.

  • Testausohjeet

    • Anna ohjeet liittimen käyttöön ja sen toiminnan testaamiseen.

  • Ulkoisiin riippuvuuksille viittaavat linkit (esimerkiksi ODBC-ohjaimet)

Ominaisuudet ja tyyli

Liittimen on noudatettava joukkoa ominaisuuksia ja tyylisääntöjä, jotta se täyttää käytettävyysstandardin, joka on yhdenmukainen muiden sertifioitujen liittimien kanssa.

  • Liittimen TÄYTYY:

    • Käytä osan asiakirjamuotoa.
    • Sisällytä versio-otsikko tai - koriste osan asiakirjan yläpuolelle.
    • Anna funktiodokumentaation metatiedot.
    • Tarvitset Testiyhteys-käsittelijän.
    • Noudata nimeämiskäytäntöjä (esimerkiksi DataSourceKind.FunctionName). Sen ei pitäisi sisältää sanoja kuten "Fabric", "Power BI", "Connector" tai "API".
    • Palauta tiedot taulukkomuodossa järjestettynä taulukoihin, joissa on sarakkeita, kuten relaatiotietolähteelle. Kuutioihin, dimensioihin ja mittareihin perustuvia monidimensiomuotoja ei tueta.
    • Toimi samalla tavalla tuonti- ja DirectQuery-tilassa ja palauta identtiset tulokset.
    • Aseta beetamerkintä tosi-arvoksi ensimmäisen julkaisun yhteydessä.

  • - FunctionName kentän tulisi olla toimialueen kannalta järkevä (esimerkiksi "Sisältö", "Taulukot", "Asiakirja", "Tietokannat" ja niin edelleen).

  • Liittimen PITÄISI:

    • Sinulla on kuvakkeita.
    • Anna siirtymistaulukko.
    • Sijoita merkkijonot tiedostoon resources.resx . URL-osoitteet ja arvot on koodata kiinteästi liittimen koodissa, eikä niitä saa sijoittaa tiedostoon resources.resx .

Suojaus

On tiettyjä suojausnäkökohtia, jotka liittimesi on käsiteltävä.

  • Jos Extension.CurrentCredentials() on käytössä:

    • Onko käyttö tarpeen? Jos näin on, minne tunnistetiedot lähetetään?
    • Tehdäänkö pyyntöjä VARMASTI HTTPS:n kautta?
    • Jos tunnistetiedot lähetetään get-toiminnon kautta Web.Contents() :
      • Voiko siitä tehdä POST-työn?
      • Jos GET-funktio on pakollinen, liittimen on käytettävä CredentialQueryString asetustietueen Web.Contents() tietuetta luottamuksellisten tunnistetietojen välittämiseen.

  • Jos Diagnostics.* -funktioita käytetään:

    • Tarkista, mitä jäljitetään; tiedot eivät saa sisältää PII-tietoja eivätkä suuria määriä tarpeettomia tietoja.
    • Jos olet ottanut käyttöön merkittävän jäljityksen kehityksessä, ota käyttöön muuttuja tai ominaisuusmerkintä, joka määrittää, pitääkö jäljityksen olla käytössä. Tämä jäljitys on poistettava käytöstä ennen sertifiointiin lähettämistä.

  • Jos Expression.Evaluate() on käytössä:

    • Varmista, mistä lauseke on peräisin ja mikä se on (eli voit dynaamisesti muodostaa kutsuja ön Extension.CurrentCredentials()ja niin edelleen).
    • - Expression arvoa ei tule antaa käyttäjälle eikä antaa käyttäjän syötettä.
    • Expression-kentän ei pitäisi olla dynaaminen (eli noudettu verkkokutsusta).

Rekisteröinti sertifiointiin

Jos olet kiinnostunut mukautetun liittimen sertifioinnin jatkamisesta, varmista, että skenaariosi ja liittimesi täyttävät tässä artikkelissa kuvatut edellytykset ja vaatimukset . Jos näin ei tehdä, tämä aiheuttaa viiveitä sertifioinnissa, sillä tiimimme edellyttää, että korjaat mahdolliset ongelmat tai epäyhtenäisyyksien ennen sertifioinnin jatkamista.

Varmista, että liittimesi on koodi valmis ja että se on testattu sekä Power BI Desktopin luomisessa että päivityksessä ja käytössä Power BI -palvelussa. Varmista, että olet testannut koko päivityksen kokonaan Power BI -palvelussa paikallisen tietoyhdyskäytävän avulla.

Aloita täyttämään rekisteröintilomake, niin Microsoftin yhteyshenkilö ottaa yhteyttä aloittaakseen prosessin.

Sertifioinnin jälkeen

Kun liittimesi on sertifioitu ja julkaistu Microsoft Fabricin ja Microsoft Power BI:n kautta, sinun kannattaa varmistaa, että voit käyttää oikein tuotannon käyttöön otettua julkisesti saatavilla olevaa sertifioitua liitintä.

  • Sinun ja loppukäyttäjien tulee käyttää sertifioitua liitinversiota, joka on mukana ympäristöissä ennen sertifiointia (kuten Power BI Desktop ja tietoyhdyskäytävä), ja poistaa kaikki olemassa olevat .mez- tai .pqx-tiedostot (mukautetut liittimet), joita käytettiin ennen sertifiointia. Jos näin ei tehdä, Power Query käyttää testin mukautettua liitintä tahattomasti uuden sertifioidun liittimen sijaan.
  • Mukautettuja liittimiä tulee käyttää vain liittimen uusien versioiden testaamiseen.
  • Kun käsittelet loppukäyttäjiä ja asiakkaita, varmista, että he ymmärtävät, miten testauksessa ennen sertifiointia käytetty mukautettu liitinversio tulee poistaa testauksen jälkeen ja uusi sertifioitu liitinversio on saatavilla.