--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 在交互模式下操作时，默认启用该选项。在添加时，状态命令（或 \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=值

服务器连接的允许压缩算法。可用的算法与protocol_compression_algorithms系统变量相同。默认值为uncompressed。

有关更多信息，请参阅第 6.2.8 节，“连接压缩控制”。

--connect-expired-password

指示服务器客户端可以处理沙盒模式，如果用于连接的帐户密码已过期。这对于非交互式调用mysql非常有用，因为通常服务器断开非交互式客户端尝试使用已过期密码的帐户连接。（参阅第 8.2.16 节，“服务器处理已过期密码”。）

--connect-timeout=值

连接超时前的秒数。（默认值为 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=插件

提示客户端使用哪种身份验证插件。参见 第 8.2.17 节，“可插拔身份验证”。

--default-character-set=字符集名称

使用 字符集名称 作为客户端和连接的默认字符集。

如果操作系统使用一种字符集，而 mysql 客户端默认使用另一种字符集，那么输出可能会被格式化不正确。在这种情况下，您可以使用该选项强制客户端使用系统字符集。

更多信息，请参见 第 12.4 节，“连接字符集和排序规则” 和 第 12.15 节，“字符集配置”。

--defaults-extra-file=文件名

在全局选项文件之后但（在 Unix 上）在用户选项文件之前读取该选项文件。如果文件不存在或不可访问，将发生错误。如果 文件名 不是绝对路径名，则相对于当前目录进行解释。

更多信息，请参见 第 6.2.2.3 节，“命令行选项影响选项文件处理”。

--defaults-file=文件名

仅使用给定的选项文件。如果文件不存在或不可访问，将发生错误。如果 文件名 不是绝对路径名，则相对于当前目录进行解释。

例外：即使使用 --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

指定用于确定连接到 MySQL 服务器的候选主机的 DNS SRV 记录的名称。有关 MySQL 中 DNS SRV 支持的信息，请参阅 第 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 记录，invoke mysql 如下：

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

mysql 然后尝试连接到组中的每个服务器，直到成功建立连接。只有在无法连接到所有服务器时才会出现连接失败。DNS SRV 记录中的优先级和权重值确定了服务器的尝试顺序。

使用 --dns-srv-name 选项时，mysql 只尝试建立 TCP 连接。

该 --dns-srv-name 选项优先于 --host 选项，如果同时给出这两个选项。--dns-srv-name 导致连接建立使用 mysql_real_connect_dns_srv() C API 函数，而不是 mysql_real_connect()。然而，如果在运行时使用 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 不使用历史记录文件。

--fido-register-factor=值

该选项的值必须是单个值或以逗号分隔的两个值。每个值必须是 2 或 3，因此允许的选项值是 '2'、'3'、'2,3' 和 '3,2'。

例如，需要注册 3rd 身份验证因子的帐户将使用以下命令调用 mysql 客户端：

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

需要注册 2nd 和 3rd 身份验证因子的帐户将使用以下命令调用 mysql 客户端：

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

如果注册成功，将建立连接。如果存在身份验证因子具有挂起的注册，尝试连接到服务器时将处于挂起注册模式。在这种情况下，断开连接并重新连接使用正确的 --fido-register-factor 值以完成注册。

注册是一个两步过程，包括 initiate 注册 和 finish 注册 步骤。initiate 注册步骤执行以下语句：

ALTER USER user factor INITIATE REGISTRATION

该语句返回一个结果集，包含 32 字节的挑战、用户名和依赖方 ID（请参阅 authentication_fido_rp_id）。

finish 注册步骤执行以下语句：

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

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

initiate 和注册步骤必须在单个连接中执行，因为客户端在 initiate 步骤中收到的挑战将保存到客户端连接处理程序中。如果注册步骤由不同的连接执行，将导致注册失败。--fido-register-factor 选项执行这两个步骤，从而避免了上述失败场景并防止了手动执行 ALTER USER initiate 和注册语句。

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

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

--force, -f

即使出现 SQL 错误，也继续执行。

--get-server-public-key

从服务器请求用于 RSA 密钥对基于密码交换的公钥。该选项适用于使用 caching_sha2_password 身份验证插件的客户端。对于该插件，服务器不会发送公钥，除非被请求。该选项被忽略，如果客户端使用安全连接连接到服务器时，也被忽略。

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

