Sertifisering av Data Factory Connector

Datakildeeiere som utvikler en egendefinert kobling for datakilden, vil kanskje distribuere den egendefinerte koblingen bredere til Data Factory-brukere. Når en egendefinert kobling er opprettet, brukt og validert av sluttbrukere, kan eieren av datakilden sende den inn for Microsoft-sertifisering.

Sertifisering av en Data Factory-kobling gjør koblingen tilgjengelig offentlig, out-of-box, Microsoft Fabric Data Factory og Microsoft Power BI i følgende opplevelser:

• Microsoft Fabric Dataflow Gen2
• Microsoft Power BI Dataflow Gen1
• Microsoft Power BI Datamart
• Semantisk Microsoft Power BI-modell (i Power BI-tjenesten)
• Microsoft Power BI Desktop
• Lokal datagateway for Microsoft Fabric og Microsoft Power BI

Sertifiserte koblinger er:

• Vedlikeholdt av partnerutvikleren

• Støttes av partnerutvikleren

• Sertifisert av Microsoft

• Distribuert av Microsoft

Vi samarbeider med partnere for å prøve å sikre at de har støtte i vedlikehold, men kundeproblemer med selve koblingen sendes til partnerutvikleren.

Sertifiseringsoversikt

Forutsetning

For å sikre den beste opplevelsen for kundene våre, vurderer vi bare koblinger som oppfyller et sett med forutsetninger for sertifisering:

• Koblingen må være for et offentlig produkt.

• Koblingen må betraktes som kodefull for en første versjon. Programmet gir mulighet for hyppige gjentakelser og oppdateringer. Microsoft tilbyr ikke teknisk assistanse eller tilpasset konsulent for koblingsutvikling. Vi anbefaler at du bruker offentlige ressurser som SDK-dokumentasjon og eksempelrepositorium. Hvis du trenger mer hjelp, kan vi dele en liste over kjente tredjeparts bransjetilpassede koblingsutviklingskonsulenter som du kanskje vil engasjere deg direkte, atskilt fra et hvilket som helst Microsoft-program eller partnerskap. Microsoft er ikke tilknyttet noen av disse konsulentene og er ikke ansvarlig for din bruk av tjenestene. Microsoft leverer listen for enkelhets skyld og uten noen forsikringer, anbefalinger eller garantier. Hvis du vil ha mer informasjon, kan du ta kontakt med Microsoft-sertifiseringskontakten.

• Utvikleren må gi et estimat for gjeldende og fremtidig bruk.

• Koblingen må allerede gjøres tilgjengelig for kunder direkte for å oppfylle et brukerbehov eller forretningsscenario. Dette vilkåret kan oppfylles ved hjelp av et forhåndsvisningsprogram ved å distribuere den fullførte koblingen direkte til sluttbrukere og organisasjoner. Vi foreslår at utviklere av koblinger bruker en selvdistribusjonsmekanisme og kjører intern testing av sine egne koblinger for å iterere over koblingene under en kontrollert gruppe. Hver bruker eller organisasjon skal kunne gi tilbakemelding og validering om at det er et forretningsbehov for koblingen, og at koblingen fungerer for å oppfylle forretningskravene.

• Koblingen må fungere på et forventet bruksnivå av kunder.

• Det må være en tråd i Fabric Ideas-forumet drevet av kunder for å indikere etterspørselen etter å gjøre koblingen offentlig tilgjengelig i Data Factory og / eller Power BI. Det er ingen angitt terskel for forhandling. Men jo mer engasjement, jo sterkere den dokumenterte etterspørselen etter koblingen.

Disse forutsetningene finnes for å sikre at koblinger som gjennomgår sertifisering, har betydelige kunder og bedrifter som må brukes til og støttes etter sertifisering.

Sertifiseringskrav

Vi har et bestemt sett med krav til sertifisering. Vi innser at ikke alle utviklere kan oppfylle disse kravene, og vi håper å introdusere et funksjonssett som vil håndtere utviklerbehov i kort rekkefølge.

