--help, -?

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

--auto-rehash

Включить автоматическое пересоздание. Этот параметр включён по умолчанию, что позволяет выполнять автодополнение названий баз данных, таблиц и столбцов. Для отключения пересоздания используйте --disable-auto-rehash. Это позволяет mysql запускаться быстрее, но вы должны ввести команду rehash или её сокращённую запись \#, чтобы воспользоваться автодополнением.

Чтобы выполнить автодополнение, введите начальную часть имени и нажмите Tab. Если имя однозначно, mysql выполнит автодополнение. В противном случае, нажмите Tab ещё раз, чтобы увидеть возможные имена, начинающиеся с введённой части. Автодополнение не выполняется, если нет базы данных по умолчанию.

--auto-vertical-output

Выводить наборы результатов вертикально, если они слишком широки для текущего окна, и использовать обычный табличный формат в противном случае. (Это относится к операторам, завершаемым ; или \G.)

--batch, -B

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

Режим пакетной обработки приводит к формату вывода без таблицы и экранированию специальных символов. Экранирование можно отключить, используя режим «сырого» вывода; см. описание параметра --raw.

--binary-as-hex

При использовании этого параметра mysql отображает двоичные данные в шестнадцатеричном формате (0xvalue). Это происходит независимо от общего формата отображения вывода (табличный, вертикальный, HTML или XML).

Включение параметра --binary-as-hex влияет на отображение всех двоичных строк, включая те, что возвращаются функциями, такими как CHAR() и UNHEX(). Следующий пример демонстрирует это, используя ASCII-код для A (65 в десятичной системе, 41 в шестнадцатеричной):

Чтобы записать выражение двоичной строки так, чтобы оно отображалось как строка символов независимо от того, включён ли параметр --binary-as-hex, воспользуйтесь этими методами:

Когда mysql работает в интерактивном режиме, этот параметр включён по умолчанию. Кроме того, вывод от команды status (или \s) включает эту строку, когда параметр включен неявно или явно:

Binary data as: Hexadecimal

Чтобы отключить шестнадцатеричное представление, используйте --skip-binary-as-hex

--binary-mode

Этот параметр полезен при обработке вывода mysqlbinlog, который может содержать значения BLOB. По умолчанию, mysql преобразует \r\n в строках операторов в \n и интерпретирует \0 как разделитель операторов. --binary-mode отключает обе эти функции. Также он отключает все команды mysql, кроме charset и delimiter в неинтерактивном режиме (для ввода, направленного в mysql, или загруженного с помощью команды source).

--bind-address=ip_address

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

--character-sets-dir=dir_name

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

--column-names

Выводить имена столбцов в результатах.

--column-type-info

Отображать метаданные наборов результатов. Эта информация соответствует содержимому структур данных API C MYSQL_FIELD. См.

--comments, -c

Сохранять или удалять комментарии в операторах, отправляемых на сервер. По умолчанию комментарии сохраняются; чтобы их удалить, запустите mysql с --skip-comments.

--compress, -C

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

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

--compression-algorithms=value

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

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

--connect-expired-password

Укажите серверу, что клиент может обработать режим песочницы, если у учетной записи, используемой для подключения, истек срок действия пароля. Это может быть полезно для неинтерактивных вызовов mysql, так как обычно сервер отключает неинтерактивных клиентов, которые пытаются подключиться с помощью учетной записи с истекшим паролем. (См. Раздел 8.2.16, «Обработка сервером истекших паролей».)

--connect-timeout=value

Количество секунд до таймаута подключения. (Значение по умолчанию — 0.)

--database=db_name, -D db_name

База данных для использования. Это полезно в основном в файле параметров.

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

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

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

--debug-check

Вывести некоторые отладочные сведения при выходе программы.

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

--debug-info, -T

Вывести отладочные сведения и статистику использования памяти и ЦП при выходе программы.

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

--default-auth=plugin

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

--default-character-set=charset_name

Использовать charset_name в качестве набора символов по умолчанию для клиента и подключения.

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

Для получения дополнительной информации см. Раздел 12.4, «Наборы символов и сортировки подключения» и Раздел 12.15, «Настройка наборов символов».

--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. Например, mysql обычно считывает группы [client] и [mysql]. Если этот параметр задан как --defaults-group-suffix=_other, mysql также считывает группы [client_other] и [mysql_other].

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

