Dela via

Certifiering av Data Factory Connector

  • Artikel

Viktigt!

Certifieringsprogrammet för anslutningsappar genomgår för närvarande ändringar och registreringen av nya anslutningscertifikat är för närvarande pausad. Den här artikeln uppdateras när certifieringsprogrammet för anslutningsprogrammet åter öppnar för nya partners. Om du har en certifierad anslutningsapp som du vill uppdatera kontaktar du vårt team på dataconnectors@microsoft.com för anvisningar om hur du skickar in en ny version. Inlämningen bearbetas varje månad och slutdatumet för inlämningar är den första tisdagen i varje månad.

Ägare av datakällor som utvecklar en anpassad anslutningsapp för sin datakälla kanske vill distribuera sin anpassade anslutningsapp bredare till Data Factory-användare. När en anpassad anslutningsapp har skapats, använts och verifierats av slutanvändare kan datakällans ägare skicka den för Microsoft-certifiering.

Om du certifierar en Data Factory-anslutningsapp blir anslutningsappen tillgänglig offentligt, out-of-box, Microsoft Fabric Data Factory och Microsoft Power BI i följande funktioner:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Microsoft Power BI-semantisk modell (i Power BI-tjänsten)
  • Microsoft Power BI Desktop
  • Lokal datagateway för Microsoft Fabric och Microsoft Power BI

Certifierade anslutningsappar är:

  • Underhålls av partnerutvecklaren

  • Stöds av partnerutvecklaren

  • Certifierad av Microsoft

  • Distribuerad av Microsoft

Vi samarbetar med partner för att försöka se till att de har stöd för underhåll, men kundproblem med själva anslutningsappen dirigeras till partnerutvecklaren.

Kommentar

Idag kan du använda Power Query SDK för att skapa en anslutningsapp som kan certifieras via certifieringsprogrammet för Data Factory-anslutningsappen. Gå över till Power Query SDK-översikten för att lära dig mer om det här verktyget.

Certifieringsöversikt

Förutsättningar

För att säkerställa bästa möjliga upplevelse för våra kunder överväger vi endast anslutningsappar som uppfyller en uppsättning krav för certifiering:

  • Anslutningsappen måste vara för en offentlig produkt.

  • Anslutningsappen måste betraktas som kodad för en första versionsversion. Programmet tillåter frekventa iterationer och uppdateringar. Microsoft erbjuder inte teknisk hjälp eller utveckling av anpassade anslutningsappar. Vi rekommenderar att du använder offentliga resurser, till exempel vår SDK-dokumentation och exempellagringsplats. Om du behöver ytterligare hjälp kan vi dela en lista över kända utvecklingskonsulter för anpassade anslutningsappar från tredje part som du kanske vill engagera direkt, separat från alla Microsoft-program eller partnerskap. Microsoft är inte anslutet till någon av dessa konsulter och ansvarar inte för din användning av deras tjänster. Microsoft tillhandahåller listan för din bekvämlighet och utan några garantier, rekommendationer eller garantier. Kontakta din Microsoft-certifieringskontakt om du vill veta mer.

  • Utvecklaren måste ange en uppskattning för aktuell och framtida användning.

  • Anslutningsappen måste redan göras tillgänglig för kunder direkt för att uppfylla ett användarbehov eller ett affärsscenario. Det här villkoret kan uppfyllas med hjälp av ett förhandsversionsprogram genom att distribuera den färdiga anslutningsappen direkt till slutanvändare och organisationer. Vi föreslår att utvecklare av anslutningsappar använder en självdistributionsmekanism och kör intern testning av sina egna anslutningsappar för att iterera över sina anslutningsappar under en kontrollerad grupp. Varje användare eller organisation bör kunna ge feedback och validering om att det finns ett affärsbehov för anslutningsappen och att anslutningsappen fungerar korrekt för att uppfylla sina affärskrav.

  • Anslutningsappen måste fungera korrekt på en förväntad användningsnivå av kunder.

  • Det måste finnas en tråd i forumet Infrastrukturidéer som drivs av kunder för att ange efterfrågan på att göra anslutningsappen offentligt tillgänglig i Data Factory och/eller Power BI. Det finns ingen angivet tröskelvärde för engagemang. Men ju mer engagemang, desto starkare bevis efterfrågan på anslutningsappen.

