Импорт или экспорт данных из Dataverse

  • Статья

Чтобы получить (импортировать) данные в таблицы Microsoft Dataverse, используйте файл таблицы Excel, файл значений, разделенных запятыми (CSV), или один из многих доступных соединителей.

Когда вы экспортируете данные таблицы Dataverse, они экспортируются в виде CSV-файла.

Импорт с помощью соединителя

Используйте соединитель для импорта данных из множества различных источников, таких как Microsoft Excel, Azure, база данных SQL Server, SharePoint, Access, OData и многое другое.

  1. Выполните вход в Power Apps.
  2. В левой области навигации выберите Таблицы. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.
  3. Выберите Данные > Получить данные > Получить данные.
  4. Из списка Источники данных выберите соединитель, из которого вы хотите импортировать данные.

Сведения о соединителе, который вы хотите использовать в качестве источника данных, см. в разделах Список всех соединителей Power Apps и Список всех соединителей, опубликованных Microsoft.

Импорт из файла Excel или CSV

Существует два способа импорта данных из Excel.

Важно!

Импорт из файла Excel или CSV с помощью команды Импорт > Импорт данных из Excel недоступен в средах GCC, GCC High и DoD. Чтобы обойти это ограничение, в области Таблицы в Power Apps выберите Импорт > Импорт данных, а затем выберите источник данных, например Книга Excel или Текст/CSV.

Вариант 1. Импорт путем создания и изменения шаблона файла

Каждая таблица имеет необходимые столбцы, которые должны существовать во входном файле. Рекомендуется создать шаблон. Для этого экспортируйте данные из таблицы. Затем используйте тот же файл и измените его своими данными. Наконец, импортируйте измененный файл обратно в таблицу. Использование шаблона может сэкономить ваше время, поскольку вам не нужно указывать необходимые столбцы для каждой таблицы.

Подготовка шаблона файла

  1. Экспортируйте данные таблицы.
  2. Определите план, чтобы убедиться, что данные уникальны, прежде чем импортировать их. Используйте первичные ключи или альтернативные ключи. Больше информации: Обеспечение уникальности при импорте данных в таблицу из файла Excel или CSV

Изменение файла с данными

Скопируйте данные из файла Excel или CSV в шаблон, созданный на предыдущем шаге.

Импорт файла

  1. На странице powerapps.com выберите Таблицы в левой области навигации. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.
  2. Выберите Данные справа от Получить данные, выберите >, а затем выберите Получить данные из Excel.
  3. Выберите таблицы, где вы хотите импортировать данные, затем выберите Далее.
  4. На странице Импорт данных выберите Отправить и выберите файл. Следуйте приглашениям, чтобы отправить файл.
  5. После того как файла отправлен и Состояние сопоставления указывает Сопоставление прошло успешно, выберите Импорт из правого верхнего угла. Перейдите к пункту Устранение ошибок сопоставления с помощью Excel для навигации и исправления любых ошибок отображения. Сопоставление импорта успешно После успешного завершения импорта вы увидите общее число вставок и обновлений.

Вариант 2. Импорт путем внесения собственного исходного файла

Если вы опытный пользователь и знаете требуемые строки для определенной таблицы для таблиц Dataverse, определите собственный исходный файл Excel или CSV. Следуйте инструкциям в разделе Импорт файла.

Устранение ошибок сопоставления с помощью Excel

При получении ошибок сопоставления после отправки файла выберите Статус сопоставления. Выполните следующие шаги, чтобы проверить и исправить ошибки сопоставления столбцов.

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

    Совет

    • В зависимости от того, является ли сообщение Предупреждением или Ошибкой, проверьте Несопоставленные столбцы или Поля с ошибкой с помощью раскрывающегося меню в области Сопоставление столбцов.
    • Используйте логику upsert (обновление или вставка) для обновления строки, если она уже существует, или вставки новой строки.

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

  3. Когда в столбце Состояние сопоставления отображается Сопоставление прошло успешно, выберите Импорт из правого верхнего угла.

Когда появляется сообщение Импорт успешно завершен, отображается общее количество вставок и обновлений.

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

Таблицы Dataverse используют первичный ключ для уникальной идентификации строк в таблице Dataverse. Первичный ключ для таблицы Dataverse является глобальным уникальным идентификатором (GUID). Он формирует основу по умолчанию для идентификации строк. Операции с данными, такие как импорт данных в таблицы Dataverse, основываются на первичных ключах по умолчанию.

Пример:
Первичный ключ для таблицы Организация — accountid.

Пример экспорта файла из таблицы Организация, где accountid является первичным ключом.

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

Пример:
Для таблицы Организация можно установить transactioncurrencyid в качестве альтернативного ключ с помощью естественной идентификации на основе ключей. Например, используйте Доллар США вместо значения идентификатора GUID 88c6c893-5b45-e811-a953-000d3a33bcb9, отображаемого ранее. Можно также выбрать как ключи символ валюты или название валюты. Дополнительные сведения: Определение альтернативных ключей с помощью портала Power Apps

Пример создания альтернативного ключа для таблицы Валюта.

Пример экспорта файла из таблицы Организация, где название валюты является естественным ключом.

После задания альтернативных ключей можно по-прежнему использовать первичные ключи как идентификаторы. В предыдущем примере первый файл по-прежнему допустим, если идентификаторы GUID являются допустимыми данными.

Экспортировать данные

Экспорт данных из одной или нескольких таблиц. Экспортируемые данные представлены в формате значений, разделенных запятыми (CSV). При экспорте данных из нескольких таблиц каждая таблица экспортируется в отдельный файл CSV.

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

  2. Выберите Экспорт > Экспорт данных.

  3. Выберите таблицы, из которых вы хотите экспортировать данные, затем выберите Экспорт данных.

    Пример экспорта данных из таблицы Организация.

  4. После успешного завершения экспорта выберите Загрузка экспортированных данных для загрузки CSV-файла в папку загрузки, указанную в веб-браузере.

    Пример экспорта, который показывает успешный экспорт со ссылкой на загружаемый файл.

Примечание

Экспорт имеет ограничение по времени в 12 минут. Если объем экспортированных данных превышает 12 минут, экспорт завершится сбоем. В этом случае экспортируйте данные меньшими сегментами.

Неподдерживаемые типы данных и поля

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

  • Часовой пояс
  • Выбор (множественный выбор)
  • Изображения
  • Файлы

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

  • Ownerid
  • Createdby
  • Createdonbehalfby
  • Createdon
  • Modifiedby
  • Modifiedonbehalfby
  • Modifiedon
  • Overriddencreatedon

Примечание

Функции получения данных из Excel и экспорта данных в настоящее время не включены в плане разработчика Power Apps.

Устранение ошибок подключения

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

Чтобы устранить эту проблему:

  1. В Power Apps (make.powerapps.com) выберите Подключения в левой области навигации. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.
  2. Найдите подключение Microsoft Dataverse (устаревшее).
  3. Выберите ссылку Исправить подключение в столбце Статус и следуйте инструкциям на экране.

После завершения исправления ошибок повторите попытку экспорта.

Примечание

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

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