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

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

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

Загальні обмеження

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

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

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

SQL Server

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

Microsoft Excel Онлайн (Бізнес)

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

  Нотатка

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

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

Корпорація T SharePoint

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

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

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

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

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

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

• У віртуальній таблиці є лише один (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. Щоб визначити, чи потребує оновлення ваше рішення постачальника віртуальних з’єднувачів:

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

  

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

  

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

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

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

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