--help, -?

显示帮助消息并退出。

--auto-rehash

启用自动重新哈希。默认情况下启用此选项，这将启用数据库、表和列名补全。使用 --disable-auto-rehash 禁用重新哈希。这会导致 mysql 启动更快，但如果要使用名称补全，则必须发出 rehash 命令或其 \# 快捷方式。

要补全名称，请输入第一部分并按 Tab 键。如果名称 unambiguous，mysql 将会补全它。否则，您可以再次按 Tab 键以查看以您输入的内容开头的可能名称。如果没有默认数据库，则不会进行补全。

--auto-vertical-output

如果结果集对于当前窗口而言过宽，则导致以垂直方式显示结果集，否则使用正常的表格格式。（这适用于以 ; 或 \G 结尾的语句。）

--batch, -B

使用制表符作为列分隔符打印结果，每行在新行上。使用此选项时，mysql 不使用历史记录文件。

批处理模式会导致非表格输出格式和特殊字符的转义。可以使用原始模式禁用转义；有关说明，请参阅 --raw 选项。

--binary-as-hex

指定此选项后，mysql 将使用十六进制表示法（0xvalue）显示二进制数据。无论整体输出显示格式是表格、垂直、HTML 还是 XML，都会发生这种情况。

启用 --binary-as-hex 后会影响所有二进制字符串的显示，包括由 CHAR() 和 UNHEX() 等函数返回的字符串。以下示例使用 A 的 ASCII 代码（十进制 65，十六进制 41）演示了这一点

要编写二进制字符串表达式，使其显示为字符串，而无论是否启用了 --binary-as-hex，请使用以下技术

当 mysql 在交互模式下运行时，默认情况下启用此选项。此外，当隐式或显式启用该选项时，status（或 \s）命令的输出将包含以下行

Binary data as: Hexadecimal

要禁用十六进制表示法，请使用 --skip-binary-as-hex

--binary-mode

此选项有助于处理可能包含 BLOB 值的 mysqlbinlog 输出。默认情况下，mysql 将语句字符串中的 \r\n 转换为 \n，并将 \0 解释为语句终止符。--binary-mode 禁用这两个功能。它还禁用非交互模式下除 charset 和 delimiter 之外的所有 mysql 命令（对于通过管道传输到 mysql 的输入或使用 source 命令加载的输入）。

--bind-address=ip_address

在具有多个网络接口的计算机上，使用此选项可以选择用于连接到 MySQL 服务器的接口。

--character-sets-dir=dir_name

安装字符集的目录。请参阅 第 12.15 节，“字符集配置”。

--column-names

在结果中写入列名。

--column-type-info

显示结果集元数据。此信息对应于 C API MYSQL_FIELD 数据结构的内容。请参阅 C API 基本数据结构。

--comments, -c

是否保留或删除发送到服务器的语句中的注释。默认值是保留它们；要删除它们，请使用 --skip-comments 启动 mysql。

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

仅当使用 WITH_DEBUG 构建 MySQL 时，此选项才可用。Oracle 提供的 MySQL 发行版二进制文件不使用此选项构建。

--debug-check

程序退出时打印一些调试信息。

仅当使用 WITH_DEBUG 构建 MySQL 时，此选项才可用。Oracle 提供的 MySQL 发行版二进制文件不使用此选项构建。

--debug-info, -T

程序退出时打印调试信息以及内存和 CPU 使用情况统计信息。

仅当使用 WITH_DEBUG 构建 MySQL 时，此选项才可用。Oracle 提供的 MySQL 发行版二进制文件不使用此选项构建。

--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 服务器的连接的候选主机。有关 MySQL 中 DNS SRV 支持的信息，请参阅 第 6.2.6 节“使用 DNS SRV 记录连接到服务器”。

假设为 example.com 域使用以下 SRV 信息配置了 DNS

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 优先。 --dns-srv-name 会导致连接建立使用 mysql_real_connect_dns_srv() C API 函数而不是 mysql_real_connect()。但是，如果随后在运行时使用 connect 命令并指定主机名参数，则该主机名优先于在 mysql 启动时给出的用于指定 DNS SRV 记录的任何 --dns-srv-name 选项。

--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 优先。 --dns-srv-name 会导致连接建立使用 mysql_real_connect_dns_srv() C API 函数而不是 mysql_real_connect()。但是，如果随后在运行时使用 connect 命令并指定主机名参数，则该主机名优先于在 mysql 启动时给出的用于指定 DNS SRV 记录的任何 --dns-srv-name 选项。

--html, -H

生成 HTML 输出。

--ignore-spaces, -i

忽略函数名后的空格。在对 IGNORE_SPACE SQL 模式的讨论中描述了此操作的效果（请参阅 第 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

