Udostępnij przez

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 Połączenie or

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 Połączenie or (<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 rozpocznie 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 POWER Query SDK zapewnia podstawowe możliwości wykonywania zapytań, dzięki czemu można przetestować rozszerzenie bez konieczności przełączania się do programu Power BI Desktop.

Plik testu zapytania

Oprócz pliku rozszerzenia projekty data Połączenie or 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. W czasie wykonywania program Power BI Desktop ładuje rozszerzenia z folderu [Documents]\Microsoft Power BI Desktop\Custom Połączenie ors.

Uwaga

Projekty Połączenie or danych nie obsługują niestandardowych kroków kompilacji po kompilacji w celu skopiowania pliku rozszerzenia do katalogu [Documents]\Microsoft Power BI Desktop\Custom Połączenie ors. Jeśli jest to coś, co chcesz zrobić, możesz użyć rozszerzenia innej firmy.

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 danych

Łączniki dodatku Power Query można używać w programie Power BI Desktop lub środowisku usługi Power Query Online, takim jak przepływy danych usługi Power BI, magazyny danych usługi Power BI i inne środowiska.

Power BI Desktop

Użytkownicy programu Power BI Desktop mogą wykonać poniższe kroki, aby korzystać z łącznika niestandardowego dodatku Power Query:

  1. Skopiuj plik rozszerzenia (.mez lub.pqx) do folderu [Documents]/Power BI Desktop/Custom Połączenie ors.
  2. W programie Power BI Desktop wybierz opcję (Niezalecane) Zezwalaj na ładowanie dowolnego rozszerzenia bez walidacji lub ostrzeżenia w obszarze Opcje plików>i ustawienia>Opcje Rozszerzenia>danych zabezpieczeń.>
  3. Uruchom ponownie program Power BI Desktop.

Program Power BI Desktop automatycznie załaduje rozszerzenia po ponownym uruchomieniu.

Alternatywnie jako właściciel źródła danych i łącznika możesz przesłać łącznik do programu Power Query Połączenie or Certification, aby był dostarczany z programem Power BI Desktop w każdej wersji.

Power Query Online

Tylko certyfikowane łączniki dodatku Power Query są wyświetlane w środowisku usługi Power Query Online. Aby dowiedzieć się więcej na temat programu certyfikacji łącznika Power Query, przejdź do pozycji Power Query Połączenie or Certification (Certyfikacja programu Power Query Połączenie or).