--help, -?

Вывести справку и завершить работу.

--auto-rehash

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

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

--authentication-openid-connect-client-id-token-file

Для OpenID Connect, это устанавливает необходимый токен Identity для аутентификации с сопоставленным пользователем MySQL. Это полный путь к файлу токена Identity, используемому при подключении к серверу MySQL. Для получения дополнительной информации см. Раздел 8.4.1.9, «OpenID Connect Pluggable Authentication».

--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, «Character Set Configuration».

--column-names

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

--column-type-info

Отображать метаданные результирующего набора. Эта информация соответствует содержимому структур данных C API 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 по умолчанию запускается с включенным этим параметром enabled. Однако, даже с этим параметром, команды в длинном формате по-прежнему работают с первой строки. См. Раздел 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.3, «Проверка подлинности открытого текста на стороне клиента».)

--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.1, «Кэширование 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 Client Commands».

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

Значение по умолчанию для клиентского параметра плагина использует интерфейс поставщика безопасности (SSPI), который способен получать данные авторизации из кэша Windows в памяти. В качестве альтернативы клиентский пользователь может выбрать режим, поддерживающий интерфейс программирования приложений для служб безопасности общего назначения (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 Pluggable Authentication».

--plugin-authentication-webauthn-device=#

Определяет, какое устройство использовать для аутентификации libfido. По умолчанию используется первое устройство (0).

Дополнительную информацию см. в Разделе 8.4.1.11, «WebAuthn Pluggable Authentication».

--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.2, «Подключаемая аутентификация SHA-256» и Раздел 8.4.1.1, «Кэшируемая подключаемая аутентификация SHA-2».

--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 отклоняется с ошибкой. Чтобы включить её, используйте --system-command=ON.

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

При указании имя передаётся библиотеке 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 шифрованного соединения».

--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, «Телеметрия».