此选项会影响 LOAD DATA 操作的客户端 LOCAL 功能。它指定了 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 时，它们给出的顺序无关紧要。

要在 mysql 中成功使用 LOCAL 加载操作，还需要服务器允许本地加载；请参阅 第 8.1.6 节“LOAD DATA LOCAL 的安全注意事项”

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

默认情况下，LOAD DATA 的 LOCAL 功能由编译到 MySQL 客户端库中的默认值确定。要显式启用或禁用 LOCAL 数据加载，请使用 --local-infile 选项。如果未指定值，则该选项启用 LOCAL 数据加载。如果指定为 --local-infile=0 或 --local-infile=1，则该选项禁用或启用 LOCAL 数据加载。

如果 LOCAL 功能被禁用，则可以使用 --load-data-local-dir 选项允许对指定目录中的文件进行受限的本地加载。

要在 mysql 中成功使用 LOCAL 加载操作，还需要服务器允许本地加载；请参阅 第 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

客户端/服务器通信的缓冲区最大大小。默认值为 16MB，最大值为 1GB。

--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 和套接字通信的缓冲区大小。（默认值为 16KB。）

--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[=密码]，-p[密码]

用于连接到服务器的 MySQL 帐户的密码。密码值是可选的。如果没有给出，mysql 会提示您输入密码。如果给出，则 --password= 或 -p 和后面的密码之间必须 没有空格。如果没有指定密码选项，则默认情况下不发送密码。

在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码，请使用选项文件。请参阅 “第 8.1.2.1 节 “最终用户密码安全指南”。

要明确指定没有密码并且 mysql 不应提示输入密码，请使用 --skip-password 选项。

--password1[=密码值]

用于连接到服务器的 MySQL 帐户的多因素身份验证因素 1 的密码。密码值是可选的。如果没有给出，mysql 会提示您输入密码。如果给出，则 --password1= 和后面的密码之间必须 没有空格。如果没有指定密码选项，则默认情况下不发送密码。

在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码，请使用选项文件。请参阅 “第 8.1.2.1 节 “最终用户密码安全指南”。

要明确指定没有密码并且 mysql 不应提示输入密码，请使用 --skip-password1 选项。

--password1 和 --password 是同义词，--skip-password1 和 --skip-password 也是如此。

--password2[=密码值]

用于连接到服务器的 MySQL 帐户的多因素身份验证因素 2 的密码。此选项的语义类似于 --password1 的语义；有关详细信息，请参阅该选项的说明。

--password3[=密码值]

用于连接到服务器的 MySQL 帐户的多因素身份验证因素 3 的密码。此选项的语义类似于 --password1 的语义；有关详细信息，请参阅该选项的说明。

--pipe，-W

在 Windows 上，使用命名管道连接到服务器。仅当使用启用 named_pipe 系统变量启动服务器以支持命名管道连接时，此选项才适用。此外，进行连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

--plugin-authentication-kerberos-client-mode=值

在 Windows 上，authentication_kerberos_client 身份验证插件支持此插件选项。它提供了客户端用户可以在运行时设置的两个可能值：SSPI 和 GSSAPI。

客户端插件选项的默认值使用安全支持提供程序接口 (SSPI)，它能够从 Windows 内存缓存中获取凭据。或者，客户端用户可以通过 Windows 上的 MIT Kerberos 库选择支持通用安全服务应用程序编程接口 (GSSAPI) 的模式。GSSAPI 能够获取以前使用 kinit 命令生成的缓存凭据。

有关更多信息，请参阅 GSSAPI 模式下 Windows 客户端的命令。

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

如果为给定 RP ID（赋予依赖方服务器（即 MySQL 服务器）的唯一名称）存储了多个可发现凭据，则确定如何将断言发送到服务器。如果 FIDO2 设备包含给定 RP ID 的多个驻留密钥，则此选项允许用户选择用于断言的密钥。它提供了客户端用户可以设置的两个可能值。默认值为 OFF。如果设置为 OFF，则挑战由给定 RP ID 可用的所有凭据签名，并且所有签名都发送到服务器。如果设置为 ON，则系统会提示用户选择用于签名的凭据。

有关更多信息，请参阅 “第 8.4.1.11 节 “WebAuthn 可插拔身份验证”。

--plugin-dir=目录名

要在其中查找插件的目录。如果使用 --default-auth 选项指定身份验证插件但 mysql 找不到它，请指定此选项。请参阅 “第 8.2.17 节 “可插拔身份验证”。

--port=端口号，-P 端口号

对于 TCP/IP 连接，要使用的端口号。

--print-defaults

