Имя целевой базы данных на подключенном сервере MySQL. Если вы опустите этот параметр, утилита пытается определить и использовать имя схемы, используемой для текущей сессии MySQL Shell, как указано в строке URI подключения, команде \use или параметре MySQL Shell. Если имя схемы не указано и не может быть определено из сессии, возвращается ошибка.

Имя целевой реляционной таблицы. Если вы опустите этот параметр, утилита предполагает, что имя таблицы — это имя файла данных без расширения. Целевая таблица должна существовать в целевой базе данных.

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

Вы можете использовать этот параметр для захвата столбцов из файла или файлов импорта для предварительной обработки ввода, так же как и с оператором . Когда вы используете целое число вместо имени столбца в массиве, этот столбец в файле или файлах импорта захватывается как переменная пользователя @int, например @1. Захваченные данные можно игнорировать, или вы можете использовать параметр decodeColumns для преобразования данных и назначения им столбца в целевой таблице.

В этом примере в режиме JavaScript MySQL Shell второй и четвёртый столбцы из файла импорта назначаются переменным пользователя @1 и @2, и параметр decodeColumns для их назначения любому столбцу в целевой таблице отсутствует, поэтому они игнорируются.

mysql-js> util.importTable('file.txt', {
            table: 't1',
            columns: ['column1', 1, 'column2', 2, 'column3']
          });

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

В этом примере в режиме JavaScript MySQL Shell первый входной столбец из файла данных используется в качестве первого столбца в целевой таблице. Второй входной столбец, которому присвоена переменная @1 параметром columns, подвергается операцию деления перед использованием в качестве значения второго столбца в целевой таблице.

mysql-js> util.importTable('file.txt', {
            columns: ['column1', 1],
            decodeColumns: {'column2': '@1 / 100'}
          });

В этом примере в режиме JavaScript MySQL Shell входные столбцы из файла данных присваиваются переменным, затем преобразуются различными способами и используются для заполнения столбцов целевой таблицы:

mysql-js> util.importTable('file.txt', {
            table: 't1',
            columns: [1, 2],
            decodeColumns: {
              'a': '@1',
              'b': '@2',
              'sum': '@1 + @2',
              'multiple': '@1 * @2',
              'power': 'POW(@1, @2)'
            }
          });

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

Строки ввода, имеющие такое же значение для первичного ключа или уникального индекса, как и существующая строка, должны быть заменены (true) или пропущены (false). По умолчанию значение — false.

Используйте набор параметров обработки полей и строк, соответствующих указанному формату файла. Вы можете использовать выбранный диалект в качестве основы для дальнейшей настройки, дополнительно указав один или несколько параметров linesTerminatedBy, fieldsTerminatedBy, fieldsEnclosedBy, fieldsOptionallyEnclosed и fieldsEscapedBy для изменения настроек. По умолчанию диалект соответствует файлу, созданному с помощью оператора с параметрами по умолчанию для этого оператора. Это значение по умолчанию для выходного файла, созданного утилитой экспорта таблиц MySQL Shell. Доступны другие диалекты для CSV-файлов (созданных на системах DOS или UNIX), TSV-файлов и JSON-данных. Применённые настройки для каждого диалекта следующие:

Одна или несколько символов (или пустая строка), которые завершают каждую строку в файле или файлах входных данных. По умолчанию — значение, заданное для указанного диалекта, или символ перевода строки (\n), если параметр диалекта опущен. Этот параметр эквивалентен параметру LINES TERMINATED BY для оператора . Обратите внимание, что утилита не предоставляет эквивалента параметра LINES STARTING BY для оператора LOAD DATA, который установлен в пустую строку.

Одна или несколько символов (или пустая строка), которые завершают каждое поле в файле или файлах входных данных. По умолчанию — значение, заданное для указанного диалекта, или символ табуляции (\t), если параметр диалекта опущен. Этот параметр эквивалентен параметру FIELDS TERMINATED BY для оператора .

