Создание и изменение виртуальных таблиц, содержащих данные из внешнего источника данных

Виртуальная таблица — это настраиваемая таблица в Microsoft Dataverse с столбцами, содержащими данные из внешнего источника данных. Виртуальные таблицы отображаются в приложении пользователям как обычные строки таблиц, но содержат данные, полученные из внешней базы данных, например базы данных SQL Azure. Строки на основе виртуальных таблиц доступны во всех клиентах, включая пользовательские клиенты, разработанные с помощью веб-служб Dataverse.

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

Виртуальные таблицы состоят из трех основных компонентов, поставщика данных, строки источника данных и виртуальной таблицы. Поставщик данных состоит из подключаемых модулей и таблицы источника данных. Источник данных — это строка таблицы в Dataverse, которая включает метаданные, представляющие схему параметров подключения. Каждая виртуальная таблица ссылается на источник данных в определении таблицы.

Dataverse включает поставщика данных OData, который можно использовать для подключения к веб-службе OData v4, которая получает доступ к внешним данным.

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

Преимущества виртуальной таблицы

• Разработчики могут реализовать плагины [или подключаемые модули] для чтения, обновления или удаления внешних данных с помощью веб-службы Dataverse и инструмента регистрации плагинов.
• Настройщики системы используют обозреватель решений Power Apps для настройки строки источника данных и создания виртуальных таблиц, которые используются для доступа к внешним данным без написания кода.
• Конечные пользователи работают с строками, созданными виртуальной таблицей, для просмотра данных в столбцах, сетках, результатах поиска и сборе отчетов и панелей мониторинга на основе XML.

Добавление источника данных для использования для виртуальных таблиц

Разработчики создают настраиваемый подключаемый модуль для использования в качестве поставщика данных для виртуальной таблицы. Кроме того, можно использовать предусмотренный поставщик данных OData v4. Дополнительные сведения: Конфигурация, требования и рекомендации для поставщика данных OData v4

1. Войдите в Power Apps и выберите пункт "Дополнительные>параметры".

2. Перейдите в раздел Параметры>Администрирование>Источники данных виртуальных сущностей.

3. На панели инструментов действий выберите Создать.

4. В диалоговом окне "Выбор поставщика данных" выберите из следующих источников данных и нажмите кнопку "ОК".

   Поставщик данных	Description
   Настраиваемый поставщик данных	Если был импортирован подключаемый модуль поставщика данных, этот поставщик данных будет отображаться здесь. Дополнительные сведения о документации разработчика: начало работы с виртуальными таблицами
   Поставщик данных OData версии 4	Dataverse включает поставщика данных OData, которого можно использовать с веб-службами OData четвёртой версии. Дополнительные сведения о конфигурации, требованиях и рекомендациях поставщика данных OData версии 4

Добавление защищенного столбца в источник данных

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

Создание виртуальной таблицы

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

Откройте обозреватель решений

Часть имени создаваемой виртуальной таблицы — префикс настройки. Это настраивается с использованием издателя решений для решения, в котором выполняется работа. Если для вас важен префикс пользовательской настройки, убедитесь, что вы работаете в неуправляемом решении, где префикс настройки соответствует нужному для этой виртуальной таблицы. Дополнительные сведения. Изменение префикса издателя решения

Открытие неуправляемого решения

1. В Power Apps выберите "Решения" в области навигации слева, а затем на панели инструментов выберите "Перейти к классической". Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.

2. В списке "Все решения" откройте нужное неуправляемое решение.

Создание виртуальной таблицы

1. В обозревателе решений создайте новую таблицу. Для этого выберите Сущности в левой области переходов, затем выберите Создать.

2. На вкладке Общие сведения раздела Определение сущности выберите Виртуальная сущность, затем в раскрывающемся списке Источник данных выберите требуемый источник данных.

   

