Поделиться через

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

  • Статья

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

Атрибут "Секрет источника данных" доступен только для столбцов, добавленных в форму источника данных.

Атрибут секрета источника данных.

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

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

Примечание

Хотя можно создать виртуальную таблицу, выбрав значение Нет в качестве источника данных, чтобы получить данные, виртуальной таблице требуется источник данных. Дополнительные сведения: Добавление источника данных для использования для виртуальных таблиц

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

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

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

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

  2. В списке Все решения выберите требуемое неуправляемое решение.

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

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

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

    Параметр виртуальной таблицы в определении таблицы.

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

    Поле Описание:
    Внешнее имя Введите имя таблицы во внешнем источнике данных, с которым сопоставляется эта таблица.
    Внешнее имя коллекции Введите имя таблицы во множественном числе во внешнем источнике данных, с которым сопоставляется эта таблица.

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

    Определение виртуальной таблицы с помощью поставщика данных Azure Cosmos DB.

    Важно!

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

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

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

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

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

  5. Выберите Сохранить и закрыть на странице свойств Столбец.

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

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

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

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

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

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

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

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

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

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

См. также

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

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).