Один символ (или пустая строка), который заключает каждое поле в файле или файлах входных данных. По умолчанию — значение, заданное для указанного диалекта, или пустая строка, если параметр диалекта опущен. Этот параметр эквивалентен параметру FIELDS ENCLOSED BY для оператора .

Обозначает, заключает ли символ, заданный для fieldsEnclosedBy, все поля в файле или файлах входных данных (false) или заключает поля только в некоторых случаях (true). По умолчанию — значение, заданное для указанного диалекта, или false, если параметр диалекта опущен. Этот параметр делает параметр fieldsEnclosedBy эквивалентным параметру FIELDS OPTIONALLY ENCLOSED BY для оператора .

Символ, который начинает последовательности экранирования в файле или файлах входных данных. Если он не задан, интерпретация последовательностей экранирования не выполняется. По умолчанию — значение, заданное для указанного диалекта, или обратный слэш (\), если параметр диалекта опущен. Этот параметр эквивалентен параметру FIELDS ESCAPED BY для оператора .

Этот параметр указывает кодировку набора символов, с помощью которой интерпретируются входные данные во время импорта. Установка параметра в значение binary означает, что преобразование во время импорта не выполняется. Если этот параметр опущен, для интерпретации входных данных используется набор символов, указанный переменной системы .

Для списка нескольких файлов входных данных этот параметр недоступен. Для одного файла входных данных этот параметр задаёт количество байтов (плюс любые дополнительные байты, необходимые для достижения конца строки), которые потоки отправляют для каждого вызова целевого сервера. Утилита распределяет данные на куски заданного размера, чтобы потоки могли их забирать и отправлять на целевой сервер. Размер куска может быть указан в байтах или с использованием суффиксов k (килобайты), M (мегабайты), G (гигабайты). Например, bytesPerChunk="2k" заставляет потоки отправлять куски размером примерно 2 килобайта. Минимальный размер куска — 131072 байта, а размер куска по умолчанию — 50M.

Максимальное количество параллельных потоков для отправки данных из входного файла или файлов на целевой сервер. Если вы не указываете количество потоков, по умолчанию используется максимум 8. Для списка нескольких входных файлов утилита создаёт указанное или максимальное количество потоков. Для одного входного файла утилита рассчитывает подходящее количество потоков до этого максимума, используя следующую формулу:

min{max{1, threads}, chunks}}

где threads — максимальное количество потоков, а chunks — количество фрагментов, на которые данные будут разделены, вычисляемое путём деления размера файла на размер bytesPerChunk, а затем прибавлением 1. Вычисление гарантирует, что если максимальное количество потоков превышает фактическое количество фрагментов, утилита не создаст больше потоков, чем необходимо.

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

Максимальный предел пропускной способности данных в байтах в секунду на поток. Используйте этот параметр, если вам нужно избежать перегрузки сети, ввода-вывода или ЦП для хоста клиента или целевого сервера. Максимальную скорость можно указать как число байтов или с использованием суффиксов k (килобайты), M (мегабайты), G (гигабайты). Например, maxRate="5M" ограничивает каждый поток до 5 МБ данных в секунду, что для восьми потоков даёт скорость передачи 40 МБ/сек. По умолчанию значение равно 0, что означает отсутствие ограничения.

Отображать (true) или скрывать (false) информацию о прогрессе импорта. По умолчанию значение равно true, если stdout является терминалом (tty), и false в противном случае.

Список SQL-запросов, которые нужно выполнить в начале каждой сессии клиента для загрузки данных в целевой экземпляр MySQL. Вы можете использовать этот параметр для изменения переменных сессии. Например, следующие запросы пропускают двоичное ведение журнала на целевом экземпляре MySQL для сессий, используемых утилитой в ходе импорта, и увеличивают количество потоков, доступных для создания индексов:

sessionInitSQL: ["SET SESSION sql_log_bin=0;", "SET SESSION innodb_ddl_threads=8,"]

Если при выполнении SQL-запросов произойдёт ошибка, импорт прекратится и будет возвращено сообщение об ошибке.