Відомі обмеження та усунення несправностей з віртуальними таблицями

У цій статті описано відомі обмеження та поради щодо усунення несправностей під час роботи з віртуальними таблицями в Microsoft Dataverse.

Відомі обмеження

Нижче наведено список відомих обмежень для віртуальних таблиць, створених за допомогою постачальника віртуальних з’єднувачів.

Основні

• Використовувана таблиця або список повинні містити принаймні одне рядкове поле, яке використовуватиметься як основне, і одне поле GUID. Без цих рядкових полів віртуальна таблиця не може бути створена, і на етапі отримання відомостей про таблицю буде згенеровано помилку.
  • SharePoint використовує приховане числове поле ідентифікатора, наявне в усіх списках
  • SQL може використовувати GUID або цілочисельне поле
  • В Excel обов’язково має бути поле GUID
• Dataverse можна створювати лише стовпці, які містять сумісні з типами даних Dataverse. Сюди входять такі типи даних:
  • String
  • Багаторядковий текст (пам’ятка)
  • Ціле число/ціле число
  • Десяткове число
  • Float
  • Дата та час
  • Логічне значення «Так» або «Ні».
  • Вибір (вибір кількох значень)
  • Гіперпосилання/URL-адреса
• Типи даних, які не підтримуються для віртуальних таблиць:
  • Файли та вкладення
  • Image
  • Підстановка
• Максимальна довжина символів для текстового стовпця у віртуальній таблиці становить 4000 символів. Якщо вихідна таблиця має максимальний ліміт символів, більший за це значення, будь-яка операція створення/оновлення, що перевищує максимальний ліміт символів, призводить до помилки перевірки, і операція завершується помилкою.
• Запити віртуальної таблиці можуть повернути максимум 1,000 записів. Якщо з віртуальною таблицею є користувацький багатотабличний (поліморфний) зв’язок 1:N або N, будь-який запит, що перевищує це обмеження, зазнає невдачі та видає помилку. Використовуйте фільтрацію в запиті, щоб зменшити набір записів і таким чином обійти це обмеження.
• Відстеження недоступне для віртуальних таблиць, оскільки Dataverse може виконувати відстеження та відповідне збереження тільки для локальних даних.
• Зведені та обчислювані поля не можна обчислювати для віртуальних таблиць. Це пов’язано з тим, що зведення — це обчислення Dataverse на стороні сервера, яке вимагає, щоб дані зберігалися локально.
• Віртуальна Microsoft Entra таблиця ідентифікаторів, надана корпорацією Майкрософт, дозволяє лише доступ для читання.
• Dataverse Віртуальні таблиці можуть відображати значення в полях, які перевищують звичайні максимальні значення Dataverse. Така поведінка пов’язана з тим, що представлені значення не зберігаються локально. Наприклад, максимальне Dataverse ціле значення 100,000,000,000, але воно може отримати та відобразити SharePoint 9,000,000,000,000. Однак, якщо користувач намагається відредагувати число до розміру, більшого за максимально допустимий розмір Dataverse , з’являється повідомлення про помилку, яка вказує на те, що запис не можна зберегти, оскільки він перевищує максимальний розмір.
• Функції імпорту та експорту даних таблиць не підтримуються віртуальними таблицями.

Для кожного джерела даних

Нижче наведено обмеження для кожного джерела даних.

SQL Server

