Udostępnij za pośrednictwem

Certyfikacja łącznika usługi Data Factory

  • Artykuł

Ważne

Program certyfikacji łącznika jest obecnie w trakcie zmian, a rejestracja nowych certyfikatów łącznika jest obecnie wstrzymana. Ten artykuł zostanie zaktualizowany po ponownym uruchomieniu programu certyfikacji łącznika dla nowych partnerów. Jeśli masz certyfikowany łącznik, który chcesz zaktualizować, skontaktuj się z naszym zespołem, dataconnectors@microsoft.com aby uzyskać instrukcje dotyczące przesyłania nowej wersji. Zgłoszenia są przetwarzane co miesiąc, a ostateczny termin ich przesyłania przypada na pierwszy wtorek każdego miesiąca.

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 w wersji zapoznawczej, 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.

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.

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).

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.