Denodo

Uwaga / Notatka

Poniższy artykuł dotyczący łącznika jest dostarczany przez firmę Denodo, właściciela tego łącznika i członka programu certyfikacji Microsoft Power Query Connector. Jeśli masz pytania dotyczące zawartości tego artykułu lub zmiany, które chcesz zobaczyć w tym artykule, odwiedź witrynę internetową Denodo i skorzystaj z dostępnych tam kanałów pomocy technicznej.

Podsumowanie

Przedmiot	Opis
Status wydania	Ogólna dostępność
Produkty	Power BI (modele semantyczne) Power BI (przepływy danych) Sieć szkieletowa (Dataflow Gen2)
Obsługiwane typy uwierzytelniania	Podstawowy Windows

Uwaga / Notatka

Niektóre funkcje mogą być obecne w jednym produkcie, ale nie w innych ze względu na harmonogramy wdrażania i możliwości specyficzne dla hosta.

Wymagania wstępne

Aby korzystać z tego łącznika, musisz zainstalować platformę Denodo i skonfigurować i uruchomić jego usługę. W przypadku połączenia przy użyciu nazwy DSN ODBC należy prawidłowo skonfigurować połączenie w administratorze źródła danych ODBC.

Obsługiwane funkcje

• Importowanie
• Tryb DirectQuery (modele semantyczne usługi Power BI)

Nawiązywanie połączenia ze źródłem danych ODBC z poziomu programu Power Query Desktop

Aby nawiązać połączenie, wykonaj następujące czynności:

1. Aby nawiązać połączenie z danymi, wybierz pozycję Pobierz dane na wstążce Narzędzia główne i wybierz pozycję Denodo w sekcji Baza danych .

   

2. Istnieją dwa sposoby nawiązywania połączenia ze wybranym źródłem danych:

   • Za pomocą DSN (nazwa źródła danych ODBC)
   • Używanie ciągu połączenia

   W sekcji DSN lub Parametry połączenia w oknie dialogowym Łącznik Denodo podaj nazwę źródła danych (DSN) lub parametry połączenia w zależności od preferowanego typu połączenia.

   

   Podczas tworzenia ciągu połączenia zgodnego z Denodo, należy wziąć pod uwagę, że pole Sterownik musi zostać pominięte, ponieważ jest ono automatycznie ustawiane przez łącznik na czas połączenia.

   Parametry połączenia muszą zawierać trzy obowiązkowe parametry: SERWER, PORT i BAZA DANYCH:

   SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>
   

   Ponadto może zawierać opcjonalny parametr : SSLmode:

   SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>;SSLmode=<SSL mode>
   

   Parametry uwierzytelniania muszą zostać pominięte, ponieważ uwierzytelnianie jest konfigurowane w kolejnych krokach.

   Uwaga / Notatka

   Podczas zapisywania parametrów połączenia należy wziąć pod uwagę następujące elementy:

   • Ciąg połączenia musi zachować prawidłową kolejność swoich parametrów: SERVER, PORT, DATABASE i SSLMode.
   • Nazwa tych parametrów musi być zawsze zapisywana w taki sam sposób. Jeśli na przykład zdecydujesz się napisać je wielkimi literami, muszą one być zawsze zapisywane wielkimi literami; jeśli zdecydujesz się napisać je z wielką literą (pierwszą literę słowa wielką literą, a resztę małymi literami), muszą być zawsze napisane w ten sposób.

   W przeciwnym razie usługa Power BI może uniemożliwić rozpoznawanie różnych zestawów danych Denodo w raporcie jako należących do tego samego źródła danych Denodo i w konsekwencji zażądać oddzielnych poświadczeń uwierzytelniania dla każdego z nich.

3. Druga sekcja Enable debug mode (Włącz tryb debugowania) jest polem opcjonalnym, które umożliwia dodawanie informacji śledzenia do plików dziennika. Te pliki są tworzone przez program Power BI Desktop podczas włączania śledzenia w aplikacji przy użyciu karty Diagnostyka w menu Opcje . Należy pamiętać, że wartość domyślna dla ustawienia Włącz tryb debugowania to fałsz, a w tym scenariuszu nie będzie żadnych danych śledzenia w plikach dziennika z łącznika niestandardowego usługi Denodo Power BI.