打印程序名称及其从选项文件中获取的所有选项。

有关此选项文件选项和其他选项文件选项的更多信息，请参阅 第 6.2.2.3 节“影响选项文件处理的命令行选项”。

--prompt=格式字符串

将提示符设置为指定的格式。默认值为 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 选项禁用此字符转义。

以下示例演示了表格输出与非表格输出，以及使用原始模式禁用转义

% 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=值

必须先为其执行 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 字节的 challenge、用户名和依赖方 ID（请参阅 authentication_webauthn_rp_id）。

完成注册步骤执行以下语句

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

该语句完成注册并将以下信息作为 auth_string 的一部分发送到服务器：认证器数据、可选的 X.509 格式的证明证书和签名。

启动和注册步骤必须在单个连接中执行，因为客户端在启动步骤期间收到的 challenge 会保存到客户端连接处理程序。如果注册步骤由不同的连接执行，则注册将失败。--register-factor 选项执行启动和注册步骤，这避免了上述失败情况，并且无需手动执行 ALTER USER 启动和注册语句。

--register-factor 选项仅适用于 mysql 和 MySQL Shell 客户端。其他 MySQL 客户端程序不支持它。

有关信息，请参阅 使用 WebAuthn 身份验证。

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

如果启用此选项，则在 WHERE 子句或 LIMIT 子句中未使用键的 UPDATE 和 DELETE 语句会产生错误。此外，对生成（或估计会生成）非常大的结果集的 SELECT 语句也有限制。如果您在选项文件中设置了此选项，则可以在命令行上使用 --skip-safe-updates 来覆盖它。有关此选项的更多信息，请参阅 使用安全更新模式 (--safe-updates)。

--select-limit=值

使用 --safe-updates 时，SELECT 语句的自动限制。（默认值为 1,000。）

--server-public-key-path=文件名

PEM 格式文件的路径名，其中包含客户端副本，该副本是服务器进行基于 RSA 密钥对的密码交换所需的公钥。此选项适用于使用 sha256_password（已弃用）或 caching_sha2_password 身份验证插件进行身份验证的客户端。对于未使用其中一个插件进行身份验证的帐户，此选项将被忽略。如果未使用基于 RSA 的密码交换（例如，当客户端使用安全连接连接到服务器时），则也会忽略此选项。

如果给出 --server-public-key-path=file_name 并指定了有效的公钥文件，则它优先于 --get-server-public-key。

对于 sha256_password（已弃用），此选项仅在使用 OpenSSL 构建 MySQL 时适用。

有关 sha256_password 和 caching_sha2_password 插件的信息，请参阅 第 8.4.1.3 节“SHA-256 可插拔身份验证” 和 第 8.4.1.2 节“缓存 SHA-2 可插拔身份验证”。

--shared-memory-base-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

不为错误写入行号。当您想要比较包含错误消息的结果文件时，此选项很有用。

--socket=路径, -S 路径

对于到 localhost 的连接，要使用的 Unix 套接字文件，或者在 Windows 上，要使用的命名管道的名称。

在 Windows 上，仅当服务器在启动时启用了 named_pipe 系统变量以支持命名管道连接时，此选项才适用。此外，建立连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

--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 文件。

以下是使用 --syslog 在 Linux 上生成的输出示例。此输出的格式是为了便于阅读；每个记录的消息实际上都占一行。

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 客户端日志记录”。

--table, -t

以表格格式显示输出。这是交互式使用的默认设置，但可用于在批处理模式下生成表格输出。

--tee=文件名

将输出副本附加到指定的文件。此选项仅在交互模式下有效。第 6.5.1.2 节“mysql 客户端命令” 进一步讨论了 tee 文件。

--tls-ciphersuites=密码套件列表

使用 TLSv1.3 的加密连接允许的密码套件。该值是一个或多个以冒号分隔的密码套件名称列表。此选项可以命名的密码套件取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参阅 第 8.3.2 节“加密连接 TLS 协议和密码”。

--tls-sni-servername=服务器名

指定时，使用 mysql_options() 的 MYSQL_OPT_TLS_SNI_SERVERNAME 选项将名称传递到 libmysqlclient C API 库。服务器名称不区分大小写。要显示客户端为当前会话指定的服务器名称（如果有），请检查 Tls_sni_server_name 状态变量。

服务器名称指示 (SNI) 是 TLS 协议的扩展（OpenSSL 必须使用 TLS 扩展进行编译，此选项才能生效）。MySQL 对 SNI 的实现仅表示客户端。

--tls-version=protocol_list

允许用于加密连接的 TLS 协议。该值是一个或多个以逗号分隔的协议名称列表。此选项可以命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参阅第 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 章，“遥测”。