### 4.4.5 mysql_upgrade - 检查和升级 MySQL 表

[](<>)[](<>)[](<>)

笔记

从 MySQL 8.0.16 开始，MySQL 服务器执行之前由[**mysql\_升级**](mysql-upgrade.html)（有关详细信息，请参阅[第 2.11.3 节，“MySQL 升级过程升级了什么”](upgrading-what-is-upgraded.html)）。所以，[**mysql\_升级**](mysql-upgrade.html)不需要并且自该版本起已弃用；希望它在 MySQL 的未来版本中被删除。因为[**mysql\_升级**](mysql-upgrade.html)不再执行升级任务，它以状态 0 无条件退出。

每次升级 MySQL 时，都应该执行[**mysql\_升级**](mysql-upgrade.html)，它查找与升级的 MySQL 服务器的不兼容性：

-   它升级系统表中的`mysql`架构，以便您可以利用可能已添加的新特权或功能。

-   它升级了性能模式，`INFORMATION_SCHEMA`， 和`系统`架构。

-   它检查用户模式。

    如果[**mysql\_升级**](mysql-upgrade.html)发现表可能存在不兼容性，它会执行表检查，如果发现问题，则尝试修复表。如果无法修复表，请参阅[第 2.11.13 节，“重建或修复表或索引”](rebuilding-tables.html)用于手动表修复策略。

[**mysql\_升级**](mysql-upgrade.html)直接与 MySQL 服务器通信，向其发送执行升级所需的 SQL 语句。

警告

您应该始终备份当前的 MySQL 安装*前*执行升级。看[第 7.2 节，“数据库备份方法”](backup-methods.html).

一些升级不兼容可能需要特殊处理*前*升级你的 MySQL 安装和运行[**mysql\_升级**](mysql-upgrade.html).看[第 2.11 节，“升级 MySQL”](upgrading.html)，以获取有关确定任何此类不兼容性是否适用于您的安装以及如何处理它们的说明。

采用[**mysql\_升级**](mysql-upgrade.html)像这样：

1.  确保服务器正在运行。

2.  调用[**mysql\_升级**](mysql-upgrade.html)升级系统表`mysql`架构以及检查和修复其他架构中的表：

    ```
    mysql_upgrade [options]
    ```

3.  停止服务器并重新启动它，以使任何系统表更改生效。

    如果您有多个 MySQL 服务器实例要升级，请调用[**mysql\_升级**](mysql-upgrade.html)具有适合连接到每个所需服务器的连接参数。例如，如果服务器在 3306 到 3308 部分的本地主机上运行，​​则通过连接到适当的端口来升级它们中的每一个：


```
mysql_upgrade --protocol=tcp -P 3306 [other_options]
mysql_upgrade --protocol=tcp -P 3307 [other_options]
mysql_upgrade --protocol=tcp -P 3308 [other_options]
```