有关 caching_sha2_password 插件的信息，请参阅 第 8.4.1.2 节，“Caching SHA-2 可插拔身份验证”。

--histignore

一个或多个以冒号分隔的模式，指定要忽略的语句用于日志记录目的。这些模式将添加到默认模式列表 ("*IDENTIFIED*:*PASSWORD*") 中。该选项指定的值将影响写入历史文件的语句的日志记录，以及如果给定了 --syslog 选项，则还将影响 syslog 的日志记录。有关更多信息，请参阅 第 6.5.1.3 节，“mysql 客户端日志记录”。

--host=主机名, -h 主机名

连接到指定的 MySQL 服务器主机。

如果同时指定了 --dns-srv-name 选项，则它将优先于 --host 选项。--dns-srv-name 选项会导致连接建立使用 mysql_real_connect_dns_srv() C API 函数，而不是 mysql_real_connect()。然而，如果在运行时使用 connect 命令并指定了主机名参数，那么该主机名将优先于任何 --dns-srv-name 选项在 mysql 启动时指定的 DNS SRV 记录。

--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 之前使用，则没有效果，因为 init-command 将重置命令列表。该选项添加在 MySQL 8.2.0 中。

--line-numbers

为错误写入行号。使用 --skip-line-numbers 禁用该选项。

--load-data-local-dir=dir_name

该选项影响客户端的 LOCAL 能力，以便在 LOAD DATA 操作中使用。它指定了在 LOAD DATA 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}]

默认情况下，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

客户端/服务器通信的最大缓冲区大小。默认值为 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 Configuration Utility”。

有关此选项和其他选项文件选项的更多信息，请参阅 第 6.2.2.3 节，“Command-Line Options that Affect Option-File Handling”。

--oci-config-file=PATH

Oracle 云基础设施 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]

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

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

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

--密码1 和 --密码 是同义的，如同 --skip-password1 和 --skip-password。

--密码2[=pass_val]

MySQL 帐户用于连接到服务器的多因素身份验证因子 2 的密码。该选项的语义与 --密码1 的语义相似；请参阅该选项的描述以获取详细信息。

--密码3[=pass_val]

MySQL 帐户用于连接到服务器的多因素身份验证因子 3 的密码。该选项的语义与 --密码1 的语义相似；请参阅该选项的描述以获取详细信息。

--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）通过 Windows 上的 MIT Kerberos 库。GSSAPI 能够获取之前使用 kinit 命令生成的缓存凭据。

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

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

确定断言如何发送到服务器，在情况下存在多个可发现的凭据存储在 FIDO2 设备中，用于给定的 RP ID（MySQL 服务器的唯一名称）。如果 FIDO2 设备包含多个resident 键用于给定的 RP ID，这个选项允许用户选择用于签名的键。它提供了两个可能的值，客户端用户可以设置。默认值为 OFF。如果设置为 OFF，挑战将被所有可用的凭据签名，并将所有签名发送到服务器。如果设置为 ON，用户将被提示选择用于签名的凭据。

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

--插件目录=dir_name

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

--端口=port_num, -P port_num

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

--打印默认值

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

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

--提示符=format_str

设置提示符为指定的格式。默认为 mysql>。提示符可以包含的特殊序列在第 6.5.1.2 节，“mysql 客户端命令”中描述。

--协议={TCP|SOCKET|PIPE|MEMORY}

用于连接服务器的传输协议。它在其他连接参数通常导致使用其他协议时很有用。有关允许值的详细信息，请参阅第 6.2.7 节，“连接传输协议”。

--快速, -q

不缓存每个查询结果，打印每行结果。这样可能会减慢服务器速度，如果输出被挂起。mysql 不使用历史文件。

默认情况下，mysql 在产生任何输出之前获取所有结果行；在存储这些结果时，它从每个列的实际值中计算出一个运行的最大列长度。当打印输出时，它使用这个最大长度。当指定 --快速 时，mysql 不具有用于计算长度的行，因此使用最大长度。在以下示例中，表 t1 具有一个类型为BIGINT 的单个列，包含 4 行。默认输出宽度为 9 个字符；这等于在返回的行中找到最大列值的长度（5），加上 2 个用于填充和列分隔符的字符）。使用 --快速 选项时的输出宽度为 25 个字符；这等于可以存储在带符号的 BIGINT 列中的最长值（-9223372036854775808），加上 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 |
+----------------------+

