Dela via

Utveckla en anslutningsapp med Power Query SDK

  • Artikel

Power Query SDK är en uppsättning verktyg som är utformade för att hjälpa dig att skapa Power Query-anslutningsappar. Dessa anslutningsappar kallas ofta anpassade anslutningsappar eller Power Query-tillägg.

Med anpassade anslutningsappar kan du skapa nya datakällor eller anpassa och utöka en befintlig källa. Vanliga användningsfall är:

  • Skapa en affärsanalytikervänlig vy för ett REST API.
  • Tillhandahålla varumärkesanpassning för en källa som Power Query stöder med en befintlig anslutningsapp (till exempel en OData-tjänst eller ODBC-drivrutin).
  • Implementera OAuth v2-autentiseringsflöde för ett SaaS-erbjudande.
  • Exponera en begränsad eller filtrerad vy över datakällan för att förbättra användbarheten.
  • Aktivera DirectQuery för en datakälla med hjälp av en ODBC-drivrutin.

Installera Power Query SDK

Installera Visual Studio Code Power Query SDK från avsnittet Visual Studio Code på Visual Studio Marketplace. Välj Installera för att installera SDK.

Utvecklingsprocess för anslutningsappar

I följande avsnitt beskrivs, på hög nivå, den vanligaste processen för att skapa en Power Query-anslutningsapp med hjälp av SDK: et.

Skapa ett nytt tillägg

När du skapar en ny arbetsyta (Visual Studio Code Power Query SDK) börjar du med följande kärnfiler:

  • Anslutningsappsdefinitionsfil (<connectorName.pq>)
  • En frågefil (<connectorName.query.pq>)
  • En strängresursfil (resources.resx)
  • PNG-filer av olika storlekar som används för att skapa ikoner

Anslutningsappens definitionsfil börjar med en tom beskrivning av datakällan. Du kan lära dig mer om en datakälla i kontexten för Power Query SDK i artikeln om hantering av dataåtkomst.

Testning

Power Query SDK tillhandahåller grundläggande frågekörningsfunktioner så att du kan testa tillägget utan att behöva växla över till ett annat klientprogram. Du kan testa anslutningsappen ytterligare i ett program, till exempel:

Frågetestfil

Förutom tilläggsfilen kan Data Connector-projekt ha en frågefil (name.query.pq). Den här filen kan användas för att köra testfrågor i Visual Studio Code. Frågeutvärderingen inkluderar automatiskt tilläggskoden, utan att du behöver registrera din.pqx-fil, så att du kan anropa eller testa delade funktioner i tilläggskoden.

Frågefilen kan innehålla ett enda uttryck (till exempel HelloWorld.Contents()), ett let uttryck (till exempel vad Power Query skulle generera) eller ett avsnittsdokument.

Skapa och distribuera

När du skapar projektet skapas .mez-filen eller filnamnstillägget. Power Query-tillägg paketeras i en ZIP-fil och ges ett .mez-filnamnstillägg.

Tillägg definieras i ett M-avsnittsdokument. Ett avsnittsdokument har ett något annorlunda format än frågedokumenten som genereras i Power Query. Kod som du importerar från Power Query kräver vanligtvis ändringar för att passa in i ett avsnittsdokument, men ändringarna är mindre. Skillnader i avsnittsdokument bör du vara medveten om:

  • De börjar med en avsnittsdeklaration (till exempel section HelloWorld;).
  • Varje uttryck slutar med ett semikolon (till exempel a = 1; eller b = let c = 1 + 2 in c;).
  • Alla funktioner och variabler är lokala för avsnittsdokumentet, såvida de inte har markerats som delade. Delade funktioner blir synliga för andra frågor/funktioner och kan betraktas som exporter för ditt tillägg (det vill säga att de kan anropas från Power Query).

Mer information om M-avsnittsdokument finns i M Language-specifikationen.

Distribution av Power Query-anslutningsappar

Du har två sökvägar där du kan distribuera anslutningsappen:

  • Självdistribution
  • Certifiering av anslutningsappar

Självdistribution

En självbetjäningsmekanism där du kan använda anpassade Power Query-anslutningsappar i tillämpliga produktupplevelser

När anslutningsappen har skapats kan du skicka den här filen som du vill till dina användare och de kan använda anslutningsappen i tillämpliga produktupplevelser som Microsoft Power BI.

Microsoft Power BI

Du kan använda din egen anpassade anslutningsapp i Microsoft Power BI Desktop och Microsoft Power BI-tjänsten för semantiska modeller för uppdatering och anslutning i molnet.

Power Query-anslutningsappar kan läsas in i tre funktioner:

  • Lokal datagateway: Anslutningsappen kan läsas in via gatewayen som ska användas i Microsoft Fabric och Microsoft Power BI-tjänst s
  • Power Query Online: i funktioner som Power BI Datamarts, Fabric Dataflow Gen2 och många andra
  • Power Query Desktop: i funktioner som Power BI Desktop.

Du kan lära dig mer om hur du använder din anpassade anslutningsapp för självdistribution med hjälp av artiklarna nedan:

Certifiering av anslutningsappar

Med certifieringsprogrammet för Data Factory-anslutningsappen kan du skicka din anslutningsapp till Microsoft för certifiering där Microsoft tar hand om publicering och distribution av anslutningsappen i både Microsoft Fabric och Microsoft Power BI för tillämpliga produkter och upplevelser:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 och andra
  • Lokal datagateway: För både Microsoft Fabric och Microsoft Power BI som använder en gateway för autentiserad uppdatering eller anslutning.

Läs mer om certifieringsprogrammet för Data Factory Connector.