Утилита импорта JSON MySQL Shell позволяет импортировать 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 и не используете этот параметр, документы импортируются таким же образом, как они представлены в файле входных данных.