--delimiter=str

Устанавливает разделитель операторов. По умолчанию используется символ точки с запятой (;).

--disable-named-commands

Отключает именованные команды. Используйте только форму \* или используйте именованные команды только в начале строки, заканчивающейся точкой с запятой (;). mysql запускается с этим параметром, включенным по умолчанию. Однако, даже с этим параметром, команды в длинном формате по-прежнему работают с первой строки. См. Раздел 6.5.1.2, «Команды клиента mysql».

--dns-srv-name=name

Указывает имя записи DNS SRV, которая определяет кандидаты на хосты, используемые для установления соединения с сервером MySQL. Для получения информации о поддержке DNS SRV в MySQL см. Раздел 6.2.6, «Подключение к серверу с использованием записей DNS SRV».

Предположим, что DNS настроен с этой информацией SRV для домена example.com:

Name                     TTL   Class   Priority Weight Port Target
_mysql._tcp.example.com. 86400 IN SRV  0        5      3306 host1.example.com
_mysql._tcp.example.com. 86400 IN SRV  0        10     3306 host2.example.com
_mysql._tcp.example.com. 86400 IN SRV  10       5      3306 host3.example.com
_mysql._tcp.example.com. 86400 IN SRV  20       5      3306 host4.example.com

Чтобы использовать эту запись DNS SRV, вызовите mysql следующим образом:

mysql --dns-srv-name=_mysql._tcp.example.com

mysql затем пытается установить соединение с каждым сервером в группе, пока не будет установлено успешное соединение. Ошибка подключения возникает только в том случае, если соединение не может быть установлено ни с одним из серверов. Значения приоритета и веса в записи DNS SRV определяют порядок, в котором следует пытаться подключиться к серверам.

При вызове с --dns-srv-name, mysql пытается установить только TCP-соединения.

Параметр --dns-srv-name имеет приоритет над параметром --host, если оба заданы. --dns-srv-name приводит к тому, что для установления соединения используется функция C API, а не . Однако, если команда connect используется позже во время выполнения и указывает аргумент имени хоста, это имя хоста имеет приоритет над любым параметром --dns-srv-name, заданным при запуске mysql для указания записи DNS SRV.

--enable-cleartext-plugin

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

--execute=statement, -e statement

Выполнить оператор и завершить работу. Формат вывода по умолчанию аналогичен формату, создаваемому с помощью --batch. См. Раздел 6.2.2.1, «Использование параметров в командной строке», для некоторых примеров. С этим параметром mysql не использует файл истории.

--force, -f

Продолжить, даже если произошла ошибка SQL.

--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.2, «Кэширование SHA-2 плагинов проверки подлинности».

--histignore

Список из одного или нескольких шаблонов, разделенных двоеточиями, указывающих операторы, которые следует игнорировать для целей ведения журнала. Эти шаблоны добавляются в список шаблонов по умолчанию ("*IDENTIFIED*:*PASSWORD*"). Значение, указанное для этого параметра, влияет на ведение журнала операторов, записываемых в файл истории, и на syslog, если задан параметр --syslog. Для получения дополнительной информации см. Раздел 6.5.1.3, «Ведение журнала клиента mysql».

--host=host_name, -h host_name

Подключение к серверу MySQL на указанном хосте.

Опция --dns-srv-name имеет приоритет над опцией --host, если обе указаны. --dns-srv-name приводит к тому, что для установления соединения используется функция C API, а не . Однако, если команда connect впоследствии используется во время выполнения и указывает аргумент имени хоста, это имя хоста имеет приоритет над любой опцией --dns-srv-name, заданной при запуске mysql для указания записи DNS SRV.

--html, -H

Вывод в формате HTML.

--ignore-spaces, -i

Игнорировать пробелы после имён функций. Эффект этого описан в обсуждении SQL режима IGNORE_SPACE (см. Раздел 7.1.11, «Режимы SQL сервера»).

--init-command=str

Единственное SQL-выражение, которое выполняется после подключения к серверу. Если включено автоматическое переподключение, выражение выполняется снова после переподключения. Определение сбрасывает существующие выражения, определённые им или init-command-add.

--init-command-add=str

