Denodo

Статья
01/24/2024

Примечание.

Следующая статья соединителя представлена Denodo, владельцем этого соединителя и членом программы сертификации Подключение or Microsoft Power Query. Если у вас есть вопросы о содержимом этой статьи или вы хотите просмотреть внесенные в эту статью изменения, посетите веб-сайт Denodo и используйте каналы поддержки там.

Итоги

Позиция	Description
Состояние выпуска	Общая доступность
Продукты	Power BI (семантические модели) Power BI (потоки данных) Fabric (Dataflow 2-го поколения)
Поддерживаемые типы проверки подлинности	Основные Windows

Примечание.

Некоторые возможности могут присутствовать в одном продукте, но не другие из-за расписаний развертывания и возможностей для конкретного узла.

Необходимые компоненты

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

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

Import
DirectQuery (семантические модели Power BI)

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

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

Чтобы подключиться к данным, выберите "Получить данные " на ленте "Главная " и выберите "Денодо " в разделе "База данных ".
Существует два способа подключения к источнику данных.
- Через DSN (имя источника данных ODBC)
- Использование строка подключения
В разделе dsN или Подключение ion String диалогового окна "Денодо" Подключение or укажите имя источника данных (DSN) или строку Подключение ion в зависимости от типа подключения, который вы предпочитаете.

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

Строка подключения должны содержать три обязательных параметра: 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 Desktop при включении трассировки в приложении с помощью вкладки "Диагностика " в меню "Параметры ". Обратите внимание, что значение по умолчанию для режима отладки равно false, и в этом сценарии данные трассировки в файлах журнала из настраиваемого соединителя Denodo Power BI не будут.
Третий раздел , Машинный запрос, является необязательным полем, где можно ввести запрос. Если используется это поле запроса, результирующий набор данных будет результатом запроса вместо таблицы или набора таблиц.

Можно написать запрос, который запрашивает только одну из баз данных, с которыми связан источник данных.
```
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
```
Последний раздел в Денодо Подключение or — режим подключения к данным, где можно выбрать режим импорта или режим DirectQuery.
По завершении нажмите кнопку ОК.
Перед отображением окна навигатора, отображающего предварительный просмотр доступных данных в Denodo Virtual DataPort, вам будет предложено выполнить проверку подлинности. Настраиваемый соединитель Denodo Power BI поддерживает два типа проверки подлинности: Windows и Basic.
- 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.
После завершения выберите Подключение.
В навигаторе выберите нужные данные из базы данных и выберите "Загрузить" или выберите "Преобразовать данные ", если вы собираетесь изменить входящие данные.

Подключение в источник данных ODBC из служба Power BI с помощью локального шлюза данных

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

Настройте локальный шлюз данных (корпоративный шлюз), который выступает в качестве моста, обеспечивая быструю и безопасную передачу данных между локальными данными (данные в приложении Power BI Desktop, а не в облаке) и служба Power BI.
Войдите и зарегистрируйте шлюз. В локальном приложении шлюза данных выберите вкладку "Состояние ", чтобы убедиться, что шлюз подключен к сети и готов к использованию.
С помощью страницы параметров шлюза в служба Power BI создайте источник данных для пользовательского соединителя Denodo Power BI.

Чтобы создать источник данных, необходимо указать способ подключения к источнику данных.
- Через DSN
- Использование строка подключения
Кроме того, необходимо указать режим проверки подлинности. Доступные методы проверки подлинности:
- Windows: при выборе использования проверка подлинности Windows служба Power BI подключается к Virtual DataPort с помощью проверки подлинности Kerberos. Необходимые компоненты:
  - В Параметры источника данных введите имя пользователя и пароль для создания билета Kerberos.
  - Проверка подлинности Kerberos должна быть включена на сервере Virtual DataPort.
  - База данных Denodo Virtual DataPort, к которому подключается источник данных, должна быть настроена с параметром типа проверки подлинности ODBC/ADO.net, заданного для Kerberos.
  - Убедитесь, что страница "Дополнительные параметры " конфигурации DSN содержит всю необходимую конфигурацию для использования Kerberos в качестве метода проверки подлинности.
- Базовый. Этот тип проверки подлинности позволяет создать источник данных в служба Power BI для подключения к данным Virtual DataPort с помощью учетных данных сервера Virtual DataPort.
Если вы используете проверка подлинности Windows, в разделе "Дополнительные параметры" для источника данных можно включить схему проверки подлинности единого входа (SSO), чтобы использовать те же учетные данные пользователя, который обращается к отчетам в Power BI для доступа к необходимым данным в Denodo.

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

Важно отметить, что существуют определенные предварительные требования и рекомендации, которые необходимо учитывать для использования единого входа на основе Kerberos. Ниже приведены некоторые из следующих основных требований:
- Ограниченное делегирование Kerberos должно быть включено для пользователя Windows под управлением Шлюза Microsoft Power BI, а конфигурация локальных сред Active Directory и Microsoft Entra ID должна выполняться в соответствии с инструкциями, предлагаемыми корпорацией Майкрософт для этой цели.
  
  По умолчанию Microsoft Power BI Gateway отправляет имя участника-пользователя (UPN) при выполнении операции проверки подлинности единого входа. Поэтому необходимо просмотреть атрибут, который будет использоваться в качестве идентификатора входа в Службе проверки подлинности Denodo Kerberos, и, если он отличается, userPrincipalNameизмените параметры шлюза в соответствии с этим значением.
- Файл конфигурации Microsoft Power BI Gateway с именем Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configADUserNameLookupProperty , хранящийся в \Program Files\On-premises data gateway двух свойствах, и ADUserNameReplacementProperty который позволяет шлюзу выполнять локальные поиски идентификатора Microsoft Entra во время выполнения. Необходимо ADUserNameLookupProperty указать, с каким атрибутом локального AD он должен сопоставить имя участника-пользователя, полученное из идентификатора Microsoft Entra. Таким образом, в этом сценарии ADUserNameLookupProperty должно быть userPrincipalName. Затем после обнаружения ADUserNameReplacementProperty пользователя значение указывает атрибут, который должен использоваться для проверки подлинности олицетворенного пользователя (атрибут, который будет использоваться в качестве идентификатора входа в Denodo).
  
  Кроме того, следует учитывать, что изменения в этом файле конфигурации находятся на уровне шлюза и, следовательно, повлияют на любой источник, с помощью которого выполняется проверка подлинности единого входа через Шлюз Microsoft Power BI.
После создания источника данных для соединителя Denodo можно обновить отчеты Power BI. Чтобы опубликовать отчет на powerbi.com, необходимо выполнить следующие действия.
- Откройте отчет в Power BI Desktop.
- Выберите публикацию>файлов>в Power BI.
- Сохраните отчет на компьютере.
- Выберите рабочую область, в которой требуется опубликовать.

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

Загрузка данных, когда поле в представлении Denodo имеет более 42 отношений с другими представлениями.

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

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

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

CreateNavigationProperties=false

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

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

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