--help, -?

显示帮助消息并退出。

--

标记 mysqlsh 选项列表的结尾和 MySQL Shell 的 API 命令行集成的命令及其参数的开头。 您可以使用此语法从命令行执行 MySQL Shell 全局对象的方法

mysqlsh [options]  -- object method [arguments]

有关更多信息，请参阅第 5.8 节，“API 命令行集成”。

--auth-method=method

用于帐户的身份验证方法。 取决于用于帐户密码的身份验证插件。 对于使用经典 MySQL 协议的 MySQL Shell 连接，请指定身份验证插件的名称，例如 caching_sha2_password。 对于使用 X 协议的 MySQL Shell 连接，请指定以下选项之一

对于使用经典 MySQL 协议的 MySQL Shell 连接，请指定用户帐户使用的身份验证插件的名称，例如 caching_sha2_password（这是 MySQL 8.0 中创建的用户帐户的默认值）。 MySQL Shell 使用 MySQL 客户端库对这些连接进行客户端身份验证。 以下身份验证方法需要额外的配置

从 MySQL 8.0.27 开始，当使用 --auth-method 选项指定 authentication_ldap_sasl_client 或 authentication_kerberos_client 插件，并使用 --mysql-plugin-dir 选项提供插件路径时，支持用于 Kerberos 身份验证的缓存票据授予票据 (TGT)。要使用缓存的 TGT，请勿在连接选项中指定用户名和密码。当您指定这些插件之一但未指定用户名和密码时，MySQL Shell 不会提供系统用户名，不会提示输入密码，也不会尝试使用 Secret Store 帮助程序检索或存储凭据。

有关更多信息，请参阅 第 4.3.5 节，“使用 LDAP 和 Kerberos 身份验证”。

--cluster

确保目标服务器是 InnoDB 集群的一部分，如果是，则将 cluster 全局变量设置为集群对象。

--column-type-info

在 SQL 模式下，在打印查询返回的结果集之前，打印结果集中每个列的元数据，例如列类型和排序规则。

列类型以 MySQL Shell 使用的类型 (Type) 和原始数据库使用的类型 (DBType) 返回。对于使用经典 MySQL 协议的 MySQL Shell 连接，DBType 与协议返回的类型相同，而对于 X 协议连接，DBType 是从可用信息推断出来的。列长度 (Length) 以字节为单位返回。

--compress[={required|preferred|disabled}], -C [{required|preferred|disabled}]

使用此连接控制客户端和服务器之间发送的信息的压缩。它也可用于经典 MySQL 协议和 X 协议连接，您可以选择指定 required、preferred 或 disabled。如果仅指定了 --compress，则默认值为 --compress=required。有关在所有版本中使用 MySQL Shell 压缩控制的信息，请参阅 第 4.3.7 节，“使用压缩连接”。

--connect-timeout=ms

配置 MySQL Shell 等待建立通过命令行参数指定的全局会话的时间（以毫秒为单位）。

--credential-store-helper=helper

用于存储和检索密码的 Secret Store 帮助程序。请参阅 第 4.4 节，“可插拔密码存储”。

--database=name, -D name

要使用的默认架构。这是 --schema 的别名。

--dba=enableXProtocol

在 MySQL Shell 8.4.0 中已弃用。

在与 MySQL 5.7 服务器的连接上启用 X 插件，以便您可以将 X 协议连接用于后续连接。需要使用经典 MySQL 协议进行连接。与 MySQL 8.0 服务器无关，默认情况下已启用 X 插件。

--dba-log-sql[=0|1|2]

记录 AdminAPI 操作（沙盒操作除外）执行的 SQL 语句。默认情况下，即使设置了 --log-level 和 --verbose 选项，此类语句也不会写入 MySQL Shell 应用程序日志文件或作为详细输出发送到控制台。该选项的值是一个介于 0 到 2 之间的整数。0 表示不记录或显示此类语句，这是您未指定该选项时的默认行为。1 表示记录 AdminAPI 操作执行的 SQL 语句，但 SELECT 语句和 SHOW 语句除外（如果您在命令行上指定该选项而不指定值，则这是默认设置）。2 表示完整记录常规 AdminAPI 操作执行的 SQL 语句，包括 SELECT 和 SHOW 语句。有关更多信息，请参阅 第 12 章，“MySQL Shell 日志记录和调试”。