4. Trzecia sekcja Zapytanie natywne jest polem opcjonalnym, w którym można wprowadzić zapytanie. Jeśli to pole zapytania jest używane, wynikowy zestaw danych będzie wynikiem zapytania zamiast tabeli lub zestawu tabel.

   Możesz napisać zapytanie, które wysyła zapytanie tylko do jednej z baz danych, z którymi jest skojarzone źródło danych.

   SELECT title, name FROM film JOIN language ON film.language_id = language.language_id WHERE film.language_id = 1
   

   Jeśli chcesz napisać zapytanie, które wykonuje zapytania dotyczące więcej niż jednej bazy danych, musisz określić w zapytaniu bazę danych, która jest właścicielem każdej tabeli.

   SELECT i_item_sk, country FROM sakila.country, ewd.item
   

5. Ostatnia sekcja w łączniku Denodo to tryb łączności danych, w którym można wybrać tryb importu lub tryb DirectQuery.

6. Po zakończeniu wybierz przycisk OK.

7. Przed wyświetleniem okna nawigatora, które pokazuje podgląd dostępnych danych w Denodo Virtual DataPort, zostanie wyświetlony monit o uwierzytelnienie. Łącznik niestandardowy Denodo Power BI obsługuje dwa typy uwierzytelniania: Windows i Basic.

   • Windows: w przypadku wybrania uwierzytelniania systemu Windows program Power BI Desktop łączy się z usługą Virtual DataPort przy użyciu uwierzytelniania Kerberos.

     

     W tym przypadku:

     • Uwierzytelnianie Kerberos musi być włączone na serwerze Virtual DataPort.

     • Baza danych Denodo Virtual DataPort, z którą łączy się źródło danych, musi być skonfigurowana przy użyciu opcji ODBC/ADO.net typu uwierzytelniania ustawionego na Kerberos.

     • Program Power BI Desktop musi być uruchomiony w domenie systemu Windows, ponieważ sterownik ODBC żąda biletu Kerberos z pamięci podręcznej biletów systemu operacyjnego.

     • Upewnij się, że strona Opcje zaawansowane konfiguracji DSN zawiera całą wymaganą konfigurację do używania protokołu Kerberos jako metody uwierzytelniania.

       

   • Podstawowy: ten typ uwierzytelniania umożliwia połączenie programu Power BI Desktop z danymi virtual DataPort przy użyciu poświadczeń serwera Virtual DataPort.

     

     Uwaga / Notatka

     Starsze wersje łącznika Denodo wymagały ucieczki od niektórych znaków hasła. Od wersji 1.0.8 nie jest to już potrzebne.

8. Po zakończeniu wybierz pozycję Połącz.

9. W nawigatorze wybierz potrzebne dane z bazy danych, a następnie wybierz pozycję Załaduj lub wybierz pozycję Przekształć dane , jeśli zamierzasz modyfikować dane przychodzące.

   

Nawiązywanie połączenia ze źródłem danych ODBC z usługi Power BI przy użyciu lokalnej bramy danych

Aby nawiązać połączenie, wykonaj następujące czynności:

1. Skonfiguruj lokalną bramę danych (bramę przedsiębiorstwa), która działa jako mostek, zapewniając szybki i bezpieczny transfer danych między lokalnymi danymi (danymi w aplikacji power BI Desktop, a nie w chmurze) i usługą Power BI.

2. Zaloguj się i zarejestruj swoją bramę. W aplikacji lokalnej bramy danych wybierz kartę Stan , aby sprawdzić, czy brama jest w trybie online i gotowa do użycia.

   