Добавить дополнительное SQL-выражение для выполнения после подключения или повторного подключения к серверу MySQL. Можно использовать без --init-command, но это не повлияет, если используется до него, так как init-command сбрасывает список команд для вызова.

--line-numbers

Вывод номеров строк для ошибок. Отключить это с помощью --skip-line-numbers.

--load-data-local-dir=dir_name

Эта опция влияет на возможность клиента LOCAL для операций LOAD DATA. Она указывает директорию, в которой файлы, названные в операциях LOAD DATA LOCAL, должны находиться. Эффект --load-data-local-dir зависит от того, включено или выключено LOCAL загрузка данных:

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

Например, чтобы явно отключить локальную загрузку данных, кроме файлов, расположенных в директории /my/local/data, вызовите mysql так:

mysql --local-infile=0 --load-data-local-dir=/my/local/data

Когда заданы и --local-infile, и --load-data-local-dir, порядок их задания не имеет значения.

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

--local-infile[={0|1}]

По умолчанию, возможность LOCAL для LOAD DATA определяется значением, скомпилированным в библиотеку MySQL клиента. Для явного включения или отключения возможности LOCAL загрузки данных используйте опцию --local-infile. При указании без значения опция включает LOCAL загрузку данных. При указании как --local-infile=0 или --local-infile=1, опция отключает или включает LOCAL загрузку данных.

Если возможность LOCAL отключена, можно использовать опцию --load-data-local-dir для разрешения ограниченной локальной загрузки файлов, расположенных в указанной директории.

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

--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, «Параметры командной строки, влияющие на обработку файлов параметров».

--max-allowed-packet=value

Максимальный размер буфера для связи клиент/сервер. Значение по умолчанию — 16 МБ, максимальное значение — 1 ГБ.

--max-join-size=value

Автоматический лимит строк в соединении при использовании --safe-updates. (Значение по умолчанию — 1 000 000.)

--named-commands, -G

Включить именованные команды mysql. Разрешаются команды в длинном формате, а не только в коротком. Например, quit и \q распознаются. Используйте --skip-named-commands для отключения именованных команд. См. раздел 6.5.1.2, «Команды клиента mysql».

--net-buffer-length=value

Размер буфера для TCP/IP и сокетной связи. (Значение по умолчанию — 16 КБ.)

--network-namespace=name

Сеть, которую необходимо использовать для TCP/IP-соединений. Если опустить, соединение использует пространство имен по умолчанию (глобальное). Информацию о пространствах имен сети см. в разделе 7.1.14, «Поддержка пространств имен сети».

Этот параметр доступен только на платформах, которые поддерживают пространства имен сети.

--no-auto-rehash, -A

Это эквивалентно --skip-auto-rehash. См. описание --auto-rehash.

--no-beep, -b

Не издавать звуковой сигнал при возникновении ошибок.

--no-defaults

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

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

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

--oci-config-file=PATH

Альтернативный путь к файлу конфигурации Oracle Cloud Infrastructure CLI. Укажите расположение файла конфигурации. Если ваш существующий профиль по умолчанию является правильным, указывать этот параметр не нужно. Однако, если у вас есть существующий файл конфигурации с несколькими профилями или значением по умолчанию, отличным от тененси пользователя, с которым вы хотите подключиться, укажите этот параметр.

--one-database, -o

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

Изначально mysql выполняет операторы из входных данных, потому что указание базы данных db_name в командной строке эквивалентно вставке оператора USE db_name в начало входных данных. Затем для каждого оператора USE, встретившегося в потоке, mysql принимает или отклоняет последующие операторы в зависимости от того, указана ли в них база данных, указанная в командной строке. Содержание операторов не имеет значения.

Предположим, что mysql вызывается для обработки этого набора операторов:

DELETE FROM db2.t2;
USE db2;
DROP TABLE db1.t1;
CREATE TABLE db1.t1 (i INT);
USE db1;
INSERT INTO t1 (i) VALUES(1);
CREATE TABLE db2.t1 (j INT);

Если командная строка — mysql --force --one-database db1, mysql обрабатывает входные данные следующим образом:

--pager[=command]

