Del via

Certificering af Data Factory Connector

  • Artikel

Vigtigt

Connectorcertificeringsprogrammet undergår i øjeblikket ændringer, og registreringen af nye connectorcertificeringer er i øjeblikket i venteposition. Denne artikel opdateres, når connectorcertificeringsprogrammet åbnes igen for nye partnere. Hvis du har en certificeret connector, som du vil opdatere, kan du kontakte vores team på dataconnectors@microsoft.com for at få instruktioner om, hvordan du indsender en ny version. Indsendelse behandles hver måned, og skæringsdatoen for indsendelser er den første tirsdag i hver måned.

Ejere af datakilder, der udvikler en brugerdefineret connector til deres datakilde, vil måske distribuere deres brugerdefinerede connector mere bredt til Data Factory-brugere. Når en brugerdefineret connector er oprettet, brugt og valideret af slutbrugerne, kan ejeren af datakilden sende den til Microsoft-certificering.

Certificering af en Data Factory-connector gør connectoren tilgængelig offentligt, klar til brug, Microsoft Fabric Data Factory og Microsoft Power BI i følgende oplevelser:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Semantisk Microsoft Power BI-model (i Power BI-tjenesten)
  • Microsoft Power BI Desktop
  • Datagateway i det lokale miljø til Microsoft Fabric og Microsoft Power BI

Certificerede connectors er:

  • Vedligeholdes af partnerudvikleren

  • Understøttes af partnerudvikleren

  • Certificeret af Microsoft

  • Distribueret af Microsoft

Vi arbejder sammen med partnere for at sikre, at de har support i forbindelse med vedligeholdelse, men kundeproblemer med selve connectoren sendes til partnerudvikleren.

Bemærk

I dag kan du udnytte Power Query SDK til at oprette en connector, der kan certificeres via certificeringsprogrammet for Data Factory-connectoren. Gå over til oversigten over Power Query SDK for at få mere at vide om dette værktøj.

Certificeringsoversigt

Forudsætninger

For at sikre den bedste oplevelse for vores kunder overvejer vi kun connectors, der opfylder et sæt forudsætninger for certificering:

  • Connectoren skal være til et offentligt produkt.

  • Connectoren skal betragtes som kodefuldfør for en indledende version. Programmet giver mulighed for hyppige gentagelser og opdateringer. Microsoft tilbyder ikke teknisk hjælp eller konsulentbistand til udvikling af brugerdefinerede connectors. Vi anbefaler, at du bruger offentlige ressourcer, f.eks. vores SDK-dokumentation og lageret med eksempler. Hvis du har brug for yderligere hjælp, kan vi dele en liste over kendte tredjepartskonsulenter inden for udvikling af brugerdefinerede connectors, som du måske vil engagere direkte, adskilt fra et hvilket som helst Microsoft-program eller -partnerskab. Microsoft er ikke tilknyttet nogen af disse konsulenter og er ikke ansvarlig for din brug af deres tjenester. Microsoft leverer listen til din bekvemmelighed og uden forsikringer, anbefalinger eller garantier. Kontakt din Microsoft-certificeringskontakt for at få mere at vide.

  • Udvikleren skal angive et estimat for aktuelt og fremtidigt forbrug.

  • Connectoren skal allerede være tilgængelig for kunder direkte for at opfylde et brugerbehov eller et forretningsscenarie. Disse kriterier kan opfyldes ved hjælp af et eksempelprogram ved at distribuere den færdige connector direkte til slutbrugere og organisationer. Vi foreslår, at udviklere af connectors bruger en selvdistributionsmekanisme og kører intern test af deres egne connectors for at gentage deres connectors under en kontrolleret gruppe. Hver bruger eller organisation skal kunne give feedback og validering af, at der er et forretningsmæssigt behov for connectoren, og at connectoren fungerer korrekt for at opfylde deres forretningsmæssige krav.

  • Connectoren skal fungere korrekt på et forventet forbrugsniveau for kunderne.

  • Der skal være en tråd i Fabric Ideas-forummet , der er drevet af kunder, for at angive, at der er behov for at gøre connectoren offentligt tilgængelig i Data Factory og/eller Power BI. Der er ingen angivet grænseværdi for engagement. Men jo mere engagement, jo stærkere er den evidenserede efterspørgsel efter connectoren.