--原始, -r

对于表格输出，列的“框”使得一列值可以与其他列值区分开。对于非表格输出（例如批处理模式或使用--批处理或--沉默选项时），输出中的特殊字符将被转义，以便易于识别。换行、制表符、NUL和反斜杠将被写为\n、\t、\0和\\。--原始选项禁用此字符转义。

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

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

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

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

--重新连接

如果与服务器的连接丢失，自动尝试重新连接。每次连接丢失时都会进行一次重新连接尝试。要抑制重新连接行为，请使用--跳过重新连接。

--注册因子=值

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

如果注册成功，连接将被建立。如果存在待注册的身份验证因子，在尝试连接到服务器时，连接将进入待注册模式。在这种情况下，断开连接并重新连接以正确的 --注册因子 值以完成注册。

注册是一个两步过程，包括 启动注册 和 完成注册 步骤。启动注册步骤执行以下语句：

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 格式）和签名。

启动和注册步骤必须在单个连接中执行，因为客户端在启动步骤期间收到的挑战将被保存到客户端连接处理程序中。如果注册步骤由不同的连接执行，将导致注册失败。--注册因子 选项执行启动和注册步骤，从而避免了上述失败场景并防止手动执行 ALTER USER 启动和注册语句。

该 --注册因子 选项仅适用于 mysql 和 MySQL Shell 客户端。其他 MySQL 客户端程序不支持它。

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

--安全更新, --我是一个傻瓜, -U

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

--选择限制=值

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

--服务器公钥路径=文件名

服务器公钥文件的路径名，以 PEM 格式包含客户端副本的公钥，用于 RSA 密钥对基于的密码交换。该选项仅适用于使用 sha256_password 或 caching_sha2_password 身份验证插件的客户端。如果客户端连接到服务器时使用安全连接，则忽略该选项。

如果 --服务器公钥路径=文件名 指定了有效的公钥文件，则它将覆盖 --获取服务器公钥。

对于 sha256_password，该选项仅在 MySQL 使用 OpenSSL 构建时适用。

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

--共享内存基准名称=名称

在 Windows 上，用于连接到本地服务器的共享内存名称。默认值为 MYSQL。共享内存名称区分大小写。

该选项仅在服务器启动时启用 shared_memory 系统变量以支持共享内存连接时适用。

--显示警告

在每个语句后显示警告，如果有任何警告。该选项适用于交互式和批处理模式。

--忽略 SIGINT

忽略 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=path, -S path

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

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

--ssl*

以 --ssl 开头的选项指定是否使用加密连接到服务器，并指示 SSL 密钥和证书的位置。请参阅 Command Options for Encrypted Connections。

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

控制是否在客户端启用 FIPS 模式。--ssl-fips-mode 选项不同于其他 --ssl-xxx 选项，它不是用于建立加密连接，而是影响允许哪些加密操作。请参阅 Section 8.8, “FIPS Support”。

这些 --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=file_name

将输出的副本追加到指定文件中。该选项仅在交互模式下有效。第 6.5.1.2 节，“mysql 客户端命令” 中讨论了 tee 文件的更多信息。

--tls-ciphersuites=ciphersuite_list

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

--tls-sni-servername=server_name

当指定时，该名称将传递给 libmysqlclient C API 库使用 MYSQL_OPT_TLS_SNI_SERVERNAME 选项的 mysql_options()。服务器名称不区分大小写。要显示客户端在当前会话中指定的服务器名称（如果有），请检查 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 甚至在批处理模式下也会产生表格输出格式。)

--版本, -V

显示版本信息并退出。

--垂直, -E

以垂直方式打印查询输出行（每列值一行）。 如果不使用该选项，可以通过在语句结尾添加 \G 来指定垂直输出。

--等待, -w

如果无法建立连接，等待并重试，而不是中止。

--xml, -X

产生 XML 输出。

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

当使用 --xml 与 mysql 时，输出与 mysqldump --xml 的输出相同。 请参阅 第 6.5.4 节，“mysqldump — A Database Backup Program”，以获取详细信息。

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 节，“Connection Compression Control”。

telemetry_client

启用遥测客户端插件（仅限 Linux）。

有关更多信息，请参阅 第 35 章，《遥测》。