Installera Power Query SDK

Snabbstart

1. Installera Power Query SDK från Visual Studio Marketplace.
2. Skapa ett nytt dataanslutningsprojekt.
3. Definiera anslutningslogiken.
4. Skapa projektet för att skapa en tilläggsfil.
5. Kopiera tilläggsfilen till [Documents]/Power BI Desktop/Custom Connectors.
6. Markera alternativet (rekommenderas inte) Tillåt att alla tillägg läses in utan validering eller varning i Power BI Desktop (under File | Alternativ och | Alternativ | Säkerhets-| Datatillägg).
7. Starta om Power BI Desktop

Distribution av dataanslutningsappar

Power BI Desktop kan ladda ned tilläggsfiler och placera dem i en känd katalog (stegen beskrivs ovan). Power BI Desktop automatiskt tilläggen vid omstart.

Ytterligare länkar och resurser

• M-biblioteksfunktioner
• M-språkspecifikation
• Power BI Developer Center
• Självstudie för dataanslutning

Steg för steg

Skapa ett nytt tillägg i Visual Studio

När du installerar Power Query SDK för Visual Studio skapas en ny projektmall för Data Connector i Visual Studio.

Detta skapar ett nytt projekt som innehåller följande filer:

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

Anslutningsappens definitionsfil börjar med en tom beskrivning av datakällan. Mer information finns i avsnittet Typ av datakälla senare i det här dokumentet.

Testa i Visual Studio

I Power Query SDK finns grundläggande funktioner för frågekörning, så att du kan testa tillägget utan att behöva växla över till Power BI Desktop. Mer information finns i Frågefil.

Skapa och distribuera från Visual Studio

När du skapar projektet produceras .pqx-filen.

Data Connector-projekt stöder inte anpassade steg efter kombinering för att kopiera tilläggsfilen till katalogen [Documents]\Microsoft Power BI Desktop\Custom Connectors. Om det här är något du vill göra kanske du vill använda ett tillägg Visual Studio tredje part, till exempel Distribuera automatiskt.

Tilläggsfiler

Power Query paketeras i en ZIP-fil och får filnamnstillägget .mez. Vid körning läser Power BI Desktop in tillägg från [Documents]\Microsoft Power BI Desktop\Custom Connectors.

Format för tilläggsfil

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 få plats i ett avsnittsdokument, men ändringarna är mindre. Avsnittsdokumentskillnader som du bör känna till:

• 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 i avsnittsdokumentet, såvida de inte har markerats som delade. Delade funktioner blir synliga för andra frågor/funktioner och kan ses som exporter för ditt tillägg (det vill säga de blir anropningsbara från Power Query).

Mer information om M-avsnittsdokument finns i M-språkspecifikationen.

Frågefil

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 inom Visual Studio. Frågeutvärderingen inkluderar automatiskt tilläggskoden utan att du behöver registrera .pqx-filen, så att du kan anropa/testa delade funktioner i tilläggskoden.

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