12.2.2 Importing JSON Documents With the Mysqlsh Command Interface — MySQL Shell 9.2

12.2.2 Импорт JSON-документов с помощью интерфейса командной строки Mysqlsh

С помощью интерфейса командной строки mysqlsh вы вызываете утилиту импорта JSON следующим образом:

mysqlsh user@host:port/mydb -- util importJson <path> [options]
or
mysqlsh user@host:port/mydb -- util import-json <path> [options]

Дополнительную информацию о синтаксисе см. в разделе 5.8 «Интеграция командной строки API». Для утилиты импорта JSON задайте параметры следующим образом:

user

Имя пользователя учетной записи, используемой для запуска утилиты импорта JSON.

host

Имя хоста сервера MySQL.

port

Номер порта для подключения MySQL Shell к серверу MySQL. По умолчанию этот порт равен 33060.

mydb

Имя целевой базы данных. При вызове утилиты импорта JSON из командной строки необходимо указать целевую базу данных. Вы можете указать ее либо в строке подключения в формате URI, либо с помощью дополнительного параметра командной строки --schema.

path

Путь к файлу (или специальному файлу FIFO) содержащему JSON-документы, подлежащие импорту.

options

Параметры --collection, --table и --tableColumn задают целевую коллекцию или целевую таблицу и столбец. Взаимосвязи и значения по умолчанию при вызове утилиты импорта JSON с помощью интерфейса командной строки mysqlsh аналогичны тем, которые используются в сеансе MySQL Shell. Если вы не укажете ни один из этих параметров, утилита по умолчанию использует или создает целевую коллекцию с именем предоставленного файла импорта (без расширения файла).

Параметр --convertBsonTypes преобразует типы данных BSON, представленные с использованием расширений формата JSON. Дополнительные параметры управления для конкретных типов данных BSON также могут быть заданы; список этих параметров управления и преобразований типов по умолчанию см. в разделе 12.2.4 «Преобразования представлений типов данных BSON». Параметр --convertBsonOid автоматически устанавливается при указании параметра --convertBsonTypes. При импорте данных из MongoDB, параметр --convertBsonOid необходимо указать, если вы не конвертируете типы BSON, так как сервер MySQL требует преобразования значения _id в тип varbinary(32). --extractOidTime=field_name может быть использован для извлечения отметки времени из значения _id в отдельное поле.

Следующий пример импортирует JSON-документы из файла products.json в коллекцию products базы данных mydb:

mysqlsh user@localhost/mydb -- util importJson products.json --collection=products