--log-sql[=off|error|on|all|unfiltered]

将 MySQL Shell 执行的所有 SQL 语句记录到 MySQL Shell 日志文件 mysqlsh.log 中。

以下选项可用：

--execute=command, -e command

使用当前活动的语言执行命令并退出。此选项与 --file=file_name 选项互斥。

--file=file_name, -f file_name

指定要在批处理模式下处理的文件。在此之后指定的任何选项都将用作已处理文件的参数。

--force

即使发生错误，也要继续在 SQL 和批处理模式下进行处理。

--histignore=strings

指定不添加到 MySQL Shell 历史记录中的字符串。字符串之间用冒号分隔。匹配不区分大小写，可以使用通配符 * 和 ?。默认忽略的字符串指定为 “*IDENTIFIED*:*PASSWORD*”。请参阅 第 5.5 节，“代码历史记录”。

--host=host_name, -h host_name

连接到给定主机上的 MySQL 服务器。在 Windows 上，如果您指定 --host=. 或 -h .（以句点作为主机名），则 MySQL Shell 将使用默认命名管道（名称为 MySQL）或您使用 --socket 选项指定的备用命名管道进行连接。

--get-server-public-key

MySQL Shell 等效于 --get-server-public-key。

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

请参阅 缓存 SHA-2 可插拔身份验证。

--interactive[=full], -i

在批处理模式下模拟交互模式。

--js, --javascript

在 JavaScript 模式下启动。

--json[={off|pretty|raw}]

控制此会话中 MySQL Shell 输出的 JSON 包装。此选项旨在将 MySQL Shell 与其他程序连接，例如作为测试的一部分。要将查询结果输出更改为使用 JSON 格式，请参阅 --result-format。

当 --json 选项没有值或值为 pretty 时，输出将生成为格式化的 JSON。如果值为 raw，则输出将以原始 JSON 格式生成。在任何这些情况下，--result-format 选项及其别名以及 resultFormat MySQL Shell 配置选项的值都将被忽略。如果值为 off，则不会进行 JSON 包装，并且结果集将以 --result-format 选项或 resultFormat 配置选项指定的格式正常输出。

--log-file=path

更改此 MySQL Shell 实例的 MySQL Shell 应用程序日志文件 mysqlsh.log 的位置。应用程序日志文件的默认位置是用户配置路径，在 Windows 上默认为 %APPDATA%\MySQL\mysqlsh\，在 Unix 上默认为 ~/.mysqlsh/。您可以通过定义环境变量 MYSQLSH_USER_CONFIG_HOME 来覆盖所有 MySQL Shell 实例的用户配置路径。--log-file 选项适用于单个 MySQL Shell 实例，这意味着不同的实例可以写入不同的位置。

--log-level=N

更改 MySQL Shell 应用程序日志文件 mysqlsh.log 的日志记录级别，或禁用到文件的日志记录。该选项需要一个值，可以是 1 到 8 范围内的整数，也可以是 none、internal、error、warning、info、debug、debug2 或 debug3 之一。指定 1 或 none 将禁用到应用程序日志文件的日志记录。如果您未指定此选项，则默认为级别 5 (info)。请参阅第 12 章，*MySQL Shell 日志记录和调试*。

-ma

在 MySQL Shell 8.0.13 版中已弃用。自动尝试使用 X 协议创建会话连接，如果 X 协议不可用，则回退到经典 MySQL 协议。

--mysql, --mc

将启动时创建的全局会话设置为使用经典 MySQL 协议连接。

--mysql-plugin-dir=path

通过覆盖 shell.options.mysqlPluginDir 设置的值，为客户端身份验证插件设置非持久路径。客户端插件在 MySQL Server 软件包中提供，可以相对于 MySQL 基目录（basedir 系统变量的值）定位。例如

