11.2.2 Importing JSON Documents With the Mysqlsh Command Interface — MySQL Shell 8.4

11.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 также можно указать; список этих параметров управления и преобразований по умолчанию см. в разделе 11.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