Денодо

Сводка

Предпосылки

Чтобы использовать этот соединитель, установите и настройте платформу 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, в разделе Дополнительные параметры для источника данных можно включить единый вход (SSO), чтобы пользователи, просматривающие отчеты, выполняли запросы к Denodo от своего имени. Соединитель Denodo поддерживает два пути единого входа: Kerberos и Microsoft Entra ID.

   Единый вход Kerberos:

   

   Существует два варианта включения SSO через Kerberos: Использовать SSO через Kerberos для запросов DirectQuery и Использовать SSO через 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.

   Microsoft Entra ID SSO (предварительная версия):

   Единый вход Microsoft Entra ID для коннектора Denodo доступен в предварительной версии. Когда этот параметр включен, пользователи, просматривающие семантическую модель DirectQuery, отправляют запросы в Denodo под своей учетной записью Microsoft Entra ID. Единый вход Entra ID устраняет зависимость от локальной службы Active Directory и ограниченного делегирования Kerberos, которые требуются для единого входа Kerberos.

   Для Entra ID SSO необходимы следующие предварительные условия:

   • Администратор арендатора Power BI включает единый вход Denodo и единый вход Microsoft Entra ID для шлюза данных в параметрах арендатора.
   • Локальный шлюз данных использует версию, поддерживающую единый вход (SSO) через Entra ID.
   • Сервер Denodo использует версию, поддерживающую проверку токенов Microsoft Entra ID.

   

   После включения единого входа Denodo в арендаторе параметры Single sign-on на странице источника данных включают флажок Использовать единый вход через Azure AD для запросов DirectQuery. Установите этот флажок, чтобы включить единый вход Entra ID для любой семантической модели DirectQuery, привязанной к подключению к данным.

   

   SSO Entra ID применяется только к семантическим моделям DirectQuery. Модели импорта отвечают на запросы на основе импортированных данных и не передают сведения о личности пользователей источнику данных.

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, их необходимо зарегистрировать вручную.