有关服务器附带的客户端身份验证插件的列表，请参阅可用的身份验证插件。

--mysqlx, --mx

将启动时创建的全局会话设置为使用 X 协议连接。

--name-cache

根据活动的默认架构启用表名的自动加载。

--no-name-cache, -A

禁用根据活动的默认架构和 DevAPI db 对象加载表名以进行自动完成。使用 \rehash 手动重新加载名称信息。

--no-password

连接到服务器时，如果用户拥有无密码帐户（这很不安全，不推荐使用），或者如果正在使用套接字对等凭据身份验证（对于 Unix 套接字连接），则必须使用 --no-password 显式指定不提供密码，并且不需要密码提示。

--no-wizard, -nw

禁用由创建连接、dba.configureInstance()、Cluster.rebootClusterFromCompleteOutage() 等操作提供的交互式向导。当您想编写 MySQL Shell 脚本并且不想显示交互式提示时，请使用此选项。有关更多信息，请参阅第 5.6 节“批量代码执行”和第 5.8 节“API 命令行集成”。

--oci-config-file=pathToConfigFile

配置要与 OCI 身份验证一起使用的 OCI 配置文件的路径，以连接到 HeatWave Service DB System。

此处定义的值将覆盖 oci.configFile 选项中定义的值。

有关更多信息，请参阅使用 authentication_oci 插件进行身份验证。

--authentication-oci-client-config-profile=profileName

配置 OCI 配置文件中要与 OCI 身份验证一起使用的配置文件，以连接到 HeatWave Service DB System。

此处定义的值将覆盖 oci.profile 选项中定义的值。

有关更多信息，请参阅使用 authentication_oci 插件进行身份验证。

--pager=name

MySQL Shell 用于显示在 SQL 模式下执行的语句和其他选定命令（如联机帮助）的文本输出的外部分页工具。如果您未设置分页工具，则将使用 PAGER 环境变量指定的分页工具。请参阅第 4.6 节“使用分页工具”。

--passwords-from-stdin

从标准输入而不是从终端读取密码。此选项不会影响任何其他密码行为，例如密码提示。

--password[=password], -ppassword

连接到服务器时要使用的密码。连接到 MySQL Shell 接受的最大密码长度为 128 个字符。

--password1[=password]

--password1、--password2 和 --password3 是需要多因素身份验证的帐户要使用的密码。您最多可以提供三个密码。这些选项的工作方式与 --password 选项相同，并且 --password1 被视为等同于该选项。您可以在命令行上指定选项后的密码值（这很不安全），或者如果在没有密码值的情况下给出选项，MySQL Shell 将依次提示用户输入每个密码。仅支持使用命令行参数进行的经典 MySQL 协议连接。

--password2[=password]

需要多因素身份验证的帐户的第二种身份验证方法的密码。请参阅 --password1 选项的说明。

--password3[=password]

需要多因素身份验证的帐户的第三种身份验证方法的密码。请参阅 --password1 选项的说明。

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

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

有关更多信息，请参阅WebAuthn 可插拔身份验证。

--port=端口号, -P 端口号

用于连接的 TCP/IP 端口号。默认端口为 33060。

--py, --python

在 Python 模式下启动。

--pyc=pythonCommand, -c

执行 Python 命令并退出。 此选项之后指定的任何选项都将被视为已处理命令的参数。

--pym

在 MySQL Shell 的 Python 模式下将指定的 Python 模块作为脚本执行。--pym 的工作方式与 Python 的 -m 命令行选项相同。

--quiet-start[=1|2]

启动时不打印介绍信息。MySQL Shell 通常会打印有关产品的信息、有关会话的信息（例如默认架构和连接 ID）、警告消息以及在启动和连接期间返回的任何错误。指定不带值或值为 1 的 --quiet-start 时，不会打印有关 MySQL Shell 产品的信息，但会打印会话信息、警告和错误。如果值为 2，则仅打印错误。

--redirect-primary

