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

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

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

Общие ограничения

• Используемая таблица или список должны содержать по крайней мере одно строковое поле для использования в качестве основного поля и одного поля GUID. Без этих строковых полей невозможно создать виртуальную таблицу и возникать ошибка во время этапа извлечения сведений о таблице.
  • SharePoint использует поле скрытого числового идентификатора, присутствующее во всех списках.
  • SQL может использовать поле GUID или поле целого числа.
  • Excel должно иметь поле GUID.
• Dataverse может создавать только столбцы, включающие типы данных, совместимые с Dataverse. Это ограничение включает следующие типы данных:
  • String
  • Многострочный текст (заметка)
  • Целое число
  • Десятичный знак
  • Число с плавающей точкой
  • Дата/время
  • Да/Нет (логическое значение)
  • Выбор (выбор из нескольких значений)
  • Гиперссылка/URL
• Dataverse не поддерживает следующие типы данных для виртуальных таблиц:
  • Файлы и вложения
  • Изображение
• Максимальное количество символов, разрешенное для текстового столбца в виртуальной таблице, составляет 4000 символов. Если в исходной таблице максимальное количество символов превышает это значение, любая операция создания или обновления, превышающая максимальное количество символов, приводит к ошибке проверки, и операция завершается ошибкой.
• Запросы виртуальной таблицы ограничены возвратом 1000 записей. Если у вас есть пользовательское многотабличное (полиморфное) отношение 1:N или N с виртуальной таблицей, любой запрос, превышающий это ограничение, завершается сбоем и приводит к ошибке. Используйте фильтрацию в своем запросе, чтобы уменьшить набор записей в качестве обходного пути для этого ограничения.
• Функция аудита недоступна для виртуальных таблиц, так как Dataverse может выполнять аудит и хранить его данные только для локально хранимых данных.
• Для виртуальных таблиц нельзя рассчитать сводки или вычисляемые поля. Это ограничение существует, так как свертки — это вычисление на стороне сервера в Dataverse, которое требует, чтобы данные хранились локально.
• Столбцы формул не могут использовать виртуальные таблицы.
• Виртуальная таблица Microsoft Entra ID, предоставляемая корпорацией Майкрософт, разрешает доступ только для чтения.
• Виртуальные таблицы Dataverse могут отображать значения в полях, которые превышают обычные максимальные значения Dataverse. Это происходит из-за того, что представленные значения не хранятся локально. Например, максимальное значение целочисленного числа Dataverse равно 100 000 000 000, но может получить и отобразить 9 000 000 000 000 000 из SharePoint. Однако если пользователь пытается изменить число до размера, превышающего максимальный допустимый размер в Dataverse, отображается ошибка, указывающая, что запись не может быть сохранена, так как она превышает максимальный размер.
• Функция импорта и экспорта данных таблицы не поддерживается для виртуальных таблиц.
• Запросы к виртуальным таблицам, использующим операторы отрицательного фильтра, такие как "Не равно" или "Не содержит", могут привести к неправильному поведению на страницах, начиная со второй. В настоящее время отсутствует поддерживаемое обходное решение. Избегайте использования отрицательных фильтров.
• Виртуальная таблица не может находиться на стороне 1 отношения 1:N (один ко многим). Это связано с тем, что виртуальные таблицы представляют собой представления метаданных исходной таблицы. При создании отношения добавляются дополнительные вспомогательные столбцы на стороне 1 отношения 1:N. Dataverse не имеет возможности создавать новые столбцы в исходных системах.

Ограничения для каждого источника данных

Следующие ограничения применяются к каждому источнику данных.

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

• Доступна только одна (1) запись в виртуальной таблице, хотя в исходной таблице их больше.
  Решение: проверьте свою исходную таблицу и убедитесь, что в ней определен первичный ключ.

• При получении списка таблиц Power Apps (make.powerapps.com) или при выборе Finish для создания таблицы возникает одна из следующих ошибок:

  • "Ресурс не найден для сегмента msdyn_get_required_fields"
  • "Ошибка вызова... убедитесь, что подключение... существует в среде"
  • "Последовательность не соответствует ни одному элементу для msdyn_get_required_fields"
    Решение. В некоторых случаях у вас может не быть самого актуального решения для поставщика виртуального соединителя. Чтобы определить, нуждается ли ваше решение поставщика виртуального соединителя в обновлении, выполните указанные ниже действия.
  1. В левой части меню навигации выберите Решения. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.
  2. Перейдите на вкладку Журнал .
  3. Выполните поискConnectorProvider.
  4. Просмотрите информацию, чтобы узнать, нужно ли обновить решение.
  5. Если журнал указывает, что требуется обновление, перейдите на коммерческую площадку Microsoft, найдите Virtual Connector Provider и выберите Получить сейчас, чтобы импортировать решение в вашу среду.
  6. Следуйте инструкциям, чтобы снова создать виртуальную таблицу.