3. Korzystając ze strony ustawień bramy w usłudze Power BI, utwórz źródło danych dla niestandardowego łącznika Denodo Power BI.

   

   Aby utworzyć źródło danych, musisz określić sposób nawiązywania połączenia z wybranym źródłem danych:

   • Za pośrednictwem DSN
   • Używanie ciągu połączenia

   Uwaga / Notatka

   Podczas podejmowania decyzji, czy nawiązać połączenie za pośrednictwem parametrów połączenia, czy nazwy DSN, zaleca się użycie tego ostatniego. Dzieje się tak, ponieważ konfiguracja DSN oferuje o wiele więcej opcji konfiguracji, które mogą nie być dostępne bezpośrednio w przypadku używania parametrów połączenia.

   Należy również określić tryb uwierzytelniania. Dostępne metody uwierzytelniania to:

   • Windows: jeśli zdecydujesz się używać uwierzytelniania systemu Windows, usługa Power BI łączy się z usługą Virtual DataPort przy użyciu uwierzytelniania Kerberos. Potrzebujesz:

     • W obszarze Ustawienia źródła danych wprowadź nazwę użytkownika i hasło, aby utworzyć bilet protokołu Kerberos.

     • Uwierzytelnianie Kerberos musi być włączone na serwerze Virtual DataPort.

     • Baza danych Denodo Virtual DataPort, z którą łączy się źródło danych, musi być skonfigurowana przy użyciu opcji ODBC/ADO.net typu uwierzytelniania ustawionego na Kerberos.

     • Upewnij się, że strona Opcje zaawansowane konfiguracji DSN zawiera całą wymaganą konfigurację do używania protokołu Kerberos jako metody uwierzytelniania.

       

   • Podstawowy: ten typ uwierzytelniania umożliwia utworzenie źródła danych w usłudze Power BI w celu nawiązania połączenia z danymi usługi Virtual DataPort przy użyciu poświadczeń serwera Virtual DataPort.

4. Jeśli używasz uwierzytelniania systemu Windows, w obszarze Ustawienia zaawansowane dla źródła danych możesz włączyć schemat uwierzytelniania logowania jednokrotnego w celu użycia tych samych poświadczeń użytkownika, który uzyskuje dostęp do raportów w usłudze Power BI w celu uzyskania dostępu do wymaganych danych w denodo.

   

   Istnieją dwie opcje włączania SSO: Używanie SSO za pośrednictwem Kerberos dla zapytań DirectQuery i Używanie SSO za pośrednictwem Kerberos w przypadku zapytań DirectQuery i Import. Jeśli pracujesz z raportami opartymi na trybie DirectQuery, obie opcje używają poświadczeń SSO użytkownika logującego się do usługi Power BI. Różnica pojawia się, gdy pracujesz z raportami opartymi na Import. W tym scenariuszu pierwsza opcja używa poświadczeń wprowadzonych na stronie źródła danych (pola Nazwa użytkownika i hasło ), podczas gdy ta ostatnia używa poświadczeń właściciela zestawu danych.

   Należy pamiętać, że istnieją określone wymagania wstępne i zagadnienia, które należy wziąć pod uwagę w celu korzystania z logowania jednokrotnego opartego na protokole Kerberos. Oto niektóre z tych podstawowych wymagań:

   • Ograniczone delegowanie protokołu Kerberos musi być włączone dla użytkownika systemu Windows uruchamiającego bramę Microsoft Power BI Gateway, a konfiguracja zarówno lokalnych środowisk Active Directory, jak i Microsoft Entra ID powinna być wykonana zgodnie z instrukcjami Microsoft.

     Domyślnie brama Microsoft Power BI Gateway wysyła główną nazwę użytkownika (UPN) podczas wykonywania operacji uwierzytelniania za pomocą SSO. W związku z tym należy przejrzeć atrybut, który będzie używany jako identyfikator logowania w uwierzytelnianiu Denodo Kerberos, a jeśli różni się od userPrincipalName, dostosować ustawienia bramy zgodnie z tą wartością.

   • Plik konfiguracyjny usługi Microsoft Power BI Gateway o nazwie Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, przechowywany pod adresem \Program Files\On-premises data gateway, ma dwie właściwości o nazwie ADUserNameLookupProperty i ADUserNameReplacementProperty, które umożliwiają bramie wykonywanie lokalnych wyszukiwań identyfikatorów Microsoft Entra ID w czasie wykonywania. Element ADUserNameLookupProperty musi określać, względem którego atrybutu lokalnej usługi AD musi mapować główną nazwę użytkownika pochodzącą z identyfikatora Entra firmy Microsoft. Dlatego w tym scenariuszu ADUserNameLookupProperty powinien mieć wartość userPrincipalName. Następnie po znalezieniu użytkownika wartość wskazuje atrybut, ADUserNameReplacementProperty który powinien być używany do uwierzytelniania personifikowanego użytkownika (atrybut, który będzie używany jako identyfikator logowania w Denodo).

     Należy również wziąć pod uwagę, że zmiany w tym pliku konfiguracji znajdują się na poziomie bramy i w związku z tym będą mieć wpływ na każde źródło, za pomocą którego uwierzytelnianie jednokrotne odbywa się za pośrednictwem usługi Microsoft Power BI Gateway.