Funksjoner og stil

Koblingen må følge et sett med funksjons- og stilregler for å oppfylle en brukervennlighetsstandard i samsvar med andre sertifiserte koblinger.

• Koblingen MÅ:

  • Bruk inndelingsdokumentformat.
  • Inneholder en versjonsoverskrift/pryd over inndelingsdokumentet.
  • Angi metadata for funksjonsdokumentasjon.
  • Ha TestConnection-behandling.
  • Følg navnekonvensjoner (for eksempel DataSourceKind.FunctionName). Den bør ikke inneholde ord som Fabric, Power BI, Connector eller API.
  • Returner data i tabellformat, organisert i tabeller med kolonner, som for en relasjonsdatakilde. Flerdimensjonale formater basert på kuber, dimensjoner og mål støttes ikke.
  • Oppfører seg likt i import- og DirectQuery-modus, og returnerer identiske resultater.
  • La Beta-flagget være satt til Sann ved første utgivelse.

• Det FunctionName bør være fornuftig for domenet (for eksempel «Innhold», «Tabeller», «Dokument», «Databaser» og så videre).

• Koblingen BØR:

  • Ha ikoner.
  • Angi en navigasjonstabell.
  • Plasser strenger i en resources.resx fil. URL-adresser og verdier bør være hardkodet i koblingskoden og ikke plasseres i resources.resx filen.

Sikkerhet

Det finnes bestemte sikkerhetshensyn som koblingen må håndtere.

• Hvis Extension.CurrentCredentials() brukes:

  • Kreves bruken? I så fall, hvor sendes legitimasjonen til?
  • Er forespørslene garantert å bli gjort via HTTPS?
    • Du kan bruke https håndhevelseshjelperfunksjonen.
  • Hvis legitimasjonen sendes via Web.Contents() GET:
    • Kan det gjøres om til et INNLEGG?
    • Hvis GET er nødvendig, må koblingen bruke CredentialQueryString posten i Web.Contents() alternativposten til å sende inn sensitiv legitimasjon.

• Hvis diagnosedata.* brukes :

  • Valider det som spores. data kan ikke inneholde PII eller store mengder unødvendige data.
  • Hvis du implementerte betydelig sporing i utvikling, bør du implementere et variabel- eller funksjonsflagg som bestemmer om sporing skal være på. Denne sporingen må deaktiveres før du sender inn for sertifisering.

• Hvis Expression.Evaluate() brukes:

  • Valider hvor uttrykket kommer fra, og hva det er (det vil eksempel: dynamisk konstruere kall til Extension.CurrentCredentials()og så videre).
  • Brukeren Expression må ikke oppgis eller ta inndata fra brukeren.
  • Den Expression skal ikke være dynamisk (det vil eksempel: hentet fra en nettsamtale).

Etter sertifisering

Når koblingen er sertifisert og utgitt via Microsoft Fabric- og Microsoft Power BI-opplevelser, er det et par ting du bør gjøre for å sikre at du kan bruke den offentlig tilgjengelige, sertifiserte koblingen på riktig måte.

• Du og sluttbrukere bør bruke den sertifiserte koblingsversjonen som er inkludert i miljøer før sertifisering (for eksempel Power BI Desktop og datagatewayen), og fjerne eventuelle eksisterende .mez- eller .pqx-filer (egendefinerte koblinger) som ble brukt før sertifisering. Hvis du ikke gjør dette, kan det føre til at den egendefinerte testkoblingen brukes av Power Query utilsiktet i stedet for den nylig sertifiserte koblingen.
• Egendefinerte koblinger bør bare brukes til å teste nye versjoner av koblingen.
• Når du arbeider med sluttbrukere og kunder, må du sørge for at de forstår den egendefinerte koblingsversjonen som ble brukt i testingen før sertifisering, bør fjernes etter at testingen er fullført, og at den nye sertifiserte koblingsversjonen er tilgjengelig.