Имя целевой базы данных на подключенном сервере 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 байта, а значение по умолчанию — 50 Мбайт.

Максимальное количество параллельных потоков для отправки данных из входного файла или файлов на целевой сервер. Если вы не указываете количество потоков, используется максимальное значение по умолчанию — 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-запросов произойдет ошибка, импорт прекратится и будет возвращено сообщение об ошибке.