--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 会同时禁用这两个功能。它还会在非交互模式下禁用所有 mysql 命令，但 charset 和 delimiter 除外（对于通过管道传递给 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 域配置了以下 DNS SRV 信息

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.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 优先。 --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

添加一条在连接或重新连接到 MySQL 服务器后执行的额外 SQL 语句。它可以在没有 --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.10 节“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=值

在可以使用基于 WebAuthn 设备的身份验证之前，必须为其执行 FIDO/FIDO2 设备注册的一个或多个因子。此选项值必须是单个值，或由逗号分隔的两个值。每个值必须为 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 字节的质询、用户名和依赖方 ID（请参阅 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

如果启用此选项，则在 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.2 节“SHA-256 可插拔身份验证” 和 第 8.4.1.1 节“缓存 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 文件。

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

--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 章“遥测”。