Денодо

Сводка

Предпосылки

Чтобы использовать этот соединитель, установите и настройте платформу Denodo и запустите ее службу. Если у вас есть подключение, использующее имя источника данных ODBC (DSN), необходимо правильно настроить подключение в администраторе источника данных ODBC.

Поддерживаемые возможности

• Импорт
• DirectQuery (семантические модели Power BI)

Подключение к источнику данных ODBC из Power Query Desktop

Чтобы сделать подключение, выполните следующие действия.

1. Чтобы подключиться к данным, на ленте "Главная " выберите "Получить данные". В разделе "База данных " выберите "Денодо".

   

2. Существует два способа подключения к источнику данных.

   • DSN (имя источника данных ODBC)
   • строка подключения

   В диалоговом окне "Соединитель Дедоно" в разделе "DSN" или "Строка подключения " укажите имя источника данных или строку подключения в зависимости от выбранного типа подключения.

   

   При создании строки подключения, совместимой с Денодо, необходимо опустить поле Driver , так как это поле прозрачно устанавливается во время подключения самим соединителем.

   Строка подключения должна содержать три обязательных параметра: SERVER, PORTи DATABASE.

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

   Кроме того, он может содержать необязательный параметр: SSLmode

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

   Опустить параметры проверки подлинности. Вы настроите проверку подлинности на последующих шагах.

   Замечание

   При записи строки подключения помните о следующих требованиях:

   • Строка подключения должна иметь правильный порядок его параметров: SERVER, PORT, DATABASEи SSLMode.
   • Имя этих параметров всегда должно быть записано одинаково. Например, если вы решили написать их в верхнем регистре, они всегда должны быть написаны в верхнем регистре. Если вы решите написать их с первой буквой слова в верхнем регистре и остальными буквами в нижнем регистре, они всегда должны быть написаны таким образом.

   В противном случае Power BI может не распознавать разные наборы данных Denodo в отчете как принадлежащие одному источнику данных Denodo. В результате Power BI может запрашивать отдельные учетные данные проверки подлинности для каждого из них.

3. Второй раздел Включить режим отладки, является необязательным полем, которое позволяет добавлять сведения трассировки в файлы журнала. Power BI Desktop создает эти файлы при включении трассировки в приложении с помощью вкладки "Диагностика " в меню "Параметры ". Значение по умолчанию для включения режима отладки равно false, и в этом сценарии в файлах журнала нет данных трассировки из настраиваемого соединителя Denodo Power BI.

4. Третий раздел , Машинный запрос, является необязательным полем, где можно ввести запрос. Если вы используете это поле запроса, набор данных является результатом запроса вместо таблицы или набора таблиц.

   Вы можете написать запрос, который запрашивает только одну из баз данных, с которым связан источник данных.

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

   Если вы хотите написать запрос, который запрашивает несколько баз данных, необходимо указать в запросе базу данных, которая владеет каждой таблицей.

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

5. Последний раздел в Соединителе Denodo — это режим подключения к данным, где можно выбрать режим импорта или режим DirectQuery.

6. По завершении нажмите кнопку "ОК".

7. Теперь вам будет предложено выполнить проверку подлинности. Настраиваемый соединитель Denodo Power BI поддерживает три типа проверки подлинности:

   • Windows: при выборе использования проверки подлинности Windows Power BI Desktop подключается к Virtual DataPort с помощью проверки подлинности Kerberos.

     

     В данном случае:

     • Проверка подлинности Kerberos должна быть включена на сервере Virtual DataPort.

     • База данных Denodo Virtual DataPort, к которому подключается источник данных, должна быть настроена с параметром типа проверки подлинности ODBC/ADO.net , заданного для Kerberos.

     • Power BI Desktop должен работать в домене Windows, так как драйвер ODBC запрашивает билет Kerberos из кэша билетов операционной системы.

     • Убедитесь, что страница "Дополнительные параметры " конфигурации DSN содержит всю необходимую конфигурацию для использования Kerberos в качестве метода проверки подлинности.

       

   • Базовый. Этот тип проверки подлинности подключает Power BI Desktop к данным Virtual DataPort с помощью учетных данных сервера Virtual DataPort.

     

     Замечание

     Более ранние версии соединителя Denodo требовали, чтобы избежать определенных символов пароля. По состоянию на версию 1.0.8 это правило больше не требуется.

   • Учетная запись организации. Этот тип проверки подлинности подключает Power BI Desktop к данным Virtual DataPort с помощью определенного набора учетных данных Майкрософт. Этот параметр является специализированной версией OAuth для идентификатора Microsoft Entra.

     

     При нажатии кнопки "Вход" откроется вкладка входа. Введите учетные данные Майкрософт, которые будут использоваться для этого источника данных.

     

     При входе нажмите кнопку "Подключить". Затем отобразится экран навигатора для выбора таблицы.

     

     Замечание

     Чтобы получить доступ к базам данных Virtual DataPort, необходимо создать пользователя в Denodo. Имя пользователя должно совпадать с именем электронной почты, используемой в Power BI при входе пользователя в учетную запись организации. При создании пользователя в Denodo необходимо выбрать EXTERNAL в качестве типа проверки подлинности. Разрешения, предоставленные этому пользователю в базах данных Denodo, определяют, к каким базам данных можно получить доступ из Power BI Desktop.