对于 Unix 上的本地主机连接，[`--协议=tcp`](mysql-upgrade.html#option_mysql_upgrade_protocol)选项强制使用 TCP/IP 而不是 Unix 套接字文件进行连接。

默认，[**mysql\_升级**](mysql-upgrade.html)作为 MySQL 运行`根`用户。如果`根`运行时密码已过期[**mysql\_升级**](mysql-upgrade.html)，它会显示一条消息，提示您的密码已过期并且[**mysql\_升级**](mysql-upgrade.html)结果失败了。要更正此问题，请重置`根`取消过期并运行的密码[**mysql\_升级**](mysql-upgrade.html)再次。首先，连接到服务器`根`：

```
$> mysql -u root -p
Enter password: ****  <- enter root password here
```

使用重置密码[`更改用户`](alter-user.html)：

```
mysql> ALTER USER USER() IDENTIFIED BY 'root-password';
```

然后退出[**mysql**](mysql.html)并运行[**mysql\_升级**](mysql-upgrade.html)再次：

```
$> mysql_upgrade [options]
```

笔记

如果您使用[`disabled_storage_engines`](server-system-variables.html#sysvar_disabled_storage_engines)系统变量设置为禁用某些存储引擎（例如，`MyISAM`),[**mysql\_升级**](mysql-upgrade.html)可能会失败并出现如下错误：

```
mysql_upgrade: [ERROR] 3161: Storage engine MyISAM is disabled
(Table creation is disallowed).
```

要处理此问题，请使用以下命令重新启动服务器[`disabled_storage_engines`](server-system-variables.html#sysvar_disabled_storage_engines)禁用。然后你应该能够运行[**mysql\_升级**](mysql-upgrade.html)成功地。之后，重新启动服务器[`disabled_storage_engines`](server-system-variables.html#sysvar_disabled_storage_engines)设置为其原始值。

除非用[`--升级系统表`](mysql-upgrade.html#option_mysql_upgrade_upgrade-system-tables)选项，[**mysql\_升级**](mysql-upgrade.html)根据需要处理所有用户模式中的所有表。表检查可能需要很长时间才能完成。每个表都被锁定，因此在处理它时对其他会话不可用。检查和修复操作可能很耗时，尤其是对于大型表。表检查使用`升级`的选项[`检查表`](check-table.html)陈述。有关此选项的详细信息，请参阅[第 13.7.3.2 节，“CHECK TABLE 语句”](check-table.html).

[**mysql\_升级**](mysql-upgrade.html)用当前 MySQL 版本号标记所有检查和修复的表。这样可以确保您下次运行时[**mysql\_升级**](mysql-upgrade.html)使用相同版本的服务器，可以确定是否需要再次检查或修复给定的表。

[](<>)[](<>)[](<>)

[**mysql\_升级**](mysql-upgrade.html)将 MySQL 版本号保存在一个名为`mysql_upgrade_info`在数据目录中。这用于快速检查是否已针对此版本检查了所有表，以便可以跳过表检查。要忽略此文件并执行检查，请使用[`- 力量`](mysql-upgrade.html#option_mysql_upgrade_force)选项。

笔记

这`mysql_upgrade_info`文件已弃用；希望它在 MySQL 的未来版本中被删除。

[**mysql\_升级**](mysql-upgrade.html)支票`mysql.user`系统表行，并且对于任何有空的行`插入`列，将该列设置为`'mysql_native_password'`如果凭据使用与该插件兼容的哈希格式。必须手动升级具有 4.1 之前密码哈希的行。

[**mysql\_升级**](mysql-upgrade.html)不升级时区表或帮助表的内容。有关升级说明，请参阅[第 5.1.15 节，“MySQL 服务器时区支持”](time-zone-support.html)， 和[第 5.1.17 节，“服务器端帮助支持”](server-side-help-support.html).

除非用[`--skip-sys-模式`](mysql-upgrade.html#option_mysql_upgrade_skip-sys-schema)选项，[**mysql\_升级**](mysql-upgrade.html)安装`系统`如果未安装 schema，则将其升级到当前版本。如果出现错误`系统`架构存在但没有`版本`视图，假设它的缺失表示用户创建的模式：

```
A sys schema exists with no sys.version view. If
you have a user created sys schema, this must be renamed for the
upgrade to succeed.
```

在这种情况下要升级，请删除或重命名现有的`系统`架构第一。

[**mysql\_升级**](mysql-upgrade.html)支持以下选项，可以在命令行中指定，也可以在`[mysql_升级]`和`[客户]`选项文件的组。有关 MySQL 程序使用的选项文件的信息，请参阅[第 4.2.2.2 节，“使用选项文件”](option-files.html).

[](<>)

**表 4.10 mysql\_升级选项**

| 选项名称 | 描述 | 介绍 | 已弃用 |
| ---- | --- | --- | --- |
| [--绑定地址](mysql-upgrade.html#option_mysql_upgrade_bind-address) | 使用指定的网络接口连接 MySQL Server |  |  |
| [--字符集目录](mysql-upgrade.html#option_mysql_upgrade_character-sets-dir) | 安装字符集的目录 |  |  |
| [--压缩](mysql-upgrade.html#option_mysql_upgrade_compress) | 压缩客户端和服务器之间发送的所有信息 |  | 8.0.18 |
| [--压缩算法](mysql-upgrade.html#option_mysql_upgrade_compression-algorithms) | 允许连接到服务器的压缩算法 | 8.0.18 |  |
| [--调试](mysql-upgrade.html#option_mysql_upgrade_debug) | 写调试日志 |  |  |
| [--调试检查](mysql-upgrade.html#option_mysql_upgrade_debug-check) | 程序退出时打印调试信息 |  |  |
| [--调试信息](mysql-upgrade.html#option_mysql_upgrade_debug-info) | 程序退出时打印调试信息、内存和 CPU 统计信息 |  |  |
| [--默认身份验证](mysql-upgrade.html#option_mysql_upgrade_default-auth) | 要使用的身份验证插件 |  |  |
| [--默认字符集](mysql-upgrade.html#option_mysql_upgrade_default-character-set) | 指定默认字符集 |  |  |
| [--defaults-额外文件](mysql-upgrade.html#option_mysql_upgrade_defaults-extra-file) | 除了通常的选项文件外，还读取命名的选项文件 |  |  |
| [--默认文件](mysql-upgrade.html#option_mysql_upgrade_defaults-file) | 只读命名选项文件 |  |  |
| [--defaults-组后缀](mysql-upgrade.html#option_mysql_upgrade_defaults-group-suffix) | 选项组后缀值 |  |  |
| [--力量](mysql-upgrade.html#option_mysql_upgrade_force) | 即使mysql也强制执行\_已对当前 MySQL 版本执行升级 |  |  |
| [--get-server-public-key](mysql-upgrade.html#option_mysql_upgrade_get-server-public-key) | 从服务器请求 RSA 公钥 |  |  |
| [--帮助](mysql-upgrade.html#option_mysql_upgrade_help) | 显示帮助信息并退出 |  |  |
| [--主持人](mysql-upgrade.html#option_mysql_upgrade_host) | MySQL服务器所在的主机 |  |  |
| [--登录路径](mysql-upgrade.html#option_mysql_upgrade_login-path) | 从 .mylogin.cnf 读取登录路径选项 |  |  |
| [--max-allowed-packet](mysql-upgrade.html#option_mysql_upgrade_max-allowed-packet) | 发送到服务器或从服务器接收的最大数据包长度 |  |  |
| [--净缓冲区长度](mysql-upgrade.html#option_mysql_upgrade_net-buffer-length) | TCP/IP 和套接字通信的缓冲区大小 |  |  |
| [--无默认值](mysql-upgrade.html#option_mysql_upgrade_no-defaults) | 不读取选项文件 |  |  |
| [--密码](mysql-upgrade.html#option_mysql_upgrade_password) | 连接服务器时使用的密码 |  |  |
| [--管道](mysql-upgrade.html#option_mysql_upgrade_pipe) | 使用命名管道连接到服务器（仅限 Windows） |  |  |
| [--插件目录](mysql-upgrade.html#option_mysql_upgrade_plugin-dir) | 插件安装目录 |  |  |
| [--港口](mysql-upgrade.html#option_mysql_upgrade_port) | 用于连接的 TCP/IP 端口号 |  |  |
| [--打印默认值](mysql-upgrade.html#option_mysql_upgrade_print-defaults) | 打印默认选项 |  |  |
| [--协议](mysql-upgrade.html#option_mysql_upgrade_protocol) | 要使用的传输协议 |  |  |
| [--服务器公钥路径](mysql-upgrade.html#option_mysql_upgrade_server-public-key-path) | 包含 RSA 公钥的文件的路径名 |  |  |
| [--shared-memory-base-name](mysql-upgrade.html#option_mysql_upgrade_shared-memory-base-name) | 共享内存连接的共享内存名称（仅限 Windows） |  |  |
| [--skip-sys-模式](mysql-upgrade.html#option_mysql_upgrade_skip-sys-schema) | 不要安装或升级 sys 架构 |  |  |
| [--插座](mysql-upgrade.html#option_mysql_upgrade_socket) | 要使用的 Unix 套接字文件或 Windows 命名管道 |  |  |
| [--ssl-ca](mysql-upgrade.html#option_mysql_upgrade_ssl) | 包含受信任 SSL 证书颁发机构列表的文件 |  |  |
| [--ssl-capath](mysql-upgrade.html#option_mysql_upgrade_ssl) | 包含受信任的 SSL 证书颁发机构证书文件的目录 |  |  |
| [--ssl 证书](mysql-upgrade.html#option_mysql_upgrade_ssl) | 包含 X.509 证书的文件 |  |  |
| [--ssl密码](mysql-upgrade.html#option_mysql_upgrade_ssl) | 连接加密的允许密码 |  |  |
| [--ssl-crl](mysql-upgrade.html#option_mysql_upgrade_ssl) | 包含证书吊销列表的文件 |  |  |
| [--ssl-crlpath](mysql-upgrade.html#option_mysql_upgrade_ssl) | 包含证书吊销列表文件的目录 |  |  |
| [--ssl-fips 模式](mysql-upgrade.html#option_mysql_upgrade_ssl-fips-mode) | 客户端是否开启 FIPS 模式 |  |  |
| [--ssl 密钥](mysql-upgrade.html#option_mysql_upgrade_ssl) | 包含 X.509 密钥的文件 |  |  |
| [--ssl 模式](mysql-upgrade.html#option_mysql_upgrade_ssl) | 连接到服务器的所需安全状态 |  |  |
| [--ssl 会话数据](mysql-upgrade.html#option_mysql_upgrade_ssl) | 包含 SSL 会话数据的文件 | 8.0.29 |  |
| [--ssl-session-data-continue-on-failed-reuse](mysql-upgrade.html#option_mysql_upgrade_ssl) | 会话重用失败时是否建立连接 | 8.0.29 |  |
| [--tls-密码套件](mysql-upgrade.html#option_mysql_upgrade_tls-ciphersuites) | 用于加密连接的允许 TLSv1.3 密码套件 | 8.0.16 |  |
| [--tls-版本](mysql-upgrade.html#option_mysql_upgrade_tls-version) | 加密连接的允许 TLS 协议 |  |  |
| [--升级系统表](mysql-upgrade.html#option_mysql_upgrade_upgrade-system-tables) | 只更新系统表，不更新用户模式 |  |  |
| [--用户](mysql-upgrade.html#option_mysql_upgrade_user) | 连接到服务器时使用的 MySQL 用户名 |  |  |
| [--详细](mysql-upgrade.html#option_mysql_upgrade_verbose) | 详细模式 |  |  |
| [--版本检查](mysql-upgrade.html#option_mysql_upgrade_version-check) | 检查正确的服务器版本 |  |  |
| [--write-binlog](mysql-upgrade.html#option_mysql_upgrade_write-binlog) | 将所有语句写入二进制日志 |  |  |
| [--zstd-压缩级别](mysql-upgrade.html#option_mysql_upgrade_zstd-compression-level) | 与使用 zstd 压缩的服务器的连接的压缩级别 | 8.0.18 |  |

-   [](<>) [`- 帮助`](mysql-upgrade.html#option_mysql_upgrade_help)

    [](<>)[](<>)

    显示简短的帮助信息并退出。

-   [](<>) [`--绑定地址=*`IP地址`*`](mysql-upgrade.html#option_mysql_upgrade_bind-address)

    [](<>)[](<>)

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

-   [](<>) [`--字符集目录=*`目录名`*`](mysql-upgrade.html#option_mysql_upgrade_character-sets-dir)

    [](<>)[](<>)

    安装字符集的目录。看[第 10.15 节，“字符集配置”](charset-configuration.html).

-   [](<>) [`- 压缩`](mysql-upgrade.html#option_mysql_upgrade_compress),`-C`

    [](<>)[](<>)

    如果可能，压缩客户端和服务器之间发送的所有信息。看[第 4.2.8 节，“连接压缩控制”](connection-compression-control.html).

    从 MySQL 8.0.18 开始，此选项已弃用。期望它在 MySQL 的未来版本中被删除。看[配置旧版连接压缩](connection-compression-control.html#connection-compression-legacy-configuration).

-   [](<>) [`--压缩算法=*`价值`*`](mysql-upgrade.html#option_mysql_upgrade_compression-algorithms)

    [](<>)[](<>)

    连接到服务器的允许压缩算法。可用的算法与[`协议压缩算法`](server-system-variables.html#sysvar_protocol_compression_algorithms)系统变量。默认值为`未压缩`.

    有关详细信息，请参阅[第 4.2.8 节，“连接压缩控制”](connection-compression-control.html).

    此选项是在 MySQL 8.0.18 中添加的。

-   [](<>) [`--调试[=*`调试选项`*]`](mysql-upgrade.html#option_mysql_upgrade_debug),`-# [*`调试选项`*]`

    [](<>)[](<>)

    编写调试日志。一个典型的*`调试选项`*字符串是`d:t:o,*`文件名`*`.默认是`d:t:O,/tmp/mysql_upgrade.trace`.

-   [](<>) [`--调试检查`](mysql-upgrade.html#option_mysql_upgrade_debug-check)

    [](<>)[](<>)

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

-   [](<>) [`- 调试信息`](mysql-upgrade.html#option_mysql_upgrade_debug-info),`-T`

    [](<>)[](<>)

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

-   [](<>) [`--default-auth=*`插入`*`](mysql-upgrade.html#option_mysql_upgrade_default-auth)

    [](<>)[](<>)

    关于使用哪个客户端身份验证插件的提示。看[第 6.2.17 节，“可插拔身份验证”](pluggable-authentication.html).

-   [](<>) [`--默认字符集=*`字符集名称`*`](mysql-upgrade.html#option_mysql_upgrade_default-character-set)

    [](<>)[](<>)

    采用*`字符集名称`*作为默认字符集。看[第 10.15 节，“字符集配置”](charset-configuration.html).

-   [](<>) [`--defaults-extra-file=*`文件名`*`](mysql-upgrade.html#option_mysql_upgrade_defaults-extra-file)

    [](<>)[](<>)

    在全局选项文件之后但（在 Unix 上）在用户选项文件之前读取此选项文件。如果文件不存在或无法访问，则会发生错误。如果*`文件名`*不是绝对路径名，它是相对于当前目录解释的。

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--默认文件=*`文件名`*`](mysql-upgrade.html#option_mysql_upgrade_defaults-file)

    [](<>)[](<>)

    仅使用给定的选项文件。如果文件不存在或无法访问，则会发生错误。如果*`文件名`*不是绝对路径名，它是相对于当前目录解释的。

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--defaults-group-suffix=*`字符串`*`](mysql-upgrade.html#option_mysql_upgrade_defaults-group-suffix)

    [](<>)[](<>)

    不仅可以读取通常的选项组，还可以读取具有通常名称和后缀的组*`字符串`*.例如，[**mysql\_升级**](mysql-upgrade.html)通常读取`[客户]`和`[mysql_升级]`团体。如果这个选项被给出为[`--defaults-group-suffix=_other`](mysql-upgrade.html#option_mysql_upgrade_defaults-group-suffix),[**mysql\_升级**](mysql-upgrade.html)还读取`[client_other]`和`[mysql_upgrade_other]`团体。

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`- 力量`](mysql-upgrade.html#option_mysql_upgrade_force)

    [](<>)[](<>)

    忽略`mysql_upgrade_info`文件并强制执行，即使[**mysql\_升级**](mysql-upgrade.html)已经为当前版本的 MySQL 执行了。

-   [](<>) [`--get-server-public-key`](mysql-upgrade.html#option_mysql_upgrade_get-server-public-key)

    [](<>)[](<>)

    从服务器请求基于 RSA 密钥对的密码交换所需的公钥。此选项适用于通过`cache_sha2_password`身份验证插件。对于该插件，除非请求，否则服务器不会发送公钥。对于未使用该插件进行身份验证的帐户，此选项将被忽略。如果不使用基于 RSA 的密码交换，它也会被忽略，例如客户端使用安全连接连接到服务器的情况。

    如果[`--server-public-key-path=*`文件名`*`](mysql-upgrade.html#option_mysql_upgrade_server-public-key-path)给出并指定一个有效的公钥文件，它优先于[`--get-server-public-key`](mysql-upgrade.html#option_mysql_upgrade_get-server-public-key).

    有关信息`cache_sha2_password`插件，见[第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”](caching-sha2-pluggable-authentication.html).

-   [](<>) [`--主机=*`主机名`*`](mysql-upgrade.html#option_mysql_upgrade_host),`-h *`主机名`*`

    [](<>)[](<>)

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

-   [](<>) [`--登录路径=*`姓名`*`](mysql-upgrade.html#option_mysql_upgrade_login-path)

    [](<>)[](<>)

    从命名登录路径中读取选项`.mylogin.cnf`登录路径文件。“登录路径”是一个选项组，其中包含指定要连接到哪个 MySQL 服务器以及要作为哪个帐户进行身份验证的选项。要创建或修改登录路径文件，请使用[**mysql\_配置\_编辑**](mysql-config-editor.html)效用。看[第 4.6.7 节，“mysql\_配置\_编辑器 — MySQL 配置实用程序”](mysql-config-editor.html).

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--max-allowed-packet=*`价值`*`](mysql-upgrade.html#option_mysql_upgrade_max-allowed-packet)

    [](<>)[](<>)

    客户端/服务器通信的缓冲区的最大大小。默认值为 24MB。最小值和最大值分别为 4KB 和 2GB。

-   [](<>) [`--net-buffer-length=*`价值`*`](mysql-upgrade.html#option_mysql_upgrade_net-buffer-length)

    [](<>)[](<>)

    用于客户端/服务器通信的缓冲区的初始大小。默认值为 1MB - 1KB。最小值和最大值分别为 4KB 和 16MB。

-   [](<>) [`--no-defaults`](mysql-upgrade.html#option_mysql_upgrade_no-defaults)

    [](<>)[](<>)

    不要读取任何选项文件。如果由于从选项文件中读取未知选项而导致程序启动失败，[`--no-defaults`](mysql-upgrade.html#option_mysql_upgrade_no-defaults)可以用来防止它们被读取。

    唯一的例外是`.mylogin.cnf`如果文件存在，则在所有情况下都会读取文件。这允许以比在命令行上更安全的方式指定密码，即使在[`--no-defaults`](mysql-upgrade.html#option_mysql_upgrade_no-defaults)用来。创造`.mylogin.cnf`， 使用[**mysql\_配置\_编辑**](mysql-config-editor.html)效用。看[第 4.6.7 节，“mysql\_配置\_编辑器 — MySQL 配置实用程序”](mysql-config-editor.html).

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--密码[=*`密码`*]`](mysql-upgrade.html#option_mysql_upgrade_password),`-p[*`密码`*]`

    [](<>)[](<>)

    用于连接服务器的 MySQL 帐户的密码。密码值是可选的。如果不给，[**mysql\_升级**](mysql-upgrade.html)提示一个。如果给出，必须有*没有空间*之间[`--密码=`](mysql-upgrade.html#option_mysql_upgrade_password)要么`-p`和它后面的密码。如果未指定密码选项，则默认为不发送密码。

    在命令行上指定密码应该被认为是不安全的。为避免在命令行上提供密码，请使用选项文件。看[第 6.1.2.1 节，“最终用户密码安全指南”](password-security-user.html).

    明确指定没有密码并且[**mysql\_升级**](mysql-upgrade.html)不应该提示输入一个，使用[`--跳过密码`](mysql-upgrade.html#option_mysql_upgrade_password)选项。

-   [](<>) [`- 管道`](mysql-upgrade.html#option_mysql_upgrade_pipe),`-W`

    [](<>)[](<>)

    在 Windows 上，使用命名管道连接到服务器。此选项仅适用于服务器以[`命名管道`](server-system-variables.html#sysvar_named_pipe)启用系统变量以支持命名管道连接。此外，建立连接的用户必须是由指定的 Windows 组的成员[`named_pipe_full_access_group`](server-system-variables.html#sysvar_named_pipe_full_access_group)系统变量。

-   [](<>) [`--插件目录=*`目录名`*`](mysql-upgrade.html#option_mysql_upgrade_plugin-dir)

    [](<>)[](<>)

    查找插件的目录。指定此选项，如果[`--default-auth`](mysql-upgrade.html#option_mysql_upgrade_default-auth)选项用于指定身份验证插件，但[**mysql\_升级**](mysql-upgrade.html)没有找到它。看[第 6.2.17 节，“可插拔身份验证”](pluggable-authentication.html).

-   [](<>) [`--端口=*`端口号`*`](mysql-upgrade.html#option_mysql_upgrade_port),`-P *`端口号`*`

    [](<>)[](<>)

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

-   [](<>) [`--打印默认值`](mysql-upgrade.html#option_mysql_upgrade_print-defaults)

    [](<>)[](<>)

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

-   [](<>) [`--protocol={TCP|SOCKET|管道|内存}`](mysql-upgrade.html#option_mysql_upgrade_protocol)

    [](<>)[](<>)

    用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时，它很有用。有关允许值的详细信息，请参见[第 4.2.7 节，“连接传输协议”](transport-protocols.html).

-   [](<>) [`--server-public-key-path=*`文件名`*`](mysql-upgrade.html#option_mysql_upgrade_server-public-key-path)

    [](<>)[](<>)

    PEM 格式的文件的路径名，其中包含服务器基于 RSA 密钥对的密码交换所需的公钥的客户端副本。此选项适用于通过`sha256_password`要么`cache_sha2_password`身份验证插件。对于未使用这些插件之一进行身份验证的帐户，此选项将被忽略。如果不使用基于 RSA 的密码交换，它也会被忽略，例如客户端使用安全连接连接到服务器的情况。

    如果[`--server-public-key-path=*`文件名`*`](mysql-upgrade.html#option_mysql_upgrade_server-public-key-path)给出并指定一个有效的公钥文件，它优先于[`--get-server-public-key`](mysql-upgrade.html#option_mysql_upgrade_get-server-public-key).

    为了`sha256_password`, 此选项仅适用于使用 OpenSSL 构建 MySQL 的情况。

    有关信息`sha256_password`和`cache_sha2_password`插件，见[第 6.4.1.3 节，“SHA-256 可插入身份验证”](sha256-pluggable-authentication.html)， 和[第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”](caching-sha2-pluggable-authentication.html).

-   [](<>) [`--shared-memory-base-name=*`姓名`*`](mysql-upgrade.html#option_mysql_upgrade_shared-memory-base-name)

    [](<>)[](<>)

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

    此选项仅适用于服务器以[`共享内存`](server-system-variables.html#sysvar_shared_memory)启用系统变量以支持共享内存连接。

-   [](<>) [`--skip-sys-模式`](mysql-upgrade.html#option_mysql_upgrade_skip-sys-schema)

    [](<>)[](<>)

    默认，[**mysql\_升级**](mysql-upgrade.html)安装`系统`如果未安装 schema，则将其升级到当前版本。这[`--skip-sys-模式`](mysql-upgrade.html#option_mysql_upgrade_skip-sys-schema)选项会抑制这种行为。

-   [](<>) [`--socket=*`小路`*`](mysql-upgrade.html#option_mysql_upgrade_socket),`-S *`小路`*`

    [](<>)[](<>)

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

    在 Windows 上，此选项仅在服务器以[`命名管道`](server-system-variables.html#sysvar_named_pipe)启用系统变量以支持命名管道连接。此外，建立连接的用户必须是由指定的 Windows 组的成员[`named_pipe_full_access_group`](server-system-variables.html#sysvar_named_pipe_full_access_group)系统变量。

-   [](<>) `--ssl*`

    [](<>)[](<>)

    开头的选项`--ssl`指定是否使用加密连接到服务器并指示在哪里可以找到 SSL 密钥和证书。看[加密连接的命令选项](connection-options.html#encrypted-connection-options).

-   [](<>) [`--ssl-fips-mode={OFF|ON|STRICT}`](mysql-upgrade.html#option_mysql_upgrade_ssl-fips-mode)

    [](<>)[](<>)

    控制是否在客户端启用 FIPS 模式。这[`--ssl-fips-模式`](mysql-upgrade.html#option_mysql_upgrade_ssl-fips-mode)选项不同于其他`--ssl-*`xxx`*`选项，因为它不用于建立加密连接，而是影响允许哪些加密操作。看[第 6.8 节，“FIPS 支持”](fips-mode.html).

    这些[`--ssl-fips-模式`](mysql-upgrade.html#option_mysql_upgrade_ssl-fips-mode)允许的值：

    -   `离开`：禁用 FIPS 模式。

    -   `在`：启用 FIPS 模式。

    -   `严格的`：启用“严格”FIPS 模式。

    笔记

    如果 OpenSSL FIPS 对象模块不可用，则唯一允许的值为[`--ssl-fips-模式`](mysql-upgrade.html#option_mysql_upgrade_ssl-fips-mode)是`离开`.在这种情况下，设置[`--ssl-fips-模式`](mysql-upgrade.html#option_mysql_upgrade_ssl-fips-mode)到`在`要么`严格的`导致客户端在启动时产生警告并在非 FIPS 模式下运行。

-   [](<>) [`--tls-ciphersuites=*`密码套件列表`*`](mysql-upgrade.html#option_mysql_upgrade_tls-ciphersuites)

    [](<>)[](<>)

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

    此选项是在 MySQL 8.0.16 中添加的。

-   [](<>) [`--tls-版本=*`协议列表`*`](mysql-upgrade.html#option_mysql_upgrade_tls-version)

    [](<>)[](<>)

    加密连接的允许 TLS 协议。该值是一个或多个逗号分隔的协议名称的列表。可以为此选项命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参阅[第 6.3.2 节，“加密连接 TLS 协议和密码”](encrypted-connection-protocols-ciphers.html).

-   [](<>) [`--升级系统表`](mysql-upgrade.html#option_mysql_upgrade_upgrade-system-tables),`-s`

    [](<>)[](<>)

    只升级系统表`mysql`架构，不要升级用户架构。

-   [](<>) [`--用户=*`用户名`*`](mysql-upgrade.html#option_mysql_upgrade_user),`-u *`用户名`*`

    [](<>)[](<>)

    用于连接到服务器的 MySQL 帐户的用户名。默认用户名是`根`.

-   [](<>) [`--详细`](mysql-upgrade.html#option_mysql_upgrade_verbose)

    [](<>)[](<>)

    详细模式。打印有关程序功能的更多信息。

-   [](<>) [`--版本检查`](mysql-upgrade.html#option_mysql_upgrade_version-check),`-k`

    [](<>)[](<>)

    检查服务器的版本[**mysql\_升级**](mysql-upgrade.html)正在连接以验证它是否与要连接的版本相同[**mysql\_升级**](mysql-upgrade.html)被建。如果不，[**mysql\_升级**](mysql-upgrade.html)出口。默认情况下，此选项处于启用状态；要禁用该检查，请使用`--跳过版本检查`.

-   [](<>) [`--写binlog`](mysql-upgrade.html#option_mysql_upgrade_write-binlog)

    [](<>)[](<>)

    默认情况下，二进制日志由[**mysql\_升级**](mysql-upgrade.html)它是残疾的。使用[`--写binlog`](mysql-upgrade.html#option_mysql_upgrade_write-binlog)如果希望将其操作写入二进制日志。

    当服务器在启用全局事务标识符（GTID）的情况下运行时([`gtid_模式=开启`](replication-options-gtids.html#sysvar_gtid_mode))，不通过[**mysql\_升级**](mysql-upgrade.html).

-   [](<>) [`--压缩级别=*`数量`*`](mysql-upgrade.html#option_mysql_upgrade_zstd-compression-level)

    [](<>)[](<>)

    用于连接到使用`zstd`压缩算法。允许的水平从1到22，较大的值表示压缩水平增加。默认值`zstd`压缩级别为3。压缩级别设置对不使用压缩级别的连接没有影响`zstd`压缩。

    有关更多信息，请参阅[第4.2.8节，“连接压缩控制”](connection-compression-control.html).

    这个选项是在MySQL 8.0.18中添加的。