5. Po utworzeniu źródła danych dla łącznika Denodo można odświeżyć raporty usługi Power BI. Aby opublikować raport na powerbi.com, należy wykonać następujące kroki:

   • Otwórz raport w programie Power BI Desktop.
   • Wybierz Plik>Publikuj>Publikuj do usługi Power BI.
   • Zapisz raport na komputerze.
   • Wybierz obszar roboczy, w którym chcesz opublikować.

Konfiguracja zaawansowana

Użyj parametru ConnectionTimeout.

Jeśli chcesz kontrolować czas oczekiwania przed porzuceniem próby nawiązania połączenia z serwerem, możesz użyć parametru ConnectionTimeout .

Tego parametru można używać tylko z poziomu edytora zaawansowanego. Aby to zrobić, do opcji rekordu należy dodać parametr, przypisując mu wartość typu duration.

Dowiedz się więcej o typie durationtutaj.

Użycie parametru QueryTimeout.

Jeśli chcesz kontrolować czas oczekiwania przed porzuceniem próby wykonania zapytania, możesz użyć parametru QueryTimeout .

Tego parametru można używać tylko z poziomu edytora zaawansowanego. Aby to zrobić, należy dodać parametr QueryTimeout w opcjach rekordu, przypisując mu wartość typu number. Ta wartość liczbowa jest reprezentowana w milisekundach, na przykład 10000 jest równa 10s.

Użycie parametru UserAgent.

Jeśli chcesz określić nazwę aplikacji klienckiej, możesz użyć parametru UserAgent .

Tego parametru można używać tylko z poziomu edytora zaawansowanego. Aby to zrobić, parametr UserAgent należy dodać w opcjach rekordu, przypisując wartość typu text.

Użycie parametru Compression.

Zaleca się aktywowanie tego ustawienia, gdy aplikacja kliencka i serwer Denodo są połączone za pośrednictwem sieci WAN. W takich przypadkach można oczekiwać znacznej poprawy wydajności, gdy aplikacja kliencka odczytuje umiarkowane lub duże woluminy danych. W tym celu można użyć parametru Compression .

Tego parametru można używać tylko z poziomu edytora zaawansowanego. Aby to zrobić, w opcjach rekordu należy dodać parametr Compression, kojarząc wartość typu number (0 lub 1).

Rozwiązywanie problemów

Ładowanie danych, gdy pole w widoku Denodo ma więcej niż 42 relacje z innymi widokami.

Jeśli widok Denodo importowany jako źródło danych do usługi Power BI ma więcej niż 42 relacje z innymi widokami, usługa Power BI może wyświetlić następujący błąd podczas uzyskiwania dostępu do okna przekształcania danych:

Preview.Error: The type of the current preview value is too complex to display.

Ten błąd jest spowodowany ograniczeniem platformy Microsoft Power Query. Aby rozwiązać ten problem, wybierz w oknie przekształcania danych źródło danych, które jest uszkodzone (zapytanie) i uzyskaj dostęp do zaawansowanego edytora za pomocą widoku Wyświetl>Edytor zaawansowany. Następnie zmodyfikuj wyrażenie źródła danych w języku M, dodając następującą właściwość do options argumentu Denodo.Contents wywołania funkcji:

CreateNavigationProperties=false

Twoje połączenie wyglądałoby podobnie jak:

  Source = Denodo.Contents(<dsn>, null, [CreateNavigationProperties=false])

Ta właściwość spowoduje, że usługa Power BI nie spróbuje wygenerować właściwości nawigacji z relacji zarejestrowanych w widoku Denodo, do których dostęp jest uzyskiwany w tym źródle danych. Jeśli więc niektóre z tych relacji będą rzeczywiście obecne w modelu danych usługi Power BI, musisz ręcznie je zarejestrować później.