--help, -?

Отобразить сообщение справки и завершить работу.

--bind-address=ip_address

В случае компьютера с несколькими сетевыми интерфейсами, данная опция позволяет выбрать интерфейс для подключения к серверу MySQL.

--character-sets-dir=dir_name

Каталог, в котором установлены наборы символов. См. Раздел 12.15, «Настройка наборов символов».

--columns=column_list, -c column_list

Эта опция принимает список имен столбцов, разделенных запятыми. Порядок имен столбцов указывает, как сопоставить столбцы файла данных со столбцами таблицы.

--compress, -C

Сжать всю информацию, передаваемую между клиентом и сервером, если это возможно. См. Раздел 6.2.8, «Управление сжатием соединения».

Эта опция устарела. Ожидается её удаление в будущих версиях MySQL. См. Настройка устаревшего сжатия соединения.

--compression-algorithms=value

Разрешенные алгоритмы сжатия для соединений с сервером. Доступные алгоритмы такие же, как для системной переменной protocol_compression_algorithms. Значение по умолчанию — uncompressed.

Для получения дополнительной информации, см. Раздел 6.2.8, «Управление сжатием соединения».

--debug[=debug_options], -# [debug_options]

Записать в журнал отладки. Типичная строка debug_options — d:t:o,file_name. Значение по умолчанию — d:t:o.

Эта опция доступна только в том случае, если MySQL был скомпилирован с использованием WITH_DEBUG. Бинарные файлы выпусков MySQL, предоставляемые компанией Oracle, не компилируются с использованием этой опции.

--debug-check

Вывести информацию для отладки при завершении программы.

Эта опция доступна только в том случае, если MySQL был скомпилирован с использованием WITH_DEBUG. Бинарные файлы выпусков MySQL, предоставляемые компанией Oracle, не компилируются с использованием этой опции.

--debug-info

Вывести отладочную информацию и статистику использования памяти и процессора при завершении программы.

Эта опция доступна только в том случае, если MySQL был скомпилирован с использованием WITH_DEBUG. Бинарные файлы выпусков MySQL, предоставляемые компанией Oracle, не компилируются с использованием этой опции.

--default-character-set=charset_name

Используйте charset_name в качестве набора символов по умолчанию. См. Раздел 12.15, «Настройка наборов символов».

--default-auth=plugin

Подсказка о том, какой плагин аутентификации клиента использовать. См. Раздел 8.2.17, «Подключаемые модули аутентификации».

--defaults-extra-file=file_name

Прочитать данный файл параметров после глобального файла параметров, но (в Unix) перед файлом параметров пользователя. Если файл не существует или недоступен, произойдет ошибка. Если file_name не является абсолютным путем, он интерпретируется относительно текущей директории.

Дополнительную информацию об этой и других опциях файлов параметров см. в Разделе 6.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».

--defaults-file=file_name

Использовать только указанный файл параметров. Если файл не существует или недоступен, произойдет ошибка. Если file_name не является абсолютным путем, он интерпретируется относительно текущей директории.

Исключение: Даже с --defaults-file, программы-клиенты читают .mylogin.cnf.

Дополнительную информацию об этой и других опциях файлов параметров см. в Разделе 6.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».

--defaults-group-suffix=str

Читает не только обычные группы опций, но и группы с обычными именами и суффиксом str. Например, mysqlimport обычно читает группы [client] и [mysqlimport]. Если эта опция задана как --defaults-group-suffix=_other, mysqlimport также читает группы [client_other] и [mysqlimport_other].

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

--delete, -D

Очистить таблицу перед импортом текстового файла.

--enable-cleartext-plugin

Включить плагин проверки подлинности открытого текста mysql_clear_password. (См. Раздел 8.4.1.3, «Проверка подлинности открытого текста на стороне клиента».)

--fields-terminated-by=..., --fields-enclosed-by=..., --fields-optionally-enclosed-by=..., --fields-escaped-by=...