确保目标服务器是 InnoDB Cluster 或 InnoDB ReplicaSet 的一部分，如果不是主服务器，则查找主服务器并连接到它。如果在使用此选项时以下任何一项为真，则 MySQL Shell 将退出并报错：

--register-factor=值

在可以使用基于 WebAuthn 设备的身份验证之前，必须为其执行 FIDO/FIDO2 设备注册的一个或多个因素。此选项值必须是单个值，或者是由逗号分隔的两个值。每个值必须为 2 或 3，因此允许的选项值为 '2'、'3'、'2,3' 和 '3,2'。

例如，需要注册第三个身份验证因素的帐户按如下方式调用 mysql 客户端：

mysqlsh --user=user_name --register-factor=3

需要注册第二个和第三个身份验证因素的帐户按如下方式调用 mysql 客户端：

mysqlsh --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 客户端程序不支持它。

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

--replicaset

确保目标服务器属于 InnoDB ReplicaSet，如果是，则使用 InnoDB ReplicaSet 填充 rs 全局变量。然后，您可以使用 rs 全局变量管理 InnoDB ReplicaSet，例如，通过发出 rs.status()。

--redirect-secondary

确保目标服务器是单主 InnoDB Cluster 或 InnoDB ReplicaSet 的一部分，如果不是辅助服务器，则查找辅助服务器并连接到它。如果在使用此选项时以下任何一项为真，则 MySQL Shell 将退出并报错：

--result-format={table|tabbed|vertical|json|json/pretty|ndjson|json/raw|json/array}

为此会话设置 resultFormat MySQL Shell 配置选项的值。格式如下：

如果使用 --json 命令行选项激活会话输出的 JSON 包装，则将忽略 --result-format 选项及其别名以及 resultFormat 配置选项的值。

--save-passwords={always|prompt|never}

控制是否自动将密码存储在密钥库中。always 表示始终存储密码，除非它们已存在于存储中或服务器 URL 被过滤器排除。never 表示从不存储密码。prompt 是默认值，表示系统会询问用户是否存储密码。请参阅 第 4.4 节“可插拔密码存储”。

--schema=名称, -D 名称

要使用的默认架构。

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

MySQL Shell 中与 --server-public-key-path 等效的选项。

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

请参阅 caching_sha2_password 插件 缓存 SHA-2 可插拔身份验证。

--show-warnings={true|false}

如果指定 true（默认值），则在 SQL 模式下，如果存在任何警告，MySQL Shell 会在每条 SQL 语句之后显示警告。如果指定 false，则不显示警告。

--socket[=路径], -S [路径]

在 Unix 上，如果指定了路径，则该路径是用于连接的 Unix 套接字文件的名称。如果指定不带值和等号的 --socket 或不带值的 -S，则使用相应协议的默认 Unix 套接字文件。

在 Windows 上，路径是用于连接的命名管道的名称。管道名称不区分大小写。在 Windows 上，您必须指定路径，并且 --socket 选项仅适用于经典 MySQL 协议会话。

如果指定了端口或主机名（Unix 上不是 localhost，Windows 上不是句点 (.)），则不能指定套接字。

--sql

以 SQL 模式启动，如果未在连接信息中指定要使用的协议，则自动检测协议。如果未指定要使用的协议，则默认为 X 协议连接，回退到经典 MySQL 协议连接。要强制连接使用特定协议，请参阅 --sqlx 或 --sqlc 选项。或者，指定要使用的协议作为类似 URI 的连接字符串的一部分，或者使用 --port 选项。有关更多信息，请参阅第 4.3 节“MySQL Shell 连接”和MySQL Shell 端口。

--sqlc

以 SQL 模式启动，强制连接使用经典 MySQL 协议，例如，将 MySQL Shell 与不支持 X 协议的服务器一起使用。如果您没有将端口指定为连接的一部分，则在您提供此选项时，MySQL Shell 会使用默认的经典 MySQL 协议端口，通常为 3306。您要连接到的端口必须支持经典 MySQL 协议，因此，例如，如果您指定的连接使用 X 协议默认端口 33060，则连接将失败并显示错误。有关更多信息，请参阅第 4.3 节“MySQL Shell 连接”和MySQL Shell 端口。