8. По завершении нажмите кнопку "Подключить".

9. В навигаторе выберите нужную базу данных и данные, а затем выберите "Загрузить". Кроме того, если вы собираетесь изменить входящие данные, выберите "Преобразовать данные".

   

Подключение к Denodo из Power Query Online

Чтобы подключиться к данным Denodo, выполните приведенные действия.

1. Выберите Denodo на странице Power Query Подключение к источнику данных.

2. В диалоговом окне Denodo введите DSN или строку подключения для экземпляра Denodo. Для строка подключения необходимо указать параметры SERVER, PORT и DATABASE.

3. Выберите, следует ли заниматься режимом отладки.

4. Добавьте имя локального шлюза данных.

   Замечание

   Локальный шлюз данных является обязательным, так как соединитель Denodo использует драйвер ODBC, который должен быть установлен на компьютере шлюза.

5. Выберите тип проверки подлинности и укажите свои учетные данные:

   • Базовый: введите имя пользователя и пароль Denodo.
   • Учетная запись организации: вход с помощью учетной записи организации.

6. Чтобы продолжить, выберите Далее.

7. На странице Choose data выберите представления или таблицы, которые нужно загрузить, а затем выберите Трансформ данных для преобразования данных в Редактор Power Query.

Подключение к источнику данных ODBC из службы Power BI

Для этого метода подключения используется локальный шлюз данных. Выполните следующие действия:

1. Настройте локальный шлюз данных (корпоративный шлюз). Этот шлюз обеспечивает быструю и безопасную передачу данных между локальными данными (данные в приложении Power BI Desktop, а не в облаке) и службой Power BI.

2. Войдите и зарегистрируйте шлюз. В локальном приложении шлюза данных выберите вкладку "Состояние ", чтобы убедиться, что шлюз подключен к сети и готов к использованию.

   

3. В службе Power BI в параметрах источника данных создайте источник данных для пользовательского соединителя Denodo Power BI.

   

   Чтобы создать источник данных, необходимо указать способ подключения к источнику данных.

   • DSN
   • строка подключения

   Замечание

   Мы рекомендуем DSN. Он предоставляет множество параметров конфигурации, которые могут быть недоступны напрямую при использовании строки подключения.

   Кроме того, необходимо указать режим проверки подлинности. Доступные методы проверки подлинности:

   • Windows: служба Power BI подключается к Virtual DataPort через проверку подлинности Kerberos.

     • В параметрах источника данных введите имя пользователя и пароль для создания билета Kerberos.
     • На сервере Virtual DataPort включите проверку подлинности Kerberos.
     • База данных Denodo Virtual DataPort, к которому подключается источник данных, должна быть настроена с параметром типа проверки подлинности ODBC/ADO.net , заданного для Kerberos.
     • Убедитесь, что страница "Дополнительные параметры " конфигурации DSN содержит всю необходимую конфигурацию для использования Kerberos в качестве метода проверки подлинности.

     

   • Базовый. Вы можете создать источник данных в службе Power BI для подключения к данным Virtual DataPort с помощью учетных данных сервера Virtual DataPort.

   • Oauth. Вы можете создать источник данных в службе Power BI для подключения к данным Virtual DataPort с помощью учетных данных Майкрософт.

     Замечание

     Чтобы получить доступ к базам данных Virtual DataPort, необходимо создать пользователя в Denodo, имя которого совпадает с именем электронной почты, используемой в Power BI при входе в учетную запись организации. При создании пользователя в Denodo необходимо выбрать EXTERNAL в качестве типа проверки подлинности. Разрешения, предоставленные этому пользователю в базах данных Denodo, определяют, к каким базам данных можно получить доступ из Power BI.