• Віртуальні таблиці SQL можуть використовувати поле GUID або ціле число для первинного ключа для функціональності.
• Таблиці SQL Server без первинних ключів: будь-яке нерядкове поле можна вибрати як первинний ключ. Віртуальна таблиця має бути успішно створена. RetrieveMultiple працює, інші операції завершуються помилкою з таким повідомленням про помилку (що надходить від SQL connector): «Запит APIM не був успішним: BadRequest: У таблиці немає первинного ключа». Для забезпечення функціональності в якості первинного ключа слід використовувати поле GUID або ціле число.
• Таблиці SQL Server, що використовують рядковий первинний ключ: первинний ключ рядка SQL є єдиним доступним параметром для первинного ключа віртуальної таблиці. Первинні ключі-рядки SQL Server підтримуються, лише якщо значення можна аналізувати як GUID. Якщо їх не вдається проаналізувати як GUID, створення віртуальної таблиці успішне, але завершується помилкою під час виконання з такими помилками:
  • Maker Portal: «Ми не змогли відкрити ваш стіл. Спробуйте перезавантажити або знову відкрити».
  • Трасування мережі: "Рядкові первинні ключі підтримуються, лише якщо їх можна проаналізувати як GUID."
• Таблиці SQL Server без рядкових полів непервинного ключа для використання в якості основного імені: Якщо в таблиці SQL немає рядкового поля, доступного для використання в якості основного імені, на кроці конфігурації відображається така помилка: "Таблиця не має основного поля"
• Представлення SQL можна використовувати для створення віртуальної таблиці, але вони надаватимуть лише операції читання.
• Щоб дізнатися про обмеження SQL Server Connector, перейдіть до довідника SQL Server.
• Великі стовпці типу даних SQL у вихідній таблиці відображаються як десятковий тип даних у Dataverse віртуальних таблицях. Коли доступна підтримка платформи для відображення великого числа на ціле число, раніше створені стовпці у віртуальній таблиці потрібно видалити, а також створити нові стовпці.
• У віртуальну таблицю наразі не можна включати такі типи стовпців:
  • Час
  • Дата-час2
  • Image
  • Геометрія
  • Місцезнаходження
  • RowVersion
• У віртуальну таблицю включено такі типи стовпців, але відображаються лише як текстові поля.
  • Ідентифікатор ієрархії
  • XML
  • Sqlvariant

Microsoft Excel Online (Business)

• Наразі Excel не підтримується у віртуальній таблиці на основі таблиць
• Щоб брати участь у підключенні до віртуальної таблиці, файли Excel мають зберігатися в OneDrive.
• Стовпець первинного ключа має бути включено до форми створення, якщо під час створення базової вихідної таблиці стовпець не настроєно автоматично. Вам слід ввести припустиме значення у стовпчик первинного ключа, щоб операція вставлення була успішною.
• Якщо створення каталогу сутностей займає багато часу, ви можете перевірити стан виконання завдання, перейшовши до Налаштування -> Додаткові налаштування -> Налаштування -> Системні завдання.
• Первинний ключ може бути лише стовпцем зі значеннями GUID. Оскільки метадані таблиці Excel відображають усі стовпці як рядки, поточний принцип передбачає, що первинний ключ завжди буде значенням GUID у вигляді рядка.

  Примітка

  Під час створення віртуальної сутності не виконується перевірка, якщо вибрано стовпець не зі значенням GUID, під час виконання сутність призведе до помилки: "Первинні ключі-рядки підтримуються, лише якщо їх можна проаналізувати як GUID".

• Підтримка PowerAppsId__ автоматично створеного стовпчика: якщо буде знайдено, буде використано автоматично згенерований стовпець PowerAppsId (це буде єдиний доступний параметр для первинного ключа). Під час створення запису слід обов’язково надати значення для PowerAppsId, навіть якщо воно буде фактично перезаписане автоматично згенерованим. Цього не станеться, якщо стовпець первинного ключа не є автоматично створеним стовпцем PowerAppsId.
• У віртуальну таблицю наразі не можна включати такі типи стовпців:
  • Час (їх буде створено як поля «Дата/час»).
• Особливі обмеження для з’єднувачів Excel: Довідка щодо з’єднувача Excel Online (Business)

Microsoft SharePoint

• Наразі не можна вибрати подання Всі для стовпців SharePoint у віртуальній таблиці. Це відома вада.
• У віртуальну таблицю наразі не можна включати такі типи стовпців:
  • Особа
  • Image
  • Керовані метадані
  • Місцезнаходження: координати
  • Вкладення
