Udostępnij za pośrednictwem

Certyfikacja łącznika usługi Data Factory

  • Artykuł

Uwaga

W tym artykule opisano wymagania i proces przesyłania łącznika usługi Data Factory na potrzeby certyfikacji. Przed rozpoczęciem procesu certyfikacji przeczytaj cały artykuł.

Właściciele źródeł danych, którzy tworzą łącznik niestandardowy dla źródła danych, mogą chcieć rozpowszechniać łącznik niestandardowy w szerszym zakresie dla użytkowników usługi Data Factory. Po utworzeniu, użyciu i zweryfikowaniu przez użytkowników końcowych łącznika niestandardowego właściciel źródła danych może przesłać go do certyfikacji firmy Microsoft.

Certyfikowanie łącznika usługi Data Factory udostępnia łącznik publicznie, gotowe do użycia, usługę Microsoft Fabric Data Factory i usługę Microsoft Power BI w następujących środowiskach:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Semantyczny model usługi Microsoft Power BI (w usłudze Power BI)
  • Microsoft Power BI Desktop
  • Lokalna brama danych dla usług Microsoft Fabric i Microsoft Power BI

Certyfikowane łączniki to:

  • Obsługiwane przez dewelopera partnera

  • Obsługiwane przez dewelopera partnera

  • Certyfikowane przez firmę Microsoft

  • Dystrybuowane przez firmę Microsoft

Współpracujemy z partnerami, aby upewnić się, że mają pomoc techniczną w konserwacji, ale problemy klientów z samym łącznikiem są kierowane do dewelopera partnera.

Uwaga

Obecnie możesz użyć zestawu SDK dodatku Power Query, aby utworzyć łącznik, który może być certyfikowany za pośrednictwem programu certyfikacji łącznika usługi Data Factory. Przejdź do przeglądu zestawu POWER Query SDK, aby dowiedzieć się więcej o tym narzędziu.

Omówienie certyfikacji

Wymagania wstępne

Aby zapewnić najlepsze środowisko dla naszych klientów, rozważmy tylko łączniki spełniające zestaw wymagań wstępnych dotyczących certyfikacji:

  • Łącznik musi być przeznaczony dla produktu publicznego.

  • Łącznik musi być traktowany jako kod ukończony dla wersji początkowej. Program umożliwia częste iteracji i aktualizacje. Firma Microsoft nie oferuje pomocy technicznej ani konsultacji z opracowywaniem łączników niestandardowych. Zalecamy używanie zasobów publicznych, takich jak dokumentacja zestawu SDK i repozytorium przykładów. Jeśli potrzebujesz dalszej pomocy, możemy udostępnić listę znanych konsultantów rozwoju łączników niestandardowych innych firm, którzy mogą chcieć współpracować bezpośrednio, niezależnie od dowolnego programu lub partnerstwa firmy Microsoft. Firma Microsoft nie jest powiązana z żadnym z tych konsultantów i nie ponosi odpowiedzialności za korzystanie z ich usług. Firma Microsoft udostępnia listę wygody i bez żadnych gwarancji, zaleceń i gwarancji. Aby dowiedzieć się więcej, skontaktuj się z kontaktem z firmą Microsoft w zakresie certyfikacji.

  • Deweloper musi podać oszacowanie bieżącego i przyszłego użycia.

  • Łącznik musi być już udostępniony klientom bezpośrednio w celu spełnienia potrzeby użytkownika lub scenariusza biznesowego. Te kryteria można spełnić przy użyciu programu Private Preview, rozpowszechniając ukończony łącznik bezpośrednio do użytkowników końcowych i organizacji. Sugerujemy, aby deweloperzy łączników używali mechanizmu samodzielnej dystrybucji i uruchamiali wewnętrzne testy własnych łączników, aby iterować swoje łączniki w ramach kontrolowanej grupy. Każdy użytkownik lub organizacja powinien mieć możliwość przekazywania opinii i weryfikacji, że istnieje potrzeba biznesowa łącznika i że łącznik działa pomyślnie, aby spełnić wymagania biznesowe.

  • Łącznik musi działać pomyślnie na przewidywanym poziomie użycia przez klientów.

  • Aby klienci mogli publicznie udostępnić łącznik w usłudze Data Factory i/lub Power BI, musi istnieć wątek na forum Pomysły dotyczące sieci szkieletowej. Nie ma ustawionego progu zakontraktowania. Im większe zaangażowanie, tym silniejszy jest popyt na łącznik.

