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

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

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

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

Требуется роль: 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
        }
    ]
}

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

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

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

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

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

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

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

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

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

Message

Import result for knowledge_base_category.json
Total: 55
Inserted: 45
Updated: 10
Skipped: 0

Проверка поля на стороне сервера не учитывается при использовании быстрого импорта.

То есть вы можете импортировать записи с пустыми обязательными полями или неуникальными значениями в полях с установленным флажком Уникально.

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

Page tree

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