Udostępnij przez

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

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.

Samodzielna dystrybucja konektorów Power Query

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 Power Query można załadować do dwóch ś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 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:

  • Last updated on