Используйте данную команду для постраничного вывода результатов запроса. Если команда пропущена, используется программа просмотра по умолчанию, значение которой задано в переменной среды PAGER. Допустимые программы просмотра: less, more, cat [> filename] и так далее. Эта опция работает только в Unix и только в интерактивном режиме. Чтобы отключить постраничный вывод, используйте --skip-pager. В разделе 6.5.1.2, «Команды клиента mysql» более подробно рассматривается постраничный вывод.

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

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

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

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

--password1[=pass_val]

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

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

Чтобы явно указать, что пароля нет и mysql не должен запрашивать его, используйте параметр --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-authentication-kerberos-client-mode=value

В Windows плагин аутентификации authentication_kerberos_client поддерживает этот параметр плагина. Он предоставляет два возможных значения, которые пользователь клиента может установить во время выполнения: SSPI и GSSAPI.

Значение по умолчанию для параметра плагина на стороне клиента использует Security Support Provider Interface (SSPI), который способен получать учетные данные из кэша памяти Windows. В качестве альтернативы пользователь клиента может выбрать режим, который поддерживает Generic Security Service Application Program Interface (GSSAPI) через библиотеку MIT Kerberos в Windows. GSSAPI способен получать кэшированные учетные данные, ранее сгенерированные с помощью команды kinit.

Для получения дополнительной информации см. Команды для клиентов Windows в режиме GSSAPI.

--plugin-authentication-webauthn-client-preserve-privacy={OFF|ON}

Определяет, как утверждения отправляются на сервер в случае, если для данного идентификатора RP (уникальное имя, присвоенное серверу доверенной стороны, которым является сервер MySQL) хранится более одного обнаруживаемого учетного подтверждения. Если устройство FIDO2 содержит несколько резидентных ключей для данного идентификатора RP, этот параметр позволяет пользователю выбрать ключ, который будет использоваться для утверждения. Он предоставляет два возможных значения, которые пользователь клиента может установить. Значение по умолчанию — OFF. Если установлено значение OFF, запрос подписывается всеми доступными учетными данными для данного идентификатора RP, и все подписи отправляются на сервер. Если установлено значение ON, пользователю предлагается выбрать учетные данные, которые будут использоваться для подписи.

Для получения дополнительной информации см. раздел 8.4.1.11, «Подключаемая аутентификация WebAuthn».

--plugin-dir=dir_name

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

--port=port_num, -P port_num

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

--print-defaults

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

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

--prompt=format_str

Устанавливает указанный формат приглашения. По умолчанию используется mysql>. Специальные последовательности, которые может содержать приглашение, описаны в разделе 6.5.1.2, «Команды клиента mysql».

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

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

--quick, -q

Не кэшировать каждый результат запроса, выводить каждую строку по мере ее получения. Это может замедлить сервер, если вывод приостановлен. С этим параметром mysql не использует файл истории.

По умолчанию mysql извлекает все строки результатов перед выводом; при этом хранении он рассчитывает максимальную длину столбца на основе фактического значения каждого столбца в последовательности. При выводе он использует этот максимум для форматирования. При использовании --quick, mysql не имеет строк, для которых нужно вычислить длину перед началом, и поэтому использует максимальную длину. В следующем примере таблица t1 имеет один столбец типа BIGINT и содержит 4 строки. Вывод по умолчанию имеет ширину 9 символов; эта ширина равна максимальному числу символов в любом из значений столбца в возвращаемых строках (5), плюс 2 символа каждый для пробелов, используемых в качестве отступа, и символов |, используемых в качестве разделителей столбцов). Вывод при использовании параметра --quick имеет ширину 25 символов; это равно числу символов, необходимых для представления -9223372036854775808, которое является самым длинным возможным значением, которое может быть сохранено в столбце (знаковых) BIGINT, или 19 символов, плюс 4 символа для отступа и разделителей столбцов. Разницу можно увидеть здесь:

$> mysql -t test -e "SELECT * FROM t1"
+-------+
| c1    |
+-------+
|   100 |
|  1000 |
| 10000 |
|    10 |
+-------+

$> mysql --quick -t test -e "SELECT * FROM t1"
+----------------------+
| c1                   |
+----------------------+
|                  100 |
|                 1000 |
|                10000 |
|                   10 |
+----------------------+

--raw, -r

Для табличного вывода, «рамка» вокруг столбцов позволяет различать значения одного столбца от другого. Для нетабличного вывода (например, при выводе в пакетном режиме или при использовании параметра --batch или --silent), специальные символы в выводе экранируются, чтобы их можно было легко идентифицировать. Новая строка, табуляция, NUL и обратная косая черта записываются как \n, \t, \0 и \\. Параметр --raw отключает эту экранировку символов.