Disse forudsætninger er til stede for at sikre, at connectorer, der er certificeret, har en betydelig kunde og virksomhed, der skal bruges til og understøttes efter certificering.

Certificeringskrav

Vi har en række krav til certificering. Vi anerkender, at det ikke er alle udviklere, der kan opfylde disse krav, og vi håber på at introducere et funktionssæt, der håndterer udviklerbehov i kort rækkefølge.

Funktioner og typografi

Connectoren skal følge et sæt funktions- og typografiregler for at opfylde en standard for anvendelighed, der er i overensstemmelse med andre certificerede connectors.

  • ConnectorEN SKAL:

    • Brug dokumentformatet Sektion.
    • Indeholder en versionsoverskrift/-pryd over sektionsdokumentet.
    • Angiv metadata for funktionsdokumentation.
    • Hav TestConnection-handleren.
    • Følg navngivningskonventionerne (f.eks. DataSourceKind.FunctionName). Den må ikke indeholde ord som "Fabric", "Power BI", "Connector" eller "API".
    • Returner data i tabelformat, organiseret i tabeller med kolonner, som for en relationsdatakilde. Flerdimensionelle formater, der er baseret på kuber, dimensioner og målinger, understøttes ikke.
    • Fungerer på samme måde i tilstanden Import og DirectQuery og returnerer identiske resultater.
    • Få betaflaget angivet til Sand ved den indledende version.

  • FunctionName skal give mening for domænet (f.eks. "Indhold", "Tabeller", "Dokument", "Databaser" osv.).

  • Connectoren SKAL:

    • Har ikoner.
    • Angiv en navigationstabel.
    • Placer strenge i en resources.resx fil. URL-adresser og værdier skal hardcodes i connectorkoden og ikke placeres i resources.resx filen.

Sikkerhed

Der er specifikke sikkerhedsovervejelser, som din connector skal håndtere.

  • Hvis Extension.CurrentCredentials() bruges:

    • Er brugen påkrævet? Hvis det er tilfældet, hvor sendes legitimationsoplysningerne så til?
    • Er anmodningerne garanteret at blive foretaget via HTTPS?
    • Hvis legitimationsoplysningerne sendes ved hjælp af Web.Contents() via GET:
      • Kan det omdannes til en POST?
      • Hvis GET er påkrævet, SKAL connectoren bruge posten CredentialQueryString i indstillingsposten Web.Contents() til at overføre følsomme legitimationsoplysninger.

  • Hvis der bruges diagnosticering.* funktioner :

    • Valider, hvad der spores. data må ikke indeholde pii eller store mængder unødvendige data.
    • Hvis du implementerede vigtig sporing under udvikling, skal du implementere en variabel eller et funktionsflag, der bestemmer, om sporing skal være aktiveret. Denne sporing skal være slået fra , før den kan sendes til certificering.

  • Hvis Expression.Evaluate() bruges:

    • Valider, hvor udtrykket kommer fra, og hvad det er (dvs. kan dynamisk konstruere kald til Extension.CurrentCredentials()osv.).
    • Expression skal ikke angives af brugeren eller tage brugerinput.
    • Expression skal ikke være dynamisk (dvs. hentes fra et webopkald).

Efter certificering

Når din connector er certificeret og udgivet via Microsoft Fabric- og Microsoft Power BI-oplevelser, er der et par ting, du skal gøre for at sikre, at du kan bruge den offentligt tilgængelige offentligt tilgængelige certificerede connector korrekt.

  • Du og slutbrugerne skal bruge den certificerede connectorversion, der er inkluderet i miljøer før certificering (f.eks. Power BI Desktop og datagatewayen), og fjerne alle eksisterende .mez- eller .pqx-filer (brugerdefinerede connectors), der bruges før certificeringen. Hvis du ikke gør det, kan det resultere i, at din test af en brugerdefineret connector bruges af Power Query utilsigtet i stedet for den nyligt certificerede connector.
  • Brugerdefinerede connectors bør kun bruges til at teste nye versioner af connectoren.
  • Når du arbejder med slutbrugere og kunder, skal du sikre, at de forstår den brugerdefinerede connectorversion, der bruges til test før certificering, skal fjernes, når testen er fuldført, og den nye certificerede connectorversion er tilgængelig.