3. В определении сущности заполните следующие обязательные столбцы.

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

   Ниже приведен пример виртуальной таблицы с именем Movie , которая использует поставщик данных Azure Cosmos DB для доступа к файлам документов.

   

   Это важно

   Некоторые опции, такие как группы доступа, быстрое создание и очереди, недоступны в виртуальных таблицах. Дополнительные сведения об использовании виртуальных таблиц

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

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

   Поле	Description
   Внешнее имя	Обычно это уникальное имя для идентификации данных, отображаемых в столбце.
   Имя внешнего типа	Если создается столбец типа OptionSet: данное свойство сопоставляется внешнему имени набора значений во внешнем сервисе для набора выбора. Как правило, это может быть перечисление или класс со строковым значением. Имя внешнего типа можно использовать, если требуется полное имя. Например, в качестве параметра Имя типа с OData, где параметры в запросе требуют полного имени, например [Имя типа].[Значение].
   Внешнее значение	Если создаваемый тип столбца — OptionSet: это свойство сопоставляется с соответствующим значением во внешнем источнике данных для элемента выбора. Это значение используется для определения элемента выбора, отображаемого в приложении.

   Заполните дополнительные свойства по мере необходимости. Дополнительные сведения об этих свойствах см. в разделе "Создание и изменение столбцов".

5. Нажмите кнопку "Сохранить и закрыть " на странице свойств столбца .

6. На панели инструментов обозревателя решений выберите Сохранить.

7. На панели инструментов обозревателя решений выберите Опубликовать.

8. Закройте обозреватель решений.

Рекомендации при использовании виртуальных таблиц

Виртуальные таблицы имеют эти ограничения.

• Существующие таблицы нельзя преобразовать в виртуальные таблицы.
• По умолчанию виртуальные таблицы содержат только столбец "Имя" и "Идентификатор". Другие системные управляемые столбцы, такие как Статус или Создано/Изменено, не поддерживаются.
• Виртуальные таблицы не поддерживают пользовательские столбцы с типами данных "Валюта", "Образ" или "Клиент".
• Виртуальные таблицы не поддерживают аудит.
• Столбцы виртуальных таблиц нельзя использовать в свертках или вычисляемых столбцах.
• Виртуальная таблица не может иметь тип "Действие" таблицы.
• Панели мониторинга и диаграммы не поддерживаются виртуальными таблицами.
• Многие функции, влияющие на строки таблиц, нельзя включить с виртуальными таблицами. Примеры включают очереди, управление знаниями, соглашения об уровне обслуживания, обнаружение дубликатов, отслеживание изменений, возможность автономного работы мобильных устройств, безопасность столбцов, поиск dataverse и решения Power Pages.
• Виртуальные таблицы принадлежат организации и не поддерживают концепции безопасности Dataverse на уровне строк. Рекомендуется реализовать собственную модель безопасности для внешнего источника данных.
• Свойства метаданных столбца, проверяющие обновление, не применяются к виртуальным таблицам. Например, столбец "Целое число" в столбце виртуальной таблицы может иметь минимальное значение нуля. Однако, так как значение поступает из внешнего источника данных, запрос вернет значения меньше нуля при получении из виртуальной таблицы. Свойство минимального значения не подразумевается в запросе. Вам все равно потребуется фильтровать значения, которые больше 0, если это вам требуется.
• Виртуальные таблицы не поддерживают отслеживание изменений и не могут быть синхронизированы с помощью функции Dataverse, например службы экспорта данных или Azure Synapse Link для Dataverse.
• Виртуальные таблицы, использующие встроенный поставщик данных OData версии 4, активированы на исходящем порту 443.
• Потоки бизнес-процессов не поддерживаются виртуальными таблицами. Дополнительная информация: Получена непредвиденная ошибка, когда пользователь активирует поток бизнес-процесса

Получена непредвиденная ошибка, когда пользователь активирует поток бизнес-процесса

Когда пользователь пытается активировать поток бизнес-процесса, он может получить сообщение о «непредвиденной ошибке». При просмотре файла журнала отображается следующая запись журнала.

ErrorCode: 0x80040216 Сообщение: System.Web.HttpUnhandledException: было создано исключение типа «System.Web.HttpUnhandledException». ---> Microsoft.Crm.CrmException: поток бизнес-процесса не может быть включен для виртуальной сущности

Эта проблема возникает, так как виртуальные таблицы не поддерживают потоки бизнес-процессов.

См. также

Требования и лучшие методы для Поставщика данных OData v4
Создание и изменение таблиц
Настройка виртуальных таблиц в Power Pages