Te wymagania wstępne istnieją, aby upewnić się, że łączniki poddane certyfikacji mają znaczący klient i firma muszą być używane do i obsługiwane po certyfikacji.

Procesy i osie czasu

Certyfikowane łączniki są wydawane z comiesięcznymi wersjami programu Power BI Desktop, dlatego terminy dla każdej wersji działają z powrotem z każdej daty wydania programu Power BI Desktop. Oczekiwany czas trwania procesu certyfikacji od rejestracji do wydania różni się w zależności od jakości i złożoności przesyłania łącznika. Firma Microsoft nie zapewnia żadnych konkretnych gwarancji osi czasu dotyczących przeglądu i zatwierdzania łącznika. Twarde terminy przeglądu łącznika zostały opisane w poniższych krokach, ale firma Microsoft nie gwarantuje przestrzegania tych osi czasu.

  • Rejestracja: powiadomienie o zamiarze certyfikacji łącznika niestandardowego. Ta rejestracja musi nastąpić do 15. dnia miesiąca, dwa miesiące przed docelową wersją programu Power BI Desktop.

    • Na przykład w kwietniowej wersji programu Power BI Desktop ostateczny termin to 15 lutego.

  • Przesyłanie: przesyłanie plików łączników do przeglądu przez firmę Microsoft. To przesłanie musi nastąpić w pierwszym miesiącu przed docelową wersją programu Power BI Desktop.

    • Na przykład w kwietniowej wersji programu Power BI Desktop ostateczny termin to 1 marca.

  • Przegląd techniczny: finalizacja plików łącznika, przekazywanie przeglądu i certyfikacji firmy Microsoft. Ta recenzja musi nastąpić do 15. dnia miesiąca przed docelową wersją programu Power BI Desktop.

    • Na przykład w kwietniowej wersji programu Power BI Desktop ostateczny termin to 15 marca.

Ze względu na złożoność przeglądów technicznych i potencjalnych opóźnień, architektury i problemów z testowaniem zdecydowanie zalecamy wcześniejsze przesyłanie z długim czasem realizacji dla początkowej wersji i certyfikacji.

Wymagania dotyczące certyfikacji

Mamy pewien zestaw wymagań dotyczących certyfikacji. Zdajemy sobie sprawę, że nie każdy deweloper może spełnić te wymagania i mamy nadzieję wprowadzić zestaw funkcji, który będzie obsługiwać potrzeby deweloperów w krótkim czasie.

Pliki przesyłania (artefakty)

Upewnij się, że w przesłaniu znajdują się następujące pliki łącznika:

  • Plik łącznika (mez)

    • Plik mez powinien być zgodny ze standardami stylu i mieć nazwę podobną do nazwy produktu lub usługi. Nie powinien zawierać wyrazów takich jak "Fabric", "Power BI", "Connector" lub "API".
    • Nadaj nazwę plikowi mez: ProductName.mez

  • Plik programu Power BI Desktop (pbix) na potrzeby testowania

    • Do przetestowania łącznika jest wymagany przykładowy raport usługi Power BI (pbix).
    • Raport powinien zawierać co najmniej jedno zapytanie, aby przetestować każdy element w tabeli nawigacji.
    • Jeśli nie ma ustawionego schematu (na przykład baz danych), raport musi zawierać zapytanie dla każdego "typu" tabeli, którą może obsłużyć łącznik.

  • Testowanie konta w źródle danych

    • Używamy konta testowego do testowania łącznika i rozwiązywania problemów z tym łącznikiem.
    • Podaj konto testowe, które jest trwałe, dzięki czemu możemy użyć tego samego konta do certyfikowania wszelkich przyszłych aktualizacji.

  • Instrukcje dotyczące testowania

    • Podaj dowolną dokumentację dotyczącą używania łącznika i testowania jego funkcjonalności.

  • Linki do zależności zewnętrznych (na przykład sterowniki ODBC)

Funkcje i styl

