Перейти к основному содержимому
Версия: 1.21.3

Быстрый импорт

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

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

Функциональность быстрого импорта можно использовать только для импорта данных в неверсионируемые таблицы (с отключенным атрибутом Контроль версий). При попытке быстрого импорта данных в любую версионируемую таблицу, записи из файла импорта будут пропущены с сообщением в таблице Основной журнал (sys_log):
Is not possible to import to the {table_name} table.

Вы не можете производить быстрый импорт в таблицу Записи VCS (sys_vcs_record).

примечание

Требуемая роль: admin, import_admin.

Импортируемые данные должны соответствовать следующему формату:

Формат импортируемых данных

{
"article": [
{
"state": "1",
"service": null,
"number": "ART0000035",
"sys_id": 159497384530294161,
"metainfo": null,
"object_category": null,
"sys_updated_at": "2020-07-17 08:17:25",
"body": null,
"sys_db_table_id": 156846397908814773,
"content_item_class": 157935401911817831,
"sys_created_at": "2020-07-17 08:17:25",
"sys_updated_by": 155931135900000001,
"sys_created_by": 155931135900000001,
"published_at": "2020-07-17 08:17:25"
}
],
"itsm_incident": [
{
"active": true,
"sys_updated_at": "2020-06-18 23:24:13",
"sys_created_at": "2020-06-18 23:24:13",
"wf_executing_activity": null,
"number": "INC0000351",
"description": null,
"urgency": "1",
"impact": "1",
"assignment_group": null,
"sys_db_table_id": 156950677111866258,
"display_name": "INC0000351 asd",
"subject": "asd",
"company": null,
"service": 158825569619498427
}
]
}

Основными ключами объектов являются системные имена справочников. Значение – это массив объектов записей. Каждый объект записи содержит ключи, которые соответствуют системным именам колонок таблицы и значению атрибутов базы данных.

Файл, содержащий данные для импорта, можно получить, экспортировав список записей справочника.

Чтобы выполнить быстрый импорт, выполните следующие действия:

  1. Перейдите к представлению списка целевой таблицы.
  2. Нажмите на область заголовков колонок и выберите Импорт из JSON в контекстном меню.
  3. В открывшемся окне вложений загрузите файлы JSON для импорта.

примечание

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

В процессе импортирования механизм импорта проверяет записи на соответствие sys_id значений их атрибутов с sys_id значений в импортируемом объекте.

Если такая запись существует в целевой таблице, она будет обновлена; в противном случае создается новая запись. Например, когда импортируются записи с новым значением атрибута sys_id или записи без пары sys_id: value.

После обработки импорта для каждого файла в Основном журнале (sys_log) создается запись со значением Быстрый импорт в колонке Источник. Ссылка на записи журнала импорта появляется во всплывающем сообщении в правом нижнем углу.

Эти записи будут содержать информацию о результатах импорта. Например:

Сообщение

Import result for knowledge_base_category.json
Total: 55
Inserted: 45
Updated: 10
Skipped: 0
примечание

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