--sqlx

以 SQL 模式启动，强制连接使用 X 协议。如果您没有将端口指定为连接的一部分，则在您提供此选项时，MySQL Shell 会使用默认的 X 协议端口，通常为 33060。您要连接到的端口必须支持 X 协议，因此，例如，如果您指定的连接使用经典 MySQL 协议默认端口 3306，则连接将失败并显示错误。有关更多信息，请参阅第 4.3 节“MySQL Shell 连接”和MySQL Shell 端口。

--ssh=str

创建一个 SSH 隧道，提供到 MySQL 服务器实例的加密连接。以 [user@]host[:port] 格式提供用于连接 SSH 服务器的 URI，例如

--ssh [email protected]:2222

使用此选项时，您还必须指定 --user、--host 和 --port 选项，或用于连接 MySQL 服务器实例的 URI。有关从 MySQL Shell 进行 SSH 隧道连接的信息，请参阅第 4.3.6 节“使用 SSH 隧道”。

--ssh-config-file=path

指定用于连接 SSH 服务器的 SSH 配置文件的路径。如果未指定此选项，则可以使用 MySQL Shell 配置选项 ssh.configFile 将自定义文件设置为默认值。如果未设置 ssh.configFile，则默认为标准 SSH 配置文件 ~/.ssh/config。如果使用空值指定 --ssh-config-file，则忽略 ssh.configFile 指定的默认文件，而是使用 ~/.ssh/config 文件。

--ssh-identity-file=path

指定用于连接 SSH 服务器的身份文件的路径。如果未指定此选项，则默认为 SSH 配置文件夹中的标准私钥文件（~/.ssh/id_rsa）。

--ssl*

以 --ssl 开头的选项指定是否使用 SSL 连接到服务器，并指示在何处查找 SSL 密钥和证书。mysqlsh SSL 选项的功能与 MySQL 服务器的 SSL 选项相同，有关更多信息，请参阅加密连接的命令选项。

mysqlsh 接受以下 SSL 选项：--ssl-mode、--ssl-ca、--ssl-capath、--ssl-cert、--ssl-cipher、--ssl-crl、--ssl-crlpath、--ssl-key、--tls-version。

--syslog

将您在 MySQL Shell 的 SQL 模式下发出的 SQL 语句发送到操作系统的系统日志记录工具（Unix 上为 syslog，或 Windows 事件日志）。仅当 MySQL Shell 以交互模式启动时，才会记录 SQL 语句的系统日志，因此可以正常启动或使用 --interactive 选项启动。如果在启动时使用 --execute 或 --file 选项以批处理模式运行 mysqlsh，则不会记录系统日志。有关更多信息，请参阅第 12.3 节“用户 SQL 语句的系统日志记录”。

--tabbed

在交互模式下以制表符分隔的格式显示结果。该模式的默认值为表格格式。此选项是 --result-format=tabbed 选项的别名。

--table

在批处理模式下以表格格式显示结果。该模式的默认值为制表符分隔的格式。此选项是 --result-format=table 选项的别名。

--uri=str

在启动时创建连接，在类似 URI 的字符串中指定连接选项，如使用类似 URI 的字符串或键值对连接到服务器中所述。

--user=user_name, -u user_name

连接到服务器时要使用的 MySQL 用户名。

--verbose[=0|1|2|3|4]

激活控制台的详细输出并指定详细程度。该值是 0 到 4 范围内的整数。0 表示不显示任何消息，这是未指定该选项时的默认详细程度设置。1 表示显示错误、警告和信息消息（如果在命令行上指定该选项而不指定值，则为默认设置）。2、3 和 4 添加更高级别的调试消息。有关更多信息，请参阅第 12 章“MySQL Shell 日志记录和调试”。

--version, -V

显示 MySQL Shell 的版本并退出。

--vertical, -E

垂直显示结果，就像对 SQL 查询使用 \G 终止符时一样。此选项是 --result-format=vertical 选项的别名。