Настройка подключения Dataverse

В этой статье описаны действия по созданию подключения Dataverse.

Поддерживаемые типы аутентификации

Соединитель Dataverse поддерживает следующие типы проверки подлинности для копирования и потока данных 2-го поколения соответственно.

Настройте ваше подключение для Dataflow Gen2

Вы можете подключить поток данных 2-го поколения к Dataverse в Microsoft Fabric с помощью соединителей Power Query. Выполните следующие действия, чтобы создать подключение:

1. Проверьте возможности, ограничения и рекомендации , чтобы убедиться, что ваш сценарий поддерживается.
2. Полные предварительные требования для Dataverse.
3. Получение данных в системе Fabric.
4. Найдите URL-адрес среды Dataverse.
5. Подключение к Dataverse.

Возможности

• URL-адрес сервера
• Импорт
• DirectQuery (семантические модели Power BI)
• Продвинутый
  • Включите столбцы связей

Необходимые условия

У вас должна быть среда Dataverse.

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

Чтобы использовать соединитель Dataverse, в вашей среде должен быть включен параметр TDS endpoint. Дополнительные сведения: управление параметрами компонентов и устранение неполадок с подключением с помощью SQL для запроса данных

Чтобы использовать соединитель Dataverse, для подключения необходимо открыть один из TCP-портов 1433 или 5558. Порт 1433 используется автоматически. Однако если порт 1433 заблокирован, вместо этого можно использовать порт 5558. Чтобы включить порт 5558, необходимо добавить этот номер порта в URL-адрес среды Dataverse, например yourenvironmentid.crm.dynamics.com, 5558. Дополнительные сведения: SQL Server проблема с подключением из-за закрытых портов

Получение данных

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

1. В левой части Фабрики данных выберите Рабочие области.

2. В рабочей области Data Factory выберите Новый>Dataflow Gen2, чтобы создать новый поток данных.

   

3. В Power Query выберите Получить данные на ленте или выберите Получить данные из другого источника в текущем представлении.

   

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

   

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

   

Поиск URL-адреса среды Dataverse

Если вам нужно использовать порт 5558 для подключения к Dataverse, необходимо найти URL-адрес среды Dataverse. Откройте Power Apps. В правом верхнем углу страницы Power Apps выберите среду, к которой вы собираетесь подключиться. Щелкните и выберите Дополнительные параметры.

На открывающейся вкладке браузера скопируйте корень URL-адреса. Этот корневой URL-адрес является уникальным URL-адресом для вашей среды. URL-адрес находится в формате https://<yourenvironmentid>.crm.dynamics.com/. Убедитесь, что вы удалите https:// и конечный / из URL-адреса, прежде чем вставить его для подключения к вашей среде. Добавьте порт 5558 в конец URL-адреса среды, например yourenvironmentid.crm.dyamics.com 5558.

Подключение к Dataverse

Чтобы подключиться к Dataverse из Power Query Online:

1. Выберите параметр Dataverse на странице "Выбор источника данных". Дополнительные сведения: где получить данные

2. На странице "Подключение к источнику данных" оставьте url-адрес сервера пустым. Если оставить адрес пустым, выводится список всех доступных сред, к которым у вас есть разрешение на доступ в окне навигатора Power Query.

   

   Замечание

   Если вам нужно использовать порт 5558 для доступа к данным, необходимо загрузить определенную среду с портом 5558, добавленным в конце URL-адреса сервера. В этом случае перейдите к разделу «Поиск URL среды Dataverse» для получения инструкций по получению правильного URL-адреса сервера.

3. При необходимости введите локальный шлюз данных, если вы собираетесь использовать локальные данные. Например, если вы собираетесь объединить данные из Dataverse и локальной базы данных SQL Server.

4. Войдите в учетную запись организации.

5. После успешного входа нажмите кнопку "Далее".

6. На странице навигации выберите необходимые данные и выберите команду "Преобразовать данные".

   

Ограничения и рекомендации

Специфичный для хоста Excel

Соединитель dataverse Power Query в Excel в настоящее время не поддерживает независимые облачные кластеры (например, Китай, Германия, США).

Ограничения производительности и лимиты на Dataverse

Сведения о ограничениях производительности и регулирования для подключений Dataverse см. в раздел "Ограничения запросов" и "Выделение". Эти ограничения применяются как к соединителю Dataverse, так и к соединителю канала OData при доступе к одной конечной точке.

Скорость извлечения таблицы