Следующий пример демонстрирует табличный и нетабличный вывод, а также использование режима raw для отключения экранирования:

% mysql
mysql> SELECT CHAR(92);
+----------+
| CHAR(92) |
+----------+
| \        |
+----------+

% mysql -s
mysql> SELECT CHAR(92);
CHAR(92)
\\

% mysql -s -r
mysql> SELECT CHAR(92);
CHAR(92)
\

--reconnect

Если подключение к серверу потеряно, автоматически попытаться переподключиться. Одна попытка переподключения выполняется каждый раз при потере соединения. Чтобы подавить поведение переподключения, используйте --skip-reconnect.

--register-factor=value

Фактор или факторы, для которых должна быть выполнена регистрация устройства FIDO/FIDO2, прежде чем можно будет использовать аутентификацию на основе устройств WebAuthn. Это значение параметра должно быть одним значением или двумя значениями, разделенными запятыми. Каждое значение должно быть 2 или 3, поэтому допустимые значения параметров — '2', '3', '2,3' и '3,2'.

Например, учетная запись, требующая регистрации для третьего фактора аутентификации, вызывает клиент mysql следующим образом:

mysql --user=user_name --register-factor=3

Учетная запись, требующая регистрации для второго и третьего факторов аутентификации, вызывает клиент mysql следующим образом:

mysql --user=user_name --register-factor=2,3

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

Регистрация — это двухэтапный процесс, состоящий из шагов инициирование регистрации и завершение регистрации. Шаг инициирования регистрации выполняет это утверждение:

ALTER USER user factor INITIATE REGISTRATION

Утверждение возвращает набор результатов, содержащий 32-байтовый вызов, имя пользователя и идентификатор стороны, полагающейся на доверенность (см. authentication_webauthn_rp_id).

Шаг завершения регистрации выполняет это утверждение:

ALTER USER user factor FINISH REGISTRATION SET CHALLENGE_RESPONSE AS 'auth_string'

Утверждение завершает регистрацию и отправляет следующую информацию на сервер как часть auth_string: данные аутентификатора, необязательный сертификат аутентификации в формате X.509 и подпись.

Шаги инициирования и регистрации должны выполняться в одном подключении, так как вызов, полученный клиентом во время шага инициирования, сохраняется в обработчике подключения клиента. Регистрация завершится неудачей, если шаг регистрации был выполнен другим подключением. Параметр --register-factor выполняет оба шага инициирования и регистрации, что позволяет избежать описанной выше ситуации ошибки и предотвращает необходимость выполнения инструкций инициирования и регистрации ALTER USER вручную.

Параметр --register-factor доступен только для клиентов mysql и MySQL Shell. Другие программы-клиенты MySQL не поддерживают его.

Для получения дополнительной информации см. раздел по использованию аутентификации WebAuthn.

--safe-updates, --i-am-a-dummy, -U

Если этот параметр включен, операторы UPDATE и DELETE, которые не используют ключ в предложении WHERE или предложении LIMIT, выдают ошибку. Кроме того, накладываются ограничения на операторы SELECT, которые создают (или, как предполагается, создают) очень большие результирующие наборы. Если вы установили этот параметр в файле параметров, вы можете использовать --skip-safe-updates в командной строке, чтобы переопределить его. Для получения дополнительной информации об этом параметре см. Использование безопасного режима обновлений (--safe-updates).

--select-limit=value

Автоматическое ограничение для операторов SELECT при использовании --safe-updates. (Значение по умолчанию — 1000.)

--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.3, «SHA-256 Pluggable Authentication», и Раздел 8.4.1.2, «Caching SHA-2 Pluggable Authentication».

--shared-memory-base-name=name

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

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

--show-warnings

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

--sigint-ignore

Игнорировать сигналы SIGINT (как правило, результат нажатия клавиш Control+C).

Без этого параметра нажатие клавиш Control+C прерывает текущий оператор, если он есть, или отменяет любую частичную строку ввода в противном случае.

--silent, -s

Бесшумный режим. Выводить меньше информации. Этот параметр может быть указан несколько раз для вывода всё меньшего и меньшего количества информации.