• SharePoint Конкретні стовпці, які будуть показані у віртуальній таблиці:
  • Ідентифікатор об’єкта відповідності вимогам – це внутрішній стовпець, призначений для SharePoint відстеження. Його можна ігнорувати.
  • ID - це зовнішній первинний ключ від SharePoint. Він доступний лише для читання і може бути проігнорований.

Salesforce (попередній перегляд)

• Щоб дізнатися про обмеження з’єднувача Salesforce, перейдіть до довідника Salesforce.
• Поля, які посилаються на інші об’єкти Salesforce, блокуються.

Виправлення неполадок

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

• Я отримую одну з наступних помилок, коли Power Apps (make.powerapps.com) отримуєш список таблиць або коли вибираю Готово, щоб створити таблицю:

  • "Ресурс не знайдено для сегмента msdyn_get_required_fields"
  • "Помилка виклику... Будь ласка, перевірте це підключення... існує в навколишньому середовищі»
  • "Послідовність не відповідає жодному елементу для msdyn_get_required_fields"
    Рішення: У деяких випадках у вас може бути не найновіше рішення для постачальника віртуальних з’єднувачів. Щоб визначити, чи потребує оновлення рішення постачальника віртуальних з’єднувачів:
  1. Виберіть Рішення на лівій панелі навігації. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.
  2. Виберіть вкладку Історія .
  3. Знайдіть ConnectorProvider.
  4. Перегляньте інформацію, щоб дізнатися, чи потрібно оновити рішення.
  5. Якщо в журналі вказано, що потрібне оновлення, перейдіть до комерційного маркетплейсу Microsoft за запитом Virtual Connector Provider, а потім натисніть кнопку Отримати зараз, щоб імпортувати рішення до свого середовища.
  6. Дотримуйтесь інструкцій, щоб знову створити віртуальну таблицю.

• З’явиться повідомлення «З’єднання «xyz» не знайдено в поточному середовищі».при отриманні списку з’єднань.
  Рішення: Це відбувається, коли в середовищі користувача Dataverse є велика кількість з’єднань. Це виправлено у версії 1 029 рішення Connector Provider. Оновлена версія має з’явитися у всіх регіонах до 20 лютого 2023 року. Щоб визначити, чи потребує оновлення рішення постачальника віртуальних з’єднувачів:

  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, але не бачу її в "Таблицях".
  Розв’язання: Оскільки створення віртуальної таблиці є асинхронним, ви можете перевірити стан процесу в системних завданнях. Шукайте системні завдання з початковим значенням Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin Ім’я та значенням стовпця Стосовно, що дорівнює імені нової віртуальної таблиці. Якщо стан — "Виконується", просто зачекайте, поки завершиться завдання. Якщо сталася помилка, для отримання додаткових відомостей клацніть гіперпосилання з іменем системного завдання. У цьому прикладі створення таблиці ще не виконано:

  

  У цьому прикладі створення таблиці не виконано через помилку 429 "Забагато запитів".

  

• Системне завдання створення таблиці виконано, але я отримую помилки виконання, пов’язані з неприпустимими або відсутніми стовпцями
  Рішення: якщо виникає помилка під час створення поля таблиці, процес створення таблиці не завершиться збоєм, а продовжиться з рештою полів. Це дозволяє уникнути блокування процесу створення віртуальної таблиці у випадках, коли певні типи стовпців не підтримуються. Щоб отримати відомості про помилку, можна ввімкнути журналювання, вибравши Адміністрування> Параметри системи > Настроювання > Активувати ведення журналу трасування компонента plug-in. Потім видаліть віртуальну таблицю та спробуйте створити її заново.

Наступні кроки

Створення віртуальних таблиць за допомогою постачальника віртуальних з’єднувачів (попередній перегляд)

Налаштування зв’язку між віртуальними таблицями