Dessa förutsättningar finns för att säkerställa att anslutningsappar som genomgår certifiering har betydande kund- och affärsbehov som måste användas för och stöds efter certifiering.

Certifieringskraven

Vi har en viss uppsättning krav för certifiering. Vi inser att inte alla utvecklare kan uppfylla dessa krav, och vi hoppas kunna introducera en funktionsuppsättning som hanterar utvecklarbehov i kort ordning.

Funktioner och formatmallar

Anslutningsappen måste följa en uppsättning funktions- och formatregler för att uppfylla en användbarhetsstandard som överensstämmer med andra certifierade anslutningsappar.

  • Anslutningsappen MÅSTE:

    • Använd avsnittsdokumentformat.
    • Innehåller ett versionshuvud/utsmyckning ovanför avsnittsdokumentet.
    • Ange metadata för funktionsdokumentation.
    • Ha TestConnection-hanteraren.
    • Följ namngivningskonventionerna (till exempel DataSourceKind.FunctionName). Den får inte innehålla ord som "Fabric", "Power BI", "Connector" eller "API".
    • Returnera data i tabellformat, ordnade i tabeller med kolumner, som för en relationsdatakälla. Flerdimensionella format baserade på kuber, dimensioner och mått stöds inte.
    • Bete dig likadant i import- och DirectQuery-läge och returnera identiska resultat.
    • Låt betaflaggan vara inställd på Sant vid den första versionen.

  • Bör FunctionName vara meningsfullt för domänen (till exempel "Innehåll", "Tabeller", "Dokument", "Databaser" och så vidare).

  • Anslutningsappen SKA:

    • Ha ikoner.
    • Ange en navigeringstabell.
    • Placera strängar i en resources.resx fil. URL:er och värden ska hårdkodas i anslutningskoden och inte placeras i resources.resx filen.

Säkerhet

Det finns specifika säkerhetsöverväganden som anslutningsappen måste hantera.

  • Om Extension.CurrentCredentials() används:

    • Krävs användningen? I så fall, var skickas autentiseringsuppgifterna till?
    • Garanteras begäranden via HTTPS?
    • Om autentiseringsuppgifterna skickas via Web.Contents() GET:
      • Kan det omvandlas till en POST?
      • Om GET krävs måste anslutningsappen CredentialQueryString använda posten i Web.Contents() alternativposten för att skicka in känsliga autentiseringsuppgifter.

  • Om diagnostik.* funktioner används:

    • Verifiera vad som spåras. data får inte innehålla PII eller stora mängder onödiga data.
    • Om du har implementerat betydande spårning under utveckling bör du implementera en variabel- eller funktionsflagga som avgör om spårning ska vara på. Den här spårningen måste inaktiveras innan du skickar in för certifiering.

  • Om Expression.Evaluate() används:

    • Verifiera var uttrycket kommer från och vad det är (det vill vill: kan dynamiskt konstruera anrop till Extension.CurrentCredentials()och så vidare).
    • Ska Expression inte vara användaren tillhandahålls eller ta användarindata.
    • Expression Bör inte vara dynamisk (det vill säga hämtas från ett webbanrop).

Efter certifiering

När anslutningsappen har certifierats och släppts via Microsoft Fabric- och Microsoft Power BI-upplevelser finns det några saker som du bör göra för att säkerställa att du kan använda den offentligt tillgängliga certifierade anslutningsappen för produktion korrekt.

  • Du och slutanvändarna bör använda den certifierade anslutningsversionen som ingår i miljöer före certifieringen (till exempel Power BI Desktop och Data Gateway) och ta bort alla befintliga .mez- eller .pqx-filer (anpassade anslutningsappar) som användes före certifieringen. Om du inte gör det kan det leda till att din anpassade anslutningsapp för testning används av Power Query oavsiktligt i stället för den nyligen certifierade anslutningsappen.
  • Anpassade anslutningsappar bör endast användas för att testa nya versioner av anslutningsappen.
  • När du arbetar med slutanvändare och kunder ska du se till att de förstår den anpassade anslutningsversion som används vid testning före certifieringen ska tas bort när testningen är klar och den nya certifierade anslutningsversionen är tillgänglig.