4. При использовании проверки подлинности Windows в разделе "Дополнительные параметры " для источника данных можно включить схему проверки подлинности единого входа. Затем вы можете использовать те же учетные данные пользователя, которые используются для доступа к отчетам в Power BI, чтобы получить доступ к необходимым данным в Denodo.

   

   Существует два варианта включения единого входа: использование единого входа с помощью Kerberos для запросов DirectQuery и использование единого входа через Kerberos для DirectQuery и импорта запросов. Если вы работаете с отчетами на основе DirectQuery, оба варианта используют учетные данные единого входа пользователя, который входит в службу Power BI. Если вы работаете с отчетами на основе импорта, первый параметр использует учетные данные, введенные на странице источника данных (поля имени пользователя и пароля ), в то время как последний использует учетные данные владельца набора данных.

   Существуют определенные предварительные требования и рекомендации, которые необходимо учитывать для использования единого входа на основе Kerberos. Ниже приведены некоторые из следующих требований:

   • Необходимо включить ограниченное делегирование Kerberos для пользователя Windows под управлением шлюза Power BI. Кроме того, настройте локальные среды Active Directory и Microsoft Entra ID в соответствии с инструкциями, предлагаемыми корпорацией Майкрософт для этой цели.

     По умолчанию шлюз Power BI отправляет имя пользователя (UPN) при выполнении операции проверки подлинности единого входа (SSO). Необходимо просмотреть атрибут, используемый в качестве идентификатора входа в аутентификации Denodo Kerberos. Если оно отличается от userPrincipalName, настройте параметры шлюза в соответствии с данным значением.

   • Файл конфигурации шлюза Power BI — это Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, который расположен в \Program Files\On-premises data gateway. Этот файл имеет два свойства, называемые ADUserNameLookupProperty и ADUserNameReplacementProperty, позволяющие шлюзу выполнять локальные поиски идентификаторов Microsoft Entra ID во время выполнения. ADUserNameLookupProperty необходимо указать, к какому атрибуту локального Active Directory следует сопоставить имя основного пользователя, полученное из Microsoft Entra ID. Таким образом, в этом сценарии ADUserNameLookupProperty должно быть userPrincipalName. Затем, когда пользователь найден, значение ADUserNameReplacementProperty указывает атрибут, который должен использоваться для аутентификации олицетворенного пользователя (атрибут, используемый в качестве идентификатора входа в Denodo).

     Изменения в этом файле конфигурации находятся на уровне шлюза, и эти изменения влияют на любой источник, с помощью которого выполняется проверка подлинности единого входа через шлюз Power BI.

5. После создания источника данных для соединителя Denodo можно обновить отчеты Power BI. Чтобы опубликовать отчет на сайте powerbi.com:

   • Откройте отчет в Power BI Desktop.
   • Выберите Файл>Опубликовать>Опубликовать в Power BI.
   • Сохраните отчет на компьютере.
   • Выберите рабочую область, в которой требуется опубликовать.

Расширенная конфигурация

Использование параметра ConnectionTimeout

Если вы хотите контролировать, сколько времени ждать, прежде чем отказаться от попытки подключения к серверу, можно использовать ConnectionTimeout этот параметр.

Используйте этот параметр только из расширенного редактора. Для этого ConnectionTimeout параметр необходимо добавить в параметры записи, связав значение типа duration с ним.

Дополнительные сведения о типе duration в этой статье.

Использование параметра QueryTimeout

Если вы хотите контролировать, сколько времени ждать, прежде чем отказаться от попытки выполнения запроса, можно использовать QueryTimeout этот параметр.

Используйте этот параметр только из расширенного редактора. Для этого QueryTimeout параметр необходимо добавить в параметры записи, связав значение типа number с ним. Это числовое значение представлено в миллисекундах (например, 10000 равно 10 секунд).

Использование параметра UserAgent

Если вы хотите указать имя клиентского приложения, можно использовать UserAgent этот параметр.

Используйте этот параметр только из расширенного редактора. Для этого параметр UserAgent необходимо добавить в параметры записи, связав его со значением типа text.

Использование параметра сжатия

Рекомендуется активировать этот параметр, если клиентское приложение и сервер Denodo подключены через глобальную сеть. В этих случаях можно ожидать значительных улучшений производительности, когда клиентское приложение считывает умеренные или большие объемы данных.

Используйте этот параметр только из расширенного редактора. Для этого параметр Compression необходимо добавить в параметры записи, назначив значение типа number (0 или 1).

Устранение неполадок

Если импортируемое в Power BI представление Denodo в качестве источника данных имеет более 42 отношений с другими представлениями, Power BI может отобразить следующую ошибку при попытке получить доступ к окну преобразования данных:

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

Эта ошибка возникает из-за ограничения на платформе Power Query. Чтобы обойти проблему, выберите источник данных (запрос) в окне преобразования данных и выберите Просмотр>Расширенный редактор. Затем измените выражение источника данных на языке M, добавив следующее свойство в options аргумент Denodo.Contents вызова функции:

CreateNavigationProperties=false

Таким образом, ваш звонок будет выглядеть примерно так:

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

Это свойство указывает Power BI не пытаться создавать свойства навигации из связей, зарегистрированных для представления Denodo, доступного в этом источнике данных. Если вам нужно, чтобы некоторые из этих связей присутствовали в модели данных Power BI, их необходимо зарегистрировать вручную.