Эти параметры имеют то же значение, что и соответствующие предложения для LOAD DATA. См. Раздел 15.2.9, «Инструкция LOAD DATA».

--force, -f

Игнорировать ошибки. Например, если таблица для текстового файла не существует, продолжить обработку оставшихся файлов. Без --force, mysqlimport завершает работу, если таблица не существует.

--get-server-public-key

Запросить у сервера открытый ключ, необходимый для обмена паролями на основе пары ключей RSA. Эта опция применяется к клиентам, которые аутентифицируются с помощью плагина аутентификации caching_sha2_password. Для этого плагина сервер не отправляет открытый ключ, если его не запрашивают. Эта опция игнорируется для учетных записей, которые не аутентифицируются с помощью этого плагина. Она также игнорируется, если не используется обмен паролями на основе RSA, как это происходит, когда клиент подключается к серверу с использованием защищенного соединения.

Если указан параметр --server-public-key-path=file_name и указывает на допустимый файл открытого ключа, он имеет приоритет над параметром --get-server-public-key.

Для получения информации о плагине caching_sha2_password см. Раздел 8.4.1.1, «Кэширование SHA-2 подключаемой аутентификации».

--host=host_name, -h host_name

Импортировать данные на сервер MySQL на указанном хосте. Хост по умолчанию — localhost.

--ignore, -i

См. описание опции --replace.

--ignore-lines=N

Игнорировать первые N строк файла данных.

--lines-terminated-by=...

Этот параметр имеет то же значение, что и соответствующее предложение для LOAD DATA. Например, чтобы импортировать файлы Windows, строки которых заканчиваются парами возврата каретки/перевода строки, используйте --lines-terminated-by="\r\n". (Возможно, вам придется удвоить обратные косые черты в зависимости от соглашений об экранировании вашего интерпретатора команд.) См. Раздел 15.2.9, «Инструкция LOAD DATA».

--local, -L

По умолчанию файлы считываются сервером на хосте сервера. С помощью этой опции mysqlimport читает входные файлы локально на клиентском хосте.

Для успешного использования операций загрузки LOCAL в mysqlimport также требуется, чтобы сервер разрешал локальную загрузку; см. Раздел 8.1.6, «Меры безопасности для LOAD DATA LOCAL»

--lock-tables, -l

Заблокировать все таблицы для записи перед обработкой любых текстовых файлов. Это гарантирует, что все таблицы синхронизированы на сервере.

--login-path=name

Чтение параметров из указанного пути к файлу входа в .mylogin.cnf файле пути к логину. “Путь к логину” — это группа параметров, содержащая параметры, указывающие, к какому серверу MySQL подключаться и под какой учетной записью аутентифицироваться. Для создания или изменения файла пути к логину используйте утилиту mysql_config_editor. См. Раздел 6.6.7, «mysql_config_editor — утилита конфигурации MySQL».

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

--no-login-paths

Пропускает чтение параметров из файла пути к логину.

См. --login-path для получения дополнительной информации.

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

--low-priority

Использовать LOW_PRIORITY при загрузке таблицы. Это влияет только на движки хранения, которые используют только блокировку на уровне таблицы (например, MyISAM, MEMORY и MERGE).

--no-defaults

Не читать файлы параметров. Если запуск программы завершается неудачей из-за чтения неизвестных параметров из файла параметров, --no-defaults можно использовать, чтобы предотвратить их чтение.

Исключением является то, что файл .mylogin.cnf считывается во всех случаях, если он существует. Это позволяет указывать пароли более безопасным способом, чем в командной строке, даже когда используется --no-defaults. Для создания .mylogin.cnf используйте утилиту mysql_config_editor. См. Раздел 6.6.7, «mysql_config_editor — утилита конфигурации MySQL».

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

--password[=password], -p[password]

