Del via

Brug brugerdefinerede dataconnectors med en datagateway i det lokale miljø

  • Artikel

Bemærk

Vi har opdelt datagatewaydokumenterne i det lokale miljø i indhold, der er specifikt for Power BI , og generelt indhold, der gælder for alle tjenester , som gatewayen understøtter. Du er i øjeblikket i Power BI-indholdet. Hvis du vil give feedback om denne artikel eller den overordnede oplevelse af gatewaydokumenter, skal du rulle til bunden af artiklen.

Du kan bruge Power BI-dataconnectors til at oprette forbindelse til og få adgang til data fra et program, en tjeneste eller en datakilde. Du kan udvikle brugerdefinerede dataconnectors og bruge dem i Power BI Desktop.

Hvis du opretter rapporter i Power BI Desktop, der bruger brugerdefinerede dataconnectors, kan du bruge en datagateway i det lokale miljø til at opdatere disse rapporter i Power BI-tjeneste.

Hvis du vil vide mere om, hvordan du udvikler brugerdefinerede dataconnectors til Power BI, skal du se SDK'et Data Forbind ors i GitHub. Dette websted indeholder oplysninger om, hvordan du kommer i gang, og eksempler til Power BI og Power Query.

Aktivér og brug brugerdefinerede connectors

Hvis du vil aktivere brugen af brugerdefinerede connectors, skal du vælge Forbind orer i appen datagateway i det lokale miljø. I Brugerdefinerede dataconnectors under Indlæs brugerdefinerede dataconnectors fra mappe skal du gå til og vælge en mappe, som den bruger, der kører gatewaytjenesten, kan få adgang til. Standardbrugeren er NT SERVICE\PBIEgwService. Gatewayen indlæser automatisk de brugerdefinerede connectorfiler i den pågældende mappe, og de vises på listen over dataconnectors.

Screenshot that shows the Custom data connectors screen in the On-premises data gateway app.

Bemærk

Hvis du bruger en datagateway i det lokale miljø (personlig tilstand), kan du uploade din Power BI-rapport til Power BI-tjeneste og bruge gatewayen til at opdatere den.

For en datagateway i det lokale miljø skal du oprette en datakilde til din brugerdefinerede connector. På siden med gatewayindstillinger i Power BI-tjeneste skal du vælge indstillingen for at aktivere brugen af brugerdefinerede connectors med denne klynge.

Screenshot that shows enabling custom connectors on the on-premises gateway Settings page.

Når du aktiverer denne indstilling, kan du se dine brugerdefinerede connectors som tilgængelige datakildeforbindelser, som du kan føje til denne gatewayklynge. Når du har oprettet en datakilde, der bruger din nye brugerdefinerede connector, kan du opdatere Power BI-rapporter ved hjælp af den brugerdefinerede connector i Power BI-tjeneste.

Screenshot that shows the Data Source list on the Settings page.

Overvejelser og begrænsninger

  • Sørg for, at den mappe, du opretter, er tilgængelig for gatewaytjenesten i baggrunden. Mapper under dine brugeres Windows-mapper eller systemmapper er normalt ikke tilgængelige. I datagatewayappen i det lokale miljø vises der en meddelelse, hvis mappen ikke er tilgængelig. Denne begrænsning gælder ikke for datagatewayen i det lokale miljø (personlig tilstand).

  • Hvis brugerdefinerede connectors skal arbejde med datagatewayen i det lokale miljø, skal de implementere sektionen Test Forbind ion i den brugerdefinerede connectorkode. Denne sektion er ikke påkrævet, når du bruger brugerdefinerede connectors med Power BI Desktop. Derfor kan du have en connector, der fungerer sammen med Power BI Desktop, men ikke med gatewayen. Du kan få flere oplysninger om, hvordan du implementerer afsnittet Test Forbind ion, under Test Forbind ion.

  • Hvis din brugerdefinerede connector er på et netværksdrev, skal du inkludere den fuldt kvalificerede sti i appen til datagatewayen i det lokale miljø.

  • Du kan kun bruge én brugerdefineret connectordatakilde, når du arbejder i DirectQuery-tilstand. Flere brugerdefinerede connectordatakilder fungerer ikke sammen med DirectQuery.

Relateret indhold

Har du flere spørgsmål? Prøv at spørge Power BI-community'et.