Jaa

Data Factory Connector -sertifiointi

  • Artikkeli

Tärkeä

Liittimen sertifiointiohjelmaan tehdään parhaillaan muutoksia ja uusien liitinsertifiointien rekisteröinti on tällä hetkellä jäissä. Tämä artikkeli päivitetään, kun liittimen sertifiointiohjelma avautuu uudelleen uusille kumppaneille. Jos sinulla on sertifioitu liitin, jonka haluat päivittää, kysy tiimiltämme dataconnectors@microsoft.com ohjeet uuden version lähettämiseen. Lähetys käsitellään joka kuukausi, ja lähetysten päättymispäivä on jokaisen kuukauden ensimmäinen tiistai.

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. Nämä ehdot voidaan täyttää 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.

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

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

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.