Пароль учетной записи MySQL, используемой для подключения к серверу. Значение пароля является необязательным. Если он не указан, mysqlimport запрашивает его. Если указан, между --password= или -p и последующим паролем не должно быть пробела. Если параметр пароля не указан, по умолчанию отправляется отсутствие пароля.

Указание пароля в командной строке следует считать небезопасным. Чтобы избежать указания пароля в командной строке, используйте файл параметров. См. Раздел 8.1.2.1, «Рекомендации для конечных пользователей по безопасности паролей».

Чтобы явно указать, что пароля нет и что mysqlimport не должен запрашивать его, используйте параметр --skip-password.

--password1[=pass_val]

Пароль для фактора многофакторной аутентификации 1 учетной записи MySQL, используемой для подключения к серверу. Значение пароля является необязательным. Если он не указан, mysqlimport запрашивает его. Если указан, между --password1= и последующим паролем не должно быть пробела. Если параметр пароля не указан, по умолчанию отправляется отсутствие пароля.

Указание пароля в командной строке следует считать небезопасным. Чтобы избежать указания пароля в командной строке, используйте файл параметров. См. Раздел 8.1.2.1, «Рекомендации для конечных пользователей по безопасности паролей».

Чтобы явно указать, что пароля нет и что mysqlimport не должен запрашивать его, используйте параметр --skip-password1.

--password1 и --password являются синонимами, как и --skip-password1 и --skip-password.

--password2[=pass_val]

Пароль для фактора многофакторной аутентификации 2 учетной записи MySQL, используемой для подключения к серверу. Семантика этого параметра аналогична семантике для --password1; см. описание этого параметра для получения подробной информации.

--password3[=pass_val]

Пароль для фактора многофакторной аутентификации 3 учетной записи MySQL, используемой для подключения к серверу. Семантика этого параметра аналогична семантике для --password1; см. описание этого параметра для получения подробной информации.

--pipe, -W

В Windows подключается к серверу с помощью именованного канала. Этот параметр применяется только в том случае, если сервер был запущен с включенной системной переменной named_pipe для поддержки подключений с помощью именованных каналов. Кроме того, пользователь, устанавливающий соединение, должен быть членом группы Windows, указанной системной переменной named_pipe_full_access_group.

--plugin-dir=dir_name

Каталог, в котором следует искать подключаемые модули. Укажите этот параметр, если параметр --default-auth используется для указания подключаемого модуля аутентификации, но mysqlimport не находит его. См. Раздел 8.2.17, «Подключаемая аутентификация».

--port=port_num, -P port_num

Для подключений TCP/IP номер порта, который нужно использовать.

--print-defaults

Вывести имя программы и все параметры, которые она получает из файлов параметров.

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

--protocol={TCP|SOCKET|PIPE|MEMORY}

Транспортный протокол, используемый для подключения к серверу. Он полезен, когда другие параметры подключения обычно приводят к использованию протокола, отличного от того, который вам нужен. Подробную информацию о допустимых значениях см. в разделе 6.2.7, «Транспортные протоколы подключения».

--replace, -r

Параметры --replace и --ignore управляют обработкой входных строк, которые дублируют существующие строки по уникальным значениям ключей. Если вы укажете --replace, новые строки заменят существующие строки, имеющие то же уникальное значение ключа. Если вы укажете --ignore, входные строки, дублирующие существующую строку по уникальному значению ключа, пропускаются. Если вы не укажете ни один из параметров, при обнаружении дубликата ключа произойдет ошибка, и остальная часть текстового файла будет проигнорирована.

--server-public-key-path=file_name

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

Если указан --server-public-key-path=file_name и указывает на допустимый файл открытого ключа, он имеет приоритет перед --get-server-public-key.

Для sha256_password этот параметр применяется только в том случае, если MySQL был собран с использованием OpenSSL.

Для получения информации о подключаемых модулях sha256_password и caching_sha2_password см. раздел 8.4.1.2, «Подключаемая аутентификация SHA-256», и раздел 8.4.1.1, «Кэширование подключаемой аутентификации SHA-2».