Łącznik musi przestrzegać zestawu reguł funkcji i stylu, aby spełnić standardy użyteczności zgodne z innymi certyfikowanymi łącznikami.

  • Łącznik MUSI:

    • Użyj formatu dokumentu sekcji.
    • Zawiera nagłówek/ozdobioną wersję nad dokumentem sekcji.
    • Podaj metadane dokumentacji funkcji.
    • Mieć program obsługi TestConnection.
    • Postępuj zgodnie z konwencjami nazewnictwa (na przykład DataSourceKind.FunctionName). Nie powinien zawierać wyrazów takich jak "Fabric", "Power BI", "Connector" lub "API".
    • Zwraca dane w formacie tabelarycznym zorganizowane w tabele z kolumnami, tak jak w przypadku relacyjnego źródła danych. Formaty wielowymiarowe oparte na modułach, wymiarach i miarach nie są obsługiwane.
    • Zachowaj się tak samo w trybie Importuj i DirectQuery, zwracając identyczne wyniki.
    • Flaga beta ma ustawioną wartość True w początkowej wersji.

  • Powinna FunctionName mieć sens dla domeny (na przykład "Zawartość", "Tabele", "Dokument", "Bazy danych" itd.).

  • Łącznik POWINIEN:

    • Ikony.
    • Podaj tabelę nawigacji.
    • Umieść ciągi w resources.resx pliku. Adresy URL i wartości powinny być zakodowane w kodzie łącznika resources.resx i nie powinny być umieszczane w pliku.

Zabezpieczenia

Istnieją konkretne zagadnienia dotyczące zabezpieczeń, które łącznik musi obsługiwać.

  • Jeśli Extension.CurrentCredentials() jest używany:

    • Czy jest wymagane użycie? Jeśli tak, gdzie są wysyłane poświadczenia?
    • Czy żądania są gwarantowane za pośrednictwem protokołu HTTPS?
      • Możesz użyć funkcji pomocnika wymuszania HTTPS.
    • Jeśli poświadczenia są wysyłane przy użyciu polecenia Web.Contents() GET:
      • Czy można przekształcić go w post?
      • Jeśli polecenie GET jest wymagane, łącznik MUSI użyć rekordu CredentialQueryString w rekordzie Web.Contents() opcji w celu przekazania poufnych poświadczeń.

  • Jeśli są używane funkcje Diagnostics.*:

    • Sprawdź, co jest śledzone; dane nie mogą zawierać danych pii ani dużych ilości niepotrzebnych danych.
    • W przypadku zaimplementowania znaczącego śledzenia w programowania należy zaimplementować zmienną lub flagę funkcji, która określa, czy śledzenie powinno być włączone. To śledzenie musi zostać wyłączone przed przesłaniem do certyfikacji.

  • Jeśli Expression.Evaluate() jest używany:

    • Zweryfikuj, skąd pochodzi wyrażenie, i co to jest (czyli może dynamicznie tworzyć wywołania metody Extension.CurrentCredentials()i tak dalej).
    • Nie Expression należy podawać użytkownika ani wprowadzać danych wejściowych użytkownika.
    • Element Expression nie powinien być dynamiczny (czyli pobierany z wywołania internetowego).

Rejestrowanie się w celu certyfikacji

Jeśli chcesz realizować certyfikację łącznika niestandardowego, upewnij się, że twój scenariusz i łącznik spełniają wymagania wstępne i wymagania opisane w tym artykule. Niepowodzenie tego problemu spowoduje opóźnienia w certyfikacji, ponieważ nasz zespół wymaga rozwiązania wszelkich problemów lub niespójności przed przejściem do przodu z certyfikacją.

Upewnij się, że łącznik jest kompletny i został przetestowany zarówno podczas tworzenia w programie Power BI Desktop, jak i odświeżania i zużycia w usługa Power BI. Upewnij się, że przetestowano kompleksowe odświeżanie w usłudze Power BI przy użyciu lokalnej bramy danych.

Aby rozpocząć, wypełnij formularz rejestracji, a kontakt firmy Microsoft skontaktuje się, aby rozpocząć proces.

Po certyfikacji

Po certyfikowaniu i wydaniu łącznika za pośrednictwem usług Microsoft Fabric i Microsoft Power BI należy wykonać kilka czynności, aby upewnić się, że można prawidłowo korzystać z łącznika certyfikowanego wdrożonego publicznie w środowisku produkcyjnym.

  • Ty i użytkownicy końcowi powinni używać certyfikowanej wersji łącznika zawartej w środowiskach przed certyfikacją (takich jak program Power BI Desktop i brama danych) i usunąć wszystkie istniejące pliki mez lub pqx (łączniki niestandardowe) używane przed certyfikacją. Niepowodzenie tego może spowodować, że testowany łącznik niestandardowy będzie używany przypadkowo przez dodatek Power Query zamiast nowo certyfikowanego łącznika.
  • Łączniki niestandardowe powinny być używane tylko do testowania nowych wersji łącznika.
  • Podczas pracy z użytkownikami końcowymi i klientami upewnij się, że rozumieją niestandardową wersję łącznika używaną podczas testowania przed certyfikacją, należy usunąć po zakończeniu testowania, a nowa certyfikowana wersja łącznika jest dostępna.