• При получении списка подключений отображается сообщение "Соединение xyz" не найдено в текущей среде.
  Решение. Это происходит, когда в среде пользователя Dataverse имеется большое количество подключений. Это исправлено в версии 1029 решения от поставщика соединителей. Чтобы определить, нуждается ли ваше решение поставщика виртуального соединителя в обновлении, выполните указанные ниже действия.

  1. В левой части меню навигации выберите Решения. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.
  2. Перейдите на вкладку Журнал .
  3. Выполните поискConnectorProvider.
  4. Просмотрите информацию, чтобы узнать, нужно ли обновить решение.
  5. Если журнал указывает, что требуется обновление, перейдите на коммерческую площадку Microsoft, найдите Virtual Connector Provider и выберите Получить сейчас, чтобы импортировать решение в вашу среду.
  6. Следуйте инструкциям, чтобы снова создать виртуальную таблицу.

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

• Вы получите уведомление о том, что "Произошла непредвиденная ошибка".
  Решение. Это происходит, когда источник данных виртуальной таблицы был создан с недопустимыми значениями. Чтобы устранить эту проблему, необходимо найти источник данных виртуальной таблицы, вызвавший ошибку, удалить его, а затем заново создать виртуальную таблицу.

  1. Выберите Настройки (значок шестеренки) >Дополнительные настройки в Power Apps.
  2. В верхнем меню выберите Параметры.
  3. Перейдите в раздел Решения. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.
  4. Перейдите к решению, включающему вашу виртуальную таблицу (если вы не использовали решение, перейдите к решению по умолчанию Common Data Services).
  5. На левой панели выберите Источники данных виртуальной таблицы.
  6. Дважды щелкните каждый источник данных (все они начинаются с VCP_DS_..."), когда вы найдете источник данных с ошибкой, удалите его.
  7. Повторно создайте виртуальной таблицу.

• Появится сообщение "Эта таблица уже существует, вы заново создаете таблицу. Основное поле и имя схемы изменить нельзя».
  Решение. Эта таблица была создана ранее. Если продолжить создание, таблица создается заново, что приводит к тому, что все изменения таблицы, внесенные в источник данных, обновляются в виртуальной таблице (включая добавление или удаление полей). Значения пользовательского имени и основного поля будут недоступны для редактирования.

• Сообщение об ошибке: "primary_key_name не может быть пустым"
  Решение. Вы выбрали таблицу или список, который не включает значение GUID для первичного ключа. Чтобы создать виртуальную таблицу, необходимо добавить дополнительный столбец GUID в исходную таблицу.

• Вы создали виртуальную таблицу Excel, но не видите ее в области Tables в Power Apps.
  Решение. Поскольку создание виртуальной таблицы происходит асинхронно, вы можете проверить статус процесса в разделе Системные задания. Ищите системные задания, где имя начинается с Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin, а значение в столбце Regarding совпадает с именем новой виртуальной таблицы. Если статус все еще Выполняется, просто дождитесь завершения задания. В случае возникновения ошибки сведения можно получить, выбрав гиперссылку с именем системы, задания. В этом примере создание таблицы еще не завершено:

  

  Здесь не удалось создать таблицу из-за ошибки 429 «Слишком много запросов»:

  

• Системное задание создания таблицы выполнено успешно, но вы получаете сообщения об ошибках выполнения, связанных с недопустимыми или отсутствующими столбцами.
  Решение: если при создании поля таблицы происходит сбой, процесс создания таблицы не завершается ошибкой и пытается продолжить работу с оставшимися полями. Это связано с тем, что система не хочет блокировать создание виртуальной таблицы, когда некоторые типы столбцов не поддерживаются. Чтобы получить подробную информацию об ошибке, вы можете включить ведение журнала в разделе Администрирование>Параметры системы>Настройки>Включить ведение журнала в журнале трассировки подключаемого модуля, затем удалите виртуальную таблицу и попробуйте создать ее снова.

• Если вы удалили подключение, подключенное к виртуальной таблице, и создали его заново, приложение Virtual Connector Provider теряет разрешение на доступ к новому подключению, препятствуя извлечению данных.
  Решение: вручную предоставьте приложению "Поставщик виртуальных соединителей" доступ к заново созданному подключению с помощью функции общего доступа к подключению, чтобы восстановить доступ.

• Когда настраиваемый поставщик данных для виртуальной таблицы обновляется для поддержки новых операций (например, создания, обновления, удаления), платформа не добавляет соответствующие разрешения для существующей сущности виртуальной таблицы.
  Решение. Чтобы включить новые разрешения, пользователь должен повторно создать сущность виртуальной таблицы после обновления поставщика данных.

Дальнейшие шаги

Создание виртуальных таблиц с помощью поставщика виртуальных соединителей (предварительная версия)

Настройка отношения виртуальных таблиц