Udostępnij za pośrednictwem

Tworzenie łącznika przy użyciu zestawu POWER Query SDK

  • Artykuł

Zestaw SDK dodatku Power Query to zestaw narzędzi zaprojektowanych w celu ułatwienia tworzenia łączników dodatku Power Query. Te łączniki są często określane jako łączniki niestandardowe lub rozszerzenia dodatku Power Query.

Łączniki niestandardowe umożliwiają tworzenie nowych źródeł danych lub dostosowywanie i rozszerzanie istniejącego źródła. Typowe przypadki użycia to:

  • Tworzenie przyjaznego dla analityka biznesowego widoku interfejsu API REST.
  • Udostępnianie znakowania dla źródła obsługiwanego przez dodatek Power Query przy użyciu istniejącego łącznika (takiego jak usługa OData lub sterownik ODBC).
  • Implementowanie przepływu uwierzytelniania OAuth w wersji 2 dla oferty SaaS.
  • Uwidacznianie ograniczonego lub filtrowanego widoku w źródle danych w celu zwiększenia użyteczności.
  • Włączanie trybu DirectQuery dla źródła danych przy użyciu sterownika ODBC.

Instalowanie zestawu POWER Query SDK

Zainstaluj zestaw VISUAL Studio Code Power Query SDK z sekcji Visual Studio Code w witrynie Visual Studio Marketplace. Wybierz pozycję Zainstaluj , aby zainstalować zestaw SDK.

Proces programowania łącznika

W poniższych sekcjach opisano na wysokim poziomie najbardziej typowy proces tworzenia łącznika dodatku Power Query przy użyciu zestawu SDK.

Tworzenie nowego rozszerzenia

Podczas tworzenia nowego obszaru roboczego (Zestaw SDK Power Query programu Visual Studio Code) rozpoczynasz od następujących podstawowych plików:

  • Plik definicji łącznika (<connectorName.pq>)
  • Plik zapytania (<connectorName.query.pq>)
  • Plik zasobu ciągu (resources.resx)
  • Pliki PNG o różnych rozmiarach używane do tworzenia ikon

Plik definicji łącznika rozpoczyna się od pustego opisu źródła danych. Więcej informacji o źródle danych można dowiedzieć się w kontekście zestawu SDK dodatku Power Query z artykułu dotyczącego obsługi dostępu do danych.

Testowanie

Zestaw SDK dodatku Power Query zapewnia podstawowe możliwości wykonywania zapytań, umożliwiając testowanie rozszerzenia bez konieczności przełączania się do innej aplikacji klienckiej. Możesz dodatkowo przetestować łącznik w aplikacji, na przykład:

Plik testu zapytania

Oprócz pliku rozszerzenia projekty łącznika danych mogą mieć plik zapytania (name.query.pq). Ten plik może służyć do uruchamiania zapytań testowych w programie Visual Studio Code. Ocena zapytania będzie automatycznie zawierać kod rozszerzenia bez konieczności rejestrowania pliku pqx, co umożliwia wywoływanie lub testowanie wszystkich funkcji udostępnionych w kodzie rozszerzenia.

Plik zapytania może zawierać jedno wyrażenie (na przykład HelloWorld.Contents()), let wyrażenie (na przykład to, co wygenerowałoby dodatek Power Query) lub dokument sekcji.

Kompiluj i wdróż

Kompilowanie projektu powoduje utworzenie pliku mez lub pliku rozszerzenia. Rozszerzenia dodatku Power Query są umieszczane w pliku ZIP i mają rozszerzenie pliku mez.

Rozszerzenia są definiowane w dokumencie sekcji języka M. Dokument sekcji ma nieco inny format niż dokumenty zapytania wygenerowane w dodatku Power Query. Kod importowane z dodatku Power Query zwykle wymaga modyfikacji, aby zmieścić się w dokumencie sekcji, ale zmiany są niewielkie. Różnice w dokumencie sekcji, o których należy pamiętać:

  • Zaczynają się od deklaracji sekcji (na przykład section HelloWorld;).
  • Każde wyrażenie kończy się średnikiem (na przykład a = 1; lub b = let c = 1 + 2 in c;).
  • Wszystkie funkcje i zmienne są lokalne w dokumencie sekcji, chyba że są oznaczone jako udostępnione. Funkcje udostępnione stają się widoczne dla innych zapytań/funkcji i mogą być uważane za eksporty dla rozszerzenia (czyli stają się one możliwe do wywołania z dodatku Power Query).

Więcej informacji na temat dokumentów sekcji języka M można znaleźć w specyfikacji języka M.

Dystrybucja łączników dodatku Power Query

Istnieją dwie ścieżki, w których można dystrybuować łącznik:

  • Samodzielna dystrybucja
  • Certyfikacja łącznika

Samodzielna dystrybucja

Mechanizm samoobsługi, w którym można stosować łączniki niestandardowe dodatku Power Query w odpowiednich środowiskach produktów

Po utworzeniu łącznika możesz wysłać ten plik tak, jak chcesz do użytkowników, i mogą używać łącznika w odpowiednich środowiskach produktów, takich jak Microsoft Power BI.

Microsoft Power BI

Możesz użyć własnego łącznika niestandardowego w programie Microsoft Power BI Desktop i usłudze Microsoft Power BI dla modeli semantycznych na potrzeby odświeżania i łączności w chmurze.

Łączniki dodatku Power Query można załadować do trzech środowisk:

  • Lokalna brama danych: Łącznik można załadować za pośrednictwem bramy do użycia w usługach Microsoft Fabric i Microsoft usługa Power BI
  • Power Query Online: w środowiskach takich jak Power BI Datamarts, Fabric Dataflow Gen2 i wiele innych
  • Power Query Desktop: w środowiskach takich jak Power BI Desktop.

Więcej informacji na temat korzystania z łącznika niestandardowego do samodzielnej dystrybucji można uzyskać, korzystając z poniższych artykułów:

Certyfikacja łącznika

Program certyfikacji łącznika usługi Data Factory umożliwia przesłanie łącznika do firmy Microsoft w celu uzyskania certyfikatu, w którym firma Microsoft zajmuje się publikowaniem i dystrybucją łącznika zarówno w usłudze Microsoft Fabric, jak i w usłudze Microsoft Power BI dla odpowiednich produktów i środowisk:

  • 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 i inne
  • Lokalna brama danych: w przypadku usługi Microsoft Fabric i Microsoft Power BI używającej bramy do uwierzytelnionego odświeżania lub łączności.

Dowiedz się więcej o programie certyfikacji łącznika usługi Data Factory.