Delen via

Certificering van Data Factory-connector

  • Artikel

Belangrijk

Het certificeringsprogramma van de connector ondergaat momenteel wijzigingen en de registratie voor nieuwe connectorcertificeringen is momenteel in bewaring. Dit artikel wordt bijgewerkt zodra het connectorcertificeringsprogramma opnieuw wordt geopend voor nieuwe partners. Als u een gecertificeerde connector hebt die u wilt bijwerken, neemt u contact op met ons team voor dataconnectors@microsoft.com instructies over het indienen van een nieuwe versie. De inzending wordt elke maand verwerkt en de afkapdatum voor inzendingen is de eerste dinsdag van elke maand.

Eigenaren van gegevensbronnen die een aangepaste connector voor hun gegevensbron ontwikkelen, willen hun aangepaste connector mogelijk breder distribueren naar Data Factory-gebruikers. Zodra een aangepaste connector is gemaakt, gebruikt en gevalideerd door eindgebruikers, kan de eigenaar van de gegevensbron deze indienen voor Microsoft-certificering.

Als u een Data Factory-connector certificeren, wordt de connector openbaar, out-of-box, Microsoft Fabric Data Factory en Microsoft Power BI beschikbaar in de volgende ervaringen:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Semantisch Microsoft Power BI-model (in de Power BI-service)
  • Microsoft Power BI Desktop
  • On-premises gegevensgateway voor Microsoft Fabric en Microsoft Power BI

Gecertificeerde connectors zijn:

  • Onderhouden door de partnerontwikkelaar

  • Ondersteund door de partnerontwikkelaar

  • Gecertificeerd door Microsoft

  • Gedistribueerd door Microsoft

We werken samen met partners om ervoor te zorgen dat ze ondersteuning hebben in onderhoud, maar klantproblemen met de connector zelf worden doorgestuurd naar de partnerontwikkelaar.

Notitie

Tegenwoordig kunt u de Power Query SDK gebruiken om een connector te maken die kan worden gecertificeerd via het certificeringsprogramma van de Data Factory-connector. Ga naar het overzicht van de Power Query SDK voor meer informatie over dit hulpprogramma.

Certificeringsoverzicht

Vereisten

Om de beste ervaring voor onze klanten te garanderen, houden we alleen rekening met connectors die voldoen aan een set vereisten voor certificering:

  • De connector moet voor een openbaar product zijn.

  • De connector moet worden beschouwd als code-complete voor een eerste releaseversie. Het programma maakt frequente iteraties en updates mogelijk. Microsoft biedt geen technische hulp of advies voor het ontwikkelen van aangepaste connectors. We raden u aan openbare resources te gebruiken, zoals onze SDK-documentatie en opslagplaats met voorbeelden. Als u meer hulp nodig hebt, kunnen we een lijst delen met bekende, aangepaste connectorontwikkelingsadviseurs van derden die u mogelijk rechtstreeks wilt betrekken, gescheiden van elk Microsoft-programma of -partnerschap. Microsoft is niet aangesloten bij een van deze consultants en is niet verantwoordelijk voor uw gebruik van hun services. Microsoft biedt de lijst voor uw gemak en zonder enige zekerheid, aanbevelingen of garanties. Neem contact op met uw microsoft-certificeringsmedewerker voor meer informatie.

  • De ontwikkelaar moet een schatting opgeven voor huidig en toekomstig gebruik.

  • De connector moet al rechtstreeks beschikbaar worden gesteld aan klanten om te voldoen aan een gebruikersbehoefte of bedrijfsscenario. Aan deze criteria kan worden voldaan met behulp van een preview-programma door de voltooide connector rechtstreeks te distribueren naar eindgebruikers en organisaties. We raden ontwikkelaars van connectors aan om een zelfdistributiemechanisme te gebruiken en interne tests van hun eigen connectors uit te voeren om hun connectors onder een gecontroleerde groep te herhalen. Elke gebruiker of organisatie moet feedback en validatie kunnen geven dat er een zakelijke behoefte is aan de connector en dat de connector werkt om aan hun zakelijke vereisten te voldoen.

  • De connector moet goed werken op een verwacht gebruiksniveau van klanten.

  • Er moet een thread aanwezig zijn in het forum Fabric Ideas dat wordt aangestuurd door klanten om de vraag aan te geven om de connector openbaar beschikbaar te maken in Data Factory en/of Power BI. Er is geen drempelwaarde voor betrokkenheid ingesteld. Hoe meer betrokkenheid, hoe sterker de bewijsvraag voor de connector.

