Инструмент импорта JSON MySQL Shell util.importJSON() позволяет импортировать JSON-документы из файла (или специального файла FIFO) или стандартного ввода в коллекцию MySQL Server или реляционную таблицу. Инструмент проверяет правильность предоставленных JSON-документов и вставляет их в целевую базу данных, исключая необходимость использования нескольких инструкций или написания скриптов для выполнения этой задачи.

Вы можете импортировать JSON-документы в существующую таблицу или коллекцию или в новую, созданную для импорта. Если целевая таблица или коллекция не существует в указанной базе данных, инструмент автоматически создаёт её, используя структуру по умолчанию для коллекции или таблицы. По умолчанию коллекция создаётся при вызове функции createCollection() из объекта schema. Таблица по умолчанию создаётся следующим образом:

CREATE TABLE `dbname`.`tablename` (
   target_column JSON,
   id INTEGER AUTO_INCREMENT PRIMARY KEY
) CHARSET utf8mb4 ENGINE=InnoDB;

Имя по умолчанию для коллекции или таблицы — это имя предоставленного файла импорта (без расширения файла), и имя по умолчанию для target_column — doc.

Инструмент импорта JSON может обрабатывать типы данных BSON (бинарный JSON), представленные в JSON-документах. Не все типы данных, используемые в BSON-документах, напрямую поддерживаются JSON, но они могут быть представлены с помощью расширений формата JSON. Инструмент импорта может обрабатывать документы, использующие расширения JSON для представления типов данных BSON, преобразовывать их в идентичное или совместимое представление MySQL и импортировать значение данных с использованием этого представления. Результирующие преобразованные значения данных могут использоваться в выражениях и индексах, а также обрабатываться инструкциями SQL и функциями X DevAPI.

Для преобразования расширений JSON для типов BSON в типы MySQL необходимо указать параметр convertBsonTypes при запуске инструмента импорта. Доступны дополнительные параметры для управления сопоставлением и преобразованием для определённых типов данных BSON. Если вы импортируете документы с расширениями JSON для типов BSON и не используете этот параметр, документы импортируются таким же образом, как они представлены в входном файле.