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

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

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

Функциональность быстрого импорта можно использовать только для импорта данных в неверсионируемые таблицы (с отключенным атрибутом Контроль версий). При попытке быстрого импорта данных в любую версионируемую таблицу, записи из файла импорта будут пропущены с сообщением в таблице Основной журнал (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

примечание

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