Deze vereisten bestaan om ervoor te zorgen dat connectors die worden gecertificeerd, aanzienlijke klanten en bedrijven nodig hebben om na certificering te worden gebruikt en ondersteund.

Certificeringsvereisten

We hebben een aantal vereisten voor certificering. We erkennen dat niet elke ontwikkelaar aan deze vereisten kan voldoen en we hopen een functieset te introduceren die de behoeften van ontwikkelaars in korte volgorde afhandelt.

Functies en stijl

De connector moet een set functie- en stijlregels volgen om te voldoen aan een bruikbaarheidsstandaard die consistent is met andere gecertificeerde connectors.

  • De connector MOET:

    • Sectiedocumentindeling gebruiken.
    • Bevat een versiekoptekst/versiering boven het sectiedocument.
    • Geef metagegevens van functiedocumentatie op.
    • TestConnection-handler hebben.
    • Volg naamconventies (bijvoorbeeld DataSourceKind.FunctionName). Het mag geen woorden bevatten zoals 'Infrastructuur', 'Power BI', 'Connector' of 'API'.
    • Retourneert gegevens in tabelvorm, geordend in tabellen met kolommen, zoals voor een relationele gegevensbron. Multidimensionale indelingen op basis van kubussen, dimensies en metingen worden niet ondersteund.
    • Gedraagt zich hetzelfde in de import- en DirectQuery-modus, waarbij identieke resultaten worden geretourneerd.
    • Zorg ervoor dat de bètavlag is ingesteld op True bij de eerste release.

  • Het FunctionName moet zinvol zijn voor het domein (bijvoorbeeld 'Inhoud', 'Tabellen', 'Document', 'Databases', enzovoort).

  • De connector MOET:

    • Pictogrammen hebben.
    • Geef een navigatietabel op.
    • Plaats tekenreeksen in een resources.resx bestand. URL's en waarden moeten worden vastgelegd in de connectorcode en moeten niet in het resources.resx bestand worden geplaatst.

Beveiliging

Er zijn specifieke beveiligingsoverwegingen die uw connector moet verwerken.

  • Als Extension.CurrentCredentials() wordt gebruikt:

    • Is het gebruik vereist? Zo ja, waar worden de referenties naar verzonden?
    • Worden de aanvragen gegarandeerd via HTTPS gedaan?
    • Als de referenties worden verzonden via Web.Contents() GET:
      • Kan het worden omgezet in een POST?
      • Als GET is vereist, moet de connector de CredentialQueryString record in de Web.Contents() optiesrecord gebruiken om gevoelige referenties door te geven.

  • Als diagnostische gegevens.* functies worden gebruikt:

    • Valideren wat er wordt getraceerd; gegevens mogen geen PII of grote hoeveelheden onnodige gegevens bevatten.
    • Als u belangrijke tracering in ontwikkeling hebt geïmplementeerd, moet u een variabele of functievlag implementeren die bepaalt of tracering moet zijn ingeschakeld. Deze tracering moet worden uitgeschakeld voordat u de certificering indient.

  • Als Expression.Evaluate() wordt gebruikt:

    • Valideer waar de expressie vandaan komt en wat deze is (dat wil gezegd, kan dynamisch aanroepen maken Extension.CurrentCredentials(), enzovoort).
    • De Expression gebruiker mag niet worden opgegeven en mag geen gebruikersinvoer gebruiken.
    • De Expression naam mag niet dynamisch zijn (dat wil gezegd, opgehaald uit een webaanroep).

Na certificering

Nadat uw connector is gecertificeerd en uitgebracht via Microsoft Fabric- en Microsoft Power BI-ervaringen, zijn er enkele dingen die u moet doen om ervoor te zorgen dat u de door productie geïmplementeerde openbaar beschikbare gecertificeerde connector correct kunt gebruiken.

  • U en eindgebruikers moeten de gecertificeerde connectorversie gebruiken die is opgenomen in omgevingen voorafgaand aan certificering (zoals Power BI Desktop en de gegevensgateway) en bestaande .mez- of .pqx-bestanden (aangepaste connectors) verwijderen die vóór de certificering worden gebruikt. Als u dit niet doet, kan dit ertoe leiden dat uw aangepaste testconnector per ongeluk door Power Query wordt gebruikt in plaats van de zojuist gecertificeerde connector.
  • Aangepaste connectors mogen alleen worden gebruikt om nieuwe versies van de connector te testen.
  • Wanneer u met eindgebruikers en klanten werkt, moet u ervoor zorgen dat ze weten welke versie van de aangepaste connector wordt gebruikt bij het testen voordat de certificering is voltooid en dat de nieuwe gecertificeerde connectorversie beschikbaar is.