--shared-memory-base-name=name

В Windows имя разделяемой памяти, используемое для подключений, осуществляемых с использованием разделяемой памяти к локальному серверу. Значение по умолчанию — MYSQL. Имя разделяемой памяти чувствительно к регистру.

Этот параметр применяется только в том случае, если сервер был запущен с включенной системной переменной shared_memory для поддержки подключений с использованием разделяемой памяти.

--silent, -s

Режим без вывода сообщений. Выводить информацию только при возникновении ошибок.

--socket=path, -S path

Для подключений к localhost, файл сокета Unix, который нужно использовать, или, в Windows, имя именованного канала, который нужно использовать.

В Windows этот параметр применяется только в том случае, если сервер был запущен с включенной системной переменной named_pipe для поддержки подключений через именованные каналы. Кроме того, пользователь, устанавливающий соединение, должен быть членом группы Windows, указанной в системной переменной named_pipe_full_access_group.

--ssl*

Параметры, начинающиеся с --ssl, указывают, следует ли подключаться к серверу с использованием шифрования и где найти ключи и сертификаты SSL. См. Параметры командной строки для шифрованных соединений.

--ssl-fips-mode={OFF|ON|STRICT}

Управляет включением режима FIPS на стороне клиента. Параметр --ssl-fips-mode отличается от других параметров --ssl-xxx тем, что он не используется для установления шифрованных соединений, а скорее для влияния на то, какие криптографические операции разрешать. См. раздел 8.8, «Поддержка FIPS».

Допускаются следующие значения --ssl-fips-mode:

Этот параметр устарел. Ожидается, что он будет удален в будущей версии MySQL.

--tls-ciphersuites=ciphersuite_list

Допустимые наборы шифров для шифрованных соединений, использующих TLSv1.3. Значение представляет собой список из одного или нескольких имен наборов шифров, разделенных двоеточием. Наборы шифров, которые можно указать для этого параметра, зависят от библиотеки SSL, используемой для компиляции MySQL. Подробности см. в разделе 8.3.2, «Протоколы и наборы шифров TLS для шифрованных соединений».

--tls-sni-servername=server_name

При указании, имя передаётся в библиотеку C API libmysqlclient с помощью опции MYSQL_OPT_TLS_SNI_SERVERNAME. Имя сервера не чувствительно к регистру. Чтобы увидеть, какое имя сервера указал клиент для текущей сессии (если таковое есть), проверьте переменную состояния Tls_sni_server_name.

Указание имени сервера (SNI) — это расширение протокола TLS (OpenSSL должен быть скомпилирован с расширениями TLS, чтобы эта опция работала). Реализация SNI в MySQL представляет только клиентскую сторону.

--tls-version=protocol_list

Разрешённые протоколы TLS для шифрованных соединений. Значение представляет собой список одного или нескольких имён протоколов, разделённых запятыми. Протоколы, которые можно указать с помощью этой опции, зависят от используемой библиотеки SSL для компиляции MySQL. Подробности см. в Разделе 8.3.2, «Протоколы и шифры TLS шифрованного соединения».

--user=user_name, -u user_name

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

--use-threads=N

Загрузка файлов параллельно с использованием N потоков.

--verbose, -v

Режим подробной информации. Вывод дополнительной информации о действиях программы.

--version, -V

Вывод информации о версии и выход.

--zstd-compression-level=level

Уровень сжатия, который следует использовать для подключений к серверу, использующих алгоритм сжатия zstd. Разрешённые уровни от 1 до 22, причём большие значения указывают на увеличение уровня сжатия. Уровень сжатия по умолчанию zstd равен 3. Настройка уровня сжатия не влияет на подключения, которые не используют сжатие zstd.

Дополнительную информацию см. в Разделе 6.2.8, «Управление сжатием подключения».