Этот параметр приводит к нетабулированному формату вывода и экранированию специальных символов. Экранирование может быть отключено с помощью необработанного режима; см. описание параметра --raw.

--skip-column-names, -N

Не записывать имена столбцов в результаты. Использование этого параметра приводит к выравниванию вывода по правому краю, как показано здесь:

$> echo "SELECT * FROM t1" | mysql -t test
+-------+
| c1    |
+-------+
| a,c,d |
| c     |
+-------+
$> echo "SELECT * FROM t1" | ./mysql -uroot -Nt test
+-------+
| a,c,d |
|     c |
+-------+

--skip-line-numbers, -L

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

--skip-system-command

Отключает команду system (\!). Эквивалентно --system-command=OFF.

--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.

--syslog, -j

Эта опция заставляет mysql отправлять интерактивные инструкции в средство системного логирования. В Unix это syslog; в Windows это журнал событий Windows. Пункт назначения, в котором отображаются сообщения журнала, зависит от системы. В Linux пункт назначения часто является файлом /var/log/messages.

Ниже приведен пример вывода, созданного в Linux с помощью --syslog. Этот вывод отформатирован для удобочитаемости; каждое сообщение журнала фактически занимает одну строку.

Mar  7 12:39:25 myhost MysqlClient[20824]:
  SYSTEM_USER:'oscar', MYSQL_USER:'my_oscar', CONNECTION_ID:23,
  DB_SERVER:'127.0.0.1', DB:'--', QUERY:'USE test;'
Mar  7 12:39:28 myhost MysqlClient[20824]:
  SYSTEM_USER:'oscar', MYSQL_USER:'my_oscar', CONNECTION_ID:23,
  DB_SERVER:'127.0.0.1', DB:'test', QUERY:'SHOW TABLES;'

Для получения дополнительной информации см. Раздел 6.5.1.3, «Журналирование клиента mysql».

--system-command[={ON|OFF}]

Включить или отключить команду system (\!). Когда эта опция отключена, либо --system-command=OFF, либо --skip-system-command, команда system отклоняется с ошибкой.

--table, -t

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

--tee=file_name

Добавить копию вывода в указанный файл. Эта опция работает только в интерактивном режиме. Раздел 6.5.1.2, «Команды клиента mysql», более подробно рассматривает файлы tee.

--tls-ciphersuites=ciphersuite_list

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

--tls-sni-servername=server_name

При указании имя передается в библиотеку API libmysqlclient C с помощью опции 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 и шифры».

--unbuffered, -n

Сбросить буфер после каждого запроса.

--user=user_name, -u user_name

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

--verbose, -v

Подробный режим. Выводить больше информации о действиях программы. Эта опция может быть указана несколько раз для вывода все большего количества информации. (Например, -v -v -v создает табличный формат вывода даже в пакетном режиме.)

--version, -V

Отобразить информацию о версии и завершить работу.

--vertical, -E

Выводить строки результата запроса вертикально (по одной строке на значение столбца). Без этой опции можно указать вертикальный вывод для отдельных инструкций, завершив их \G.

--wait, -w

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

--xml, -X

Вывод XML-вывода.

<field name="column_name">NULL</field>

Вывод при использовании --xml с mysql соответствует выводу mysqldump --xml. Подробности см. в разделе 6.5.4 «mysqldump — Программа резервного копирования базы данных».

XML-вывод также использует XML-пространство имен, как показано здесь:

$> mysql --xml -uroot -e "SHOW VARIABLES LIKE 'version%'"
<?xml version="1.0"?>

<resultset statement="SHOW VARIABLES LIKE 'version%'" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<row>
<field name="Variable_name">version</field>
<field name="Value">5.0.40-debug</field>
</row>

<row>
<field name="Variable_name">version_comment</field>
<field name="Value">Source distribution</field>
</row>

<row>
<field name="Variable_name">version_compile_machine</field>
<field name="Value">i686</field>
</row>

<row>
<field name="Variable_name">version_compile_os</field>
<field name="Value">suse-linux-gnu</field>
</row>
</resultset>

--zstd-compression-level=level

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

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

telemetry_client

Включает плагин клиента телеметрии (только Linux).

Для получения дополнительной информации см. главу 35 «Телеметрия».