Dataverse

Итоги

Предварительные условия

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

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

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

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

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

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

Подключение к Dataverse из Power Query Desktop

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

1. Выберите параметр Dataverse из Get Data. Дополнительные сведения: Где получить данные

2. Если вы подключаетесь к этому сайту впервые, выберите вход и введите учетные данные. Затем выберите Подключиться.

   

3. В Навигаторе выберите необходимые данные, а затем загрузите или преобразуйте данные.

   

4. Если вы используете Power Query из Power BI Desktop, вам будет предложено выбрать режим подключения Import или DirectQuery. Затем нажмите кнопку "ОК".

   

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

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

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

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

   

   Примечание.

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

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

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

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

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

   

Подключиться с использованием дополнительных параметров

Power Query Online предоставляет дополнительные параметры, которые можно добавить в запрос при необходимости.

В следующей таблице перечислены дополнительные параметры, которые можно задать в Power Query Online.

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

Поиск 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.

Когда следует использовать коннектор Common Data Service (Legacy)

Dataverse — это прямая замена соединителя Common Data Service. Однако могут возникнуть ситуации, когда следует выбрать соединитель Common Data Service (Устаревшая версия) вместо соединителя Dataverse.

Существуют определенные типы данных табличного потока данных (TDS), которые поддерживаются в OData при использовании устаревшей версии Common Data Service, но не поддерживаются в Dataverse. Поддерживаемые и неподдерживаемые типы данных перечислены в How Dataverse SQL отличается от Transact-SQL.

Все эти функции будут добавлены в соединитель Dataverse в будущем, после чего соединитель Common Data Service (Устаревшая версия) будет снят с использования.

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

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

специфичный для хоста 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 2-го поколения, которые затем можно использовать для выполнения аналитики. Дополнительные сведения о функции 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 Расширенный редактор. Чтобы использовать собственный запрос базы данных, необходимо указать базу данных в качестве источника.

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]),