В качестве руководства большинство стандартных таблиц извлекается примерно со скоростью 500 строк в секунду с помощью соединителя Dataverse. Учитывайте эту скорость при решении, хотите ли вы подключиться к Dataverse или экспортировать данные в озеро данных. Если вам требуется более быстрая скорость получения данных, рассмотрите возможность использования функции "Экспорт в озеро данных" или конечной точки табличного потока данных (TDS). Для получения дополнительной информации перейдите к альтернативным подключениям Dataverse.

Альтернативные подключения Dataverse

Существует несколько альтернативных способов извлечения и переноса данных из Dataverse:

• Используйте функцию Azure Synapse Link в Power Apps для извлечения данных из Dataverse в Azure Data Lake Storage Gen2, которые затем можно использовать для выполнения аналитики. Дополнительные сведения о функции Azure Synapse Link см. в статье Что такое Azure Synapse Link для Dataverse?.

• Используйте соединитель OData для перемещения данных в Dataverse и из него. Дополнительные сведения о переносе данных между средами Dataverse с помощью соединителя OData потоков данных см. в разделе "Миграция данных между средами Dataverse" с помощью соединителя OData потоков данных.

SQL Server проблема с подключением из-за закрытых портов

При подключении к соединителю Dataverse может возникнуть ошибка Не удалось подключиться, указывающая на сетевую ошибку или ошибку, связанную с конкретным экземпляром, при установлении подключения к SQL Server. Эта ошибка, скорее всего, вызвана блокировкой TCP-портов 1433 или 5558 во время подключения. Чтобы устранить ошибку заблокированного порта, перейдите к заблокированным портам.

Использование собственных запросов к базе данных с Dataverse

Вы можете подключиться к Dataverse с помощью пользовательской инструкции SQL или собственного запроса базы данных. Хотя для этого интерфейса нет пользовательского интерфейса, вы можете ввести запрос с помощью Power Query Advanced Editor. Чтобы использовать собственный запрос базы данных, необходимо указать базу данных в качестве источника.

Source = CommonDataService.Database([DATABASE URL])

После определения источника базы данных можно указать собственный запрос с помощью функции Value.NativeQuery .

myQuery = Value.NativeQuery(Source, [QUERY], null, [EnableFolding=true])

В целом запрос выглядит следующим образом.

let
    Source = CommonDataService.Database("[DATABASE]"),
    myQuery = Value.NativeQuery(Source, "[QUERY]", null, [EnableFolding=true])
in
    myQuery

Ошибка в названии столбца может привести к возникновению сообщения об ошибке сворачивания запросов вместо сообщения об отсутствии столбца.

Доступ к большим объемам данных Dataverse

Запросы к таблицам Dataverse могут возвращать большие объемы данных. Если вы используете соединитель Power Query Dataverse, любой конкретный запрос, обращающийся к модели, имеет фиксированное 5-минутное время ожидания независимо от размера данных. Дополнительные сведения см. в ограничениях. Поэтому может потребоваться несколько раз запрашивать данные, чтобы получить доступ ко всем данным в модели. Использование нескольких запросов может занять значительное время, чтобы вернуть все данные.

Если вы используете соединитель Common Data Service (Устаревшая версия), вы можете использовать один запрос для доступа ко всем данным. Этот соединитель работает по-разному и возвращает результат в "страницах" записей 5-K. Хотя соединитель Common Data Service (Устаревшая версия) эффективнее при возврате больших объемов данных, он все равно может занять много времени, чтобы вернуть результат.

Вместо использования этих соединителей для доступа к большим объемам данных Dataverse рекомендуется использовать Azure Synapse Link для доступа к большим моделям. Использование Azure Synapse Link более эффективно, чем использование соединителей Power Query Dataverse или Common Data Service (Устаревшая версия), и оно специально разработано для сценариев интеграции данных.

Проблемы с производительностью, связанные со столбцами связей

Ошибки предварительного просмотра могут возникать из-за известного ограничения, когда функция свойств навигации включена в Dataverse.

Например, можно увидеть следующее сообщение: Preview.Error: The type of the current preview value is too complex to display.

Чтобы устранить эту проблему, аналогичную соединителю SQL Server, в соединителе Dataverse можно отключить свойства навигации (столбцы связей) для повышения производительности. Этот параметр можно задать в параметрах advanced доступных в Power Query Online, или его можно задать с помощью параметра CreateNavigationProperties=false в функции соединителя Dataverse.

 Source = CommonDataService.Database("{crminstance}.crm.dynamics.com",[CreateNavigationProperties=false]),

Связанный контент

• Дополнительные сведения об этом соединителе см. в документации по соединителю Dataverse.