Denodo

Podsumowanie

Wymagania wstępne

Aby użyć tego łącznika, zainstaluj i skonfiguruj platformę Denodo i uruchom jej usługę. Jeśli masz połączenie korzystające z nazwy źródła danych ODBC (DSN), musisz poprawnie skonfigurować połączenie w administratorze źródła danych ODBC.

Obsługiwane funkcje

• Importowanie
• DirectQuery (modele semantyczne 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, na wstążce Narzędzia główne wybierz pozycję Pobierz dane. W sekcji Baza danych wybierz pozycję Denodo.

   

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

   • DSN (nazwa źródła danych ODBC)
   • Łańcuch połączenia

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

   

   Podczas tworzenia parametrów połączenia zgodnych z rozwiązaniem Denodo należy pominąć pole Sterownik , ponieważ to pole jest jawnie ustawione w czasie połączenia przez sam łącznik.

   Parametry połączenia muszą zawierać trzy obowiązkowe parametry: SERVER, PORTi DATABASE.

   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>
   

   Pomiń parametry uwierzytelniania. Uwierzytelnianie można skonfigurować w kolejnych krokach.

   Uwaga / Notatka

   Podczas pisania parametrów połączenia należy pamiętać o następujących wymaganiach:

   • Ciąg połączenia musi zachować prawidłową kolejność jego 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ę na zapisanie ich w wielkich literach, muszą one być zawsze pisane wielkimi literami. Jeśli zdecydujesz się napisać je z pierwszą literą słowa w wielkiej literze i resztą liter w małych literach, zawsze muszą być napisane w ten sposób.

   W przeciwnym razie usługa Power BI może nie rozpoznać różnych zestawów danych Denodo w raporcie jako należących do tego samego źródła danych Denodo. W związku z tym usługa Power BI może 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. Program Power BI Desktop tworzy te pliki podczas włączania śledzenia w aplikacji przy użyciu karty Diagnostyka w menu Opcje . Wartość domyślna Włącz tryb debugowania to 'false', a w tym scenariuszu nie ma żadnych danych śledzenia w plikach dziennika z niestandardowego łącznika Power BI Denodo.

4. Trzecia sekcja Zapytanie natywne jest polem opcjonalnym, w którym można wprowadzić zapytanie. Jeśli używasz tego pola zapytania, zestaw danych jest wynikiem zapytania zamiast tabeli lub zestawu tabel.

   Możesz napisać zapytanie, które odwołuje się tylko do jednej z baz danych powiązanych ze źródłem 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. Teraz zostanie wyświetlony monit o uwierzytelnienie. Łącznik niestandardowy usługi Denodo Power BI obsługuje trzy typy uwierzytelniania:

   • Windows: w przypadku wybrania uwierzytelniania systemu Windows program Power BI Desktop łączy się z wirtualnym portem danych za pośrednictwem 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 łączy program Power BI Desktop z danymi virtual DataPort za pomocą 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 ta reguła nie jest już wymagana.

   • Konto organizacyjne: ten typ uwierzytelniania łączy program Power BI Desktop z danymi virtual DataPort za pomocą określonego zestawu poświadczeń firmy Microsoft. Ta opcja jest wyspecjalizowaną wersją protokołu OAuth dla identyfikatora Entra firmy Microsoft.

     

     Po wybraniu pozycji Zaloguj zostanie otwarta karta logowania. Wprowadź poświadczenia firmy Microsoft, które mają być używane dla tego źródła danych.

     

     Po zalogowaniu wybierz pozycję Połącz. Zostanie wyświetlony ekran nawigatora dla wyboru tabel.

     

     Uwaga / Notatka

     Aby uzyskać dostęp do baz danych Virtual DataPort, musisz utworzyć użytkownika w denodo. Nazwa użytkownika musi być taka sama jak adres e-mail używany w usłudze Power BI, gdy użytkownik loguje się do konta organizacyjnego. Podczas tworzenia użytkownika w denodo należy wybrać opcję EXTERNAL jako typ uwierzytelniania. Uprawnienia podane temu użytkownikowi w bazach danych Denodo określają, do których baz danych można uzyskać dostęp z programu Power BI Desktop.

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

9. W nawigatorze wybierz odpowiednią bazę danych i dane, a następnie wybierz pozycję Załaduj. Alternatywnie, jeśli zamierzasz zmodyfikować dane przychodzące, wybierz pozycję Przekształć dane.

   

Nawiązywanie połączenia z usługą Denodo z usługi Power Query Online

Aby nawiązać połączenie z danymi Denodo:

1. Wybierz pozycję Denodo na stronie Power Query Połącz ze źródłem danych.

2. W oknie dialogowym Denodo wprowadź nazwę DSN lub ciąg połączenia dla wystąpienia Denodo. W przypadku parametry połączenia należy określić parametry SERWER, PORT i BAZA DANYCH.

3. Wybierz, czy chcesz włączyć tryb debugowania.

4. Podaj nazwę lokalnej bramy danych.

   Uwaga / Notatka

   Lokalna brama danych jest wymagana, ponieważ łącznik Denodo używa sterownika ODBC, który musi być zainstalowany na maszynie bramy.

5. Wybierz rodzaj uwierzytelniania i podaj swoje poświadczenia:

   • Podstawowa: wprowadź nazwę użytkownika i hasło denodo.
   • Konto organizacyjne: zaloguj się przy użyciu konta organizacyjnego.

6. Wybierz przycisk Dalej , aby kontynuować.

7. Na stronie Choose data wybierz widoki lub tabele, które chcesz załadować, a następnie wybierz pozycję Transform data aby przekształcić dane w Edytor Power Query.

Nawiązywanie połączenia ze źródłem danych ODBC z usługi Power BI

W przypadku tej metody połączenia należy użyć lokalnej bramy danych. Wykonaj te kroki:

1. Skonfiguruj lokalną bramę danych (bramę przedsiębiorstwa). Ta brama zapewnia szybki i bezpieczny transfer danych między danymi lokalnymi (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. W usłudze Power BI w obszarze Ustawienia źródła danych utwórz źródło danych dla łącznika niestandardowego usługi Power BI Denodo.

   

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

   • DSN
   • Łańcuch połączenia

   Uwaga / Notatka

   Zalecamy DSN. Udostępnia wiele 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: usługa Power BI łączy się z wirtualnym portem danych za pośrednictwem uwierzytelniania Kerberos.

     • W obszarze Ustawienia źródła danych wprowadź nazwę użytkownika i hasło, aby utworzyć bilet protokołu Kerberos.
     • Na serwerze Virtual DataPort włącz uwierzytelnianie Kerberos.
     • 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.

     

   • Podstawowe: Można utworzyć źródło danych w usłudze Power BI w celu nawiązania połączenia z danymi Virtual DataPort za pomocą poświadczeń serwera Virtual DataPort.

   • Oauth: możesz utworzyć źródło danych w usłudze Power BI w celu nawiązania połączenia do danych Virtual DataPort za pomocą poświadczeń firmy Microsoft.

     Uwaga / Notatka

     Aby uzyskać dostęp do baz danych Virtual DataPort, należy utworzyć użytkownika w aplikacji Denodo, którego nazwa jest taka sama jak adres e-mail używany w usłudze Power BI podczas logowania się do konta organizacyjnego. Podczas tworzenia użytkownika w denodo należy wybrać opcję EXTERNAL jako typ uwierzytelniania. Uprawnienia podane temu użytkownikowi w bazach danych Denodo określają, do których baz danych można uzyskać dostęp z usługi Power BI.

4. Jeśli używasz uwierzytelniania systemu Windows, w sekcji Ustawienia zaawansowane źródła danych możesz włączyć logowanie jednokrotne (SSO), aby osoby wyświetlające raporty wysyłały zapytania do Denodo przy użyciu własnej tożsamości. Łącznik Denodo obsługuje dwie ścieżki logowania jednokrotnego: Kerberos i Microsoft Entra ID.

   Logowanie jednokrotne Kerberos:

   

   Istnieją dwie opcje włączenia logowania jednokrotnego Kerberos: Używanie logowania jednokrotnego za pośrednictwem protokołu Kerberos dla zapytań DirectQuery i Używanie logowania jednokrotnego za pośrednictwem protokołu Kerberos dla zapytań DirectQuery i importu. Jeśli pracujesz z raportami opartymi na DirectQuery, obie opcje używają poświadczeń SSO użytkownika, który loguje się do usługi Power BI. Jeśli pracujesz z raportami opartymi na importowaniu, pierwsza opcja używa poświadczeń wprowadzonych na stronie źródła danych (pól Nazwa użytkownika i hasło ), podczas gdy ta ostatnia używa poświadczeń właściciela modelu semantycznego.

   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 wymagań:

   • Musisz włączyć ograniczone delegowanie protokołu Kerberos dla użytkownika systemu Windows powiązanego z bramą usługi Power BI. Ponadto skonfiguruj zarówno lokalne środowiska Active Directory, jak i Microsoft Entra ID zgodnie z instrukcjami oferowanymi przez firmę Microsoft w tym celu.

     Domyślnie brama usługi Power BI wysyła główną nazwę użytkownika (UPN) podczas wykonywania operacji uwierzytelniania za pomocą logowania jednokrotnego. Przejrzyj atrybut, którego używasz jako identyfikatora logowania w uwierzytelnianiu Denodo Kerberos. Jeśli różni się od userPrincipalName, dostosuj ustawienia bramy, aby były zgodne.

   • Plik konfiguracji bramy usługi Power BI to Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, znajdujący się w lokalizacji \Program Files\On-premises data gateway. Ten plik ma dwie właściwości, ADUserNameLookupProperty i ADUserNameReplacementProperty, które umożliwiają bramie wykonywanie lokalnych wyszukiwań w usłudze Microsoft Entra ID w czasie wykonywania. ADUserNameLookupProperty określa, który atrybut Active Directory lokalnej bramy mapuje główną nazwę użytkownika na z Microsoft Entra ID. W tym scenariuszu ADUserNameLookupProperty powinien mieć wartość userPrincipalName. Po znalezieniu użytkownika wartość ADUserNameReplacementProperty wskazuje atrybut uwierzytelniający użytkownika, pod którego następuje podszywanie (atrybut używany w Denodo jako identyfikator logowania).

     Zmiany w tym pliku konfiguracji mają zastosowanie na poziomie bramy i mają wpływ na wszystkie źródła korzystające z uwierzytelniania logowania jednokrotnego za pośrednictwem bramy Power BI.

   Microsoft Entra ID logowanie jednokrotne (SSO):

   Po włączeniu logowania jednokrotnego Microsoft Entra ID (SSO) dla łącznika Denodo użytkownicy przeglądający semantyczny model DirectQuery wysyłają zapytania do Denodo przy użyciu własnej tożsamości Microsoft Entra ID. SSO w usłudze Entra ID eliminuje zależności od lokalnego Active Directory i ograniczonej delegacji protokołu Kerberos, których wymaga mechanizm Kerberos SSO.

   Logowanie jednokrotne (SSO) w usłudze Entra ID ma następujące wymagania wstępne:

   • Administrator dzierżawy usługi Power BI włącza Denodo SSO i logowanie jednokrotne Microsoft Entra ID dla bramy danych w ustawieniach dzierżawy.
   • Brama danych lokalnych działa w wersji, która obsługuje logowanie jednokrotne (SSO) Entra ID.
   • Serwer Denodo uruchamia wersję, która obsługuje weryfikację tokenu Microsoft Entra ID.

   

   Po włączeniu logowania jednokrotnego Denodo w dzierżawie opcje Logowanie jednokrotne na stronie źródła danych obejmują pole wyboru Użyj logowania jednokrotnego za pośrednictwem usługi Azure AD dla zapytań DirectQuery. Zaznacz to pole wyboru, aby włączyć logowanie jednokrotne Entra ID (SSO) dla każdego modelu semantycznego DirectQuery powiązanego z połączeniem danych.

   

   SSO usługi Entra ID dotyczy tylko modeli semantycznych DirectQuery. Importowanie modeli odpowiada na zapytania z zaimportowanych danych i nie przekazuje tożsamości użytkowników do źródła danych.

5. Po utworzeniu źródła danych dla łącznika Denodo można odświeżyć raporty usługi Power BI. Aby opublikować raport w powerbi.com:

   • 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życie parametru ConnectionTimeout

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

Użyj tego parametru tylko z edytora zaawansowanego. Aby to zrobić, do opcji rekordu należy dodać parametr, przypisując mu wartość typu ConnectionTimeout.

Dowiedz się więcej o typie duration w tym artykule.

Użycie parametru QueryTimeout

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

Użyj tego parametru tylko z edytora zaawansowanego. Aby to zrobić, do opcji rekordu należy dodać parametr, przypisując mu wartość typu QueryTimeout. Ta wartość liczbowa jest reprezentowana w milisekundach (na przykład 10000 równa 10 sekund).

Korzystanie z parametru UserAgent

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

Użyj tego parametru tylko z edytora zaawansowanego. Aby to zrobić, parametr UserAgent należy dodać w opcjach rekordu, przypisując wartość typu text.

Korzystanie z parametru kompresji

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

Użyj tego parametru tylko z 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

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 próby uzyskania 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 Power Query. Aby to obejść, wybierz źródło danych, które nie działa (zapytanie) w oknie przekształcania danych, a następnie wybierz pozycję 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ść nakazuje usłudze Power BI, aby nie próbowała wygenerować właściwości nawigacji na podstawie relacji zarejestrowanych w widoku Denodo, do których dostęp jest uzyskiwany w tym źródle danych. Jeśli chcesz, aby niektóre z tych relacji były obecne w modelu danych usługi Power BI, musisz je zarejestrować ręcznie później.