4.4.7 mysql_upgrade-检查和升级 MySQLtable

每次升级 MySQL 时，都应执行mysql_upgrade，以查找与已升级的 MySQL 服务器不兼容的情况：

• 它将升级mysql模式中的系统 table，以便您可以利用可能已添加的新特权或功能。

• 它将升级性能架构和sys架构。

• 它检查用户架构。

如果mysql_upgrade发现 table 可能不兼容，它将执行 table 检查，如果发现问题，则尝试 table 修复。如果 table 无法修复，请参见第 2.11.12 节，“重建或修复 table 或索引”了解手动 table 修复策略。

mysql_upgrade直接与 MySQL 服务器通信，向其发送执行升级所需的 SQL 语句。

像这样使用mysql_upgrade：

• 确保服务器正在运行。

• 调用mysql_upgrade升级mysql架构中的系统 table 并检查和修复其他架构中的 table：

shell> mysql_upgrade [options]

• 停止服务器并重新启动它，以便任何系统 table 更改均生效。

如果要升级多个 MySQL 服务器实例，请使用适合于连接到每个所需服务器的连接参数调用mysql_upgrade。例如，对于在 3306 至 3308 部分上的 localhost 上运行的服务器，通过连接到适当的端口来升级它们中的每一个：

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

对于 Unix 上的 localhost 连接，--protocol=tcp选项强制使用 TCP/IP 而不是 Unix 套接字文件进行连接。

默认情况下，mysql_upgrade以 MySQL root用户身份运行。如果在运行mysql_upgrade时root密码已过期，则会看到一条消息，提示您的密码已过期并且mysql_upgrade失败。要解决此问题，请重置root密码以使其失效，然后再次运行mysql_upgrade。首先，以root的身份连接到服务器：

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

使用ALTER USER重设密码：

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

然后退出mysql并再次运行mysql_upgrade：

shell> mysql_upgrade [options]

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

除非使用--upgrade-system-tables选项调用，否则mysql_upgrade会根据需要处理所有用户模式中的所有 table。table 检查可能需要很长时间才能完成。每个 table 都被锁定，因此在处理它时其他会话无法使用。检查和修复操作可能很耗时，特别是对于大桌子。table 检查使用CHECK TABLE语句的FOR UPGRADE选项。有关此选项需要执行的操作的详细信息，请参见第 13.7.2.2 节“ CHECK TABLE 语句”。

mysql_upgrade使用当前的 MySQL 版本号标记所有已检查和已修复的 table。这样可以确保下次使用相同版本的服务器运行mysql_upgrade时，可以确定是否需要再次检查或修复给定的 table。

mysql_upgrade将 MySQL 版本号保存在数据目录中名为mysql_upgrade_info的文件中。这用于快速检查是否已为此发行版检查所有 table，以便可以跳过 table 检查。要忽略此文件并执行检查，请使用--force选项。

mysql_upgrade检查mysql.user系统 table 行，对于plugin列为空的任何行，根据Password列值的哈希格式将其设置为'mysql_native_password'或'mysql_old_password'。

删除了对 4.1 之前的密码哈希和mysql_old_password的支持，因此如果凭据使用与该插件兼容的哈希格式，则mysql_upgrade将空plugin值设置为'mysql_native_password'。具有 4.1 之前的密码哈希的行必须手动升级。有关帐户升级的说明，请参见第 6.4.1.3 节“迁移到 4.1 版之前的密码哈希和 mysql_old_password 插件”。

mysql_upgrade不会升级时区 table 或帮助 table 的内容。有关升级说明，请参见第 5.1.13 节“ MySQL 服务器时区支持”和第 5.1.14 节“服务器端帮助支持”。

除非使用--skip-sys-schema选项调用，否则mysql_upgrade将安装sys模式(如果未安装)，否则将其升级到当前版本。如果存在sys模式但没有version视图，则会发生错误，并假设其不存在 table 示用户创建的模式：

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.

要在这种情况下进行升级，请首先删除或重命名现有的sys模式。

mysql_upgrade检查使用通用分区处理程序创建的InnoDB分区 table，并尝试将其升级到InnoDB本机分区。 (缺陷号#76734，错误号#20727344)您可以使用ALTER TABLE ...升级分区 SQL 语句在mysqlClient 端中分别升级此类 table。

mysql_upgrade支持以下选项，可以在命令行或选项文件的[mysql_upgrade]和[client]组中指定这些选项。有关 MySQL 程序使用的选项文件的信息，请参见第 4.2.2.2 节“使用选项文件”。

table4.11 mysql_upgrade 选项

• --help

显示简短帮助消息并退出。

• --bind-address=ip_address

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

• --character-sets-dir=dir_name

字符集的安装目录。参见第 10.15 节“字符集配置”。

• --compress, -C

尽可能压缩 Client 端和服务器之间发送的所有信息。参见第 4.2.6 节“连接压缩控制”。

• --debug[=debug_options], -# [debug_options]

编写调试日志。典型的* debug_options *字符串是d:t:o,file_name。默认值为d:t:O,/tmp/mysql_upgrade.trace。

• --debug-check

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

• --debug-info, -T

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

• --default-auth=plugin

有关使用哪个 Client 端身份验证插件的提示。参见第 6.2.13 节“可插入身份验证”。

• --default-character-set=charset_name

使用* charset_name *作为默认字符集。参见第 10.15 节“字符集配置”。

• --defaults-extra-file=file_name

在全局选项文件之后但在用户选项文件之前(在 Unix 上)读取此选项文件。如果该文件不存在或无法访问，则发生错误。 * file_name *如果是相对路径名而不是完整路径名，则相对于当前目录进行解释。

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

• --defaults-file=file_name

仅使用给定的选项文件。如果该文件不存在或无法访问，则发生错误。 * file_name *如果是相对路径名而不是完整路径名，则相对于当前目录进行解释。

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

• --defaults-group-suffix=str

不仅阅读常规选项组，还阅读具有常规名称和后缀* str *的组。例如，mysql_upgrade通常读取[client]和[mysql_upgrade]组。如果提供了--defaults-group-suffix=_other选项，则mysql_upgrade也会读取[client_other]和[mysql_upgrade_other]组。

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

• --force

即使已针对当前版本的 MySQL 执行了mysql_upgrade，也将忽略mysql_upgrade_info文件并强制执行。

• --host=host_name, -h host_name

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

• --login-path=name

从.mylogin.cnf登录路径文件中的命名登录路径中读取选项。 “登录路径”是一个选项组，其中包含一些选项，这些选项指定要连接到哪个 MySQL 服务器以及要作为身份验证的帐户。要创建或修改登录路径文件，请使用mysql_config_editorUtil。参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”。

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

• --max-allowed-packet=value

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

• --net-buffer-length=value

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

• --no-defaults

不要读取任何选项文件。如果由于从选项文件中读取未知选项而导致程序启动失败，则可以使用--no-defaults来防止读取它们。

exception 是在所有情况下都读取.mylogin.cnf文件(如果存在)。这样即使在使用--no-defaults的情况下，也可以通过比命令行更安全的方式指定密码。 (.mylogin.cnf由mysql_config_editorUtil 创建。请参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”。)

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

• --password[=password], -p[password]

用于连接服务器的 MySQL 帐户的密码。密码值是可选的。如果未给出，mysql_upgrade提示 Importing 一个。如果提供，则--password=或-p与后面的密码之间必须没有空格。如果未指定密码选项，则默认为不发送密码。

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

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

• --pipe, -W

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

• --plugin-dir=dir_name

在其中查找插件的目录。如果--default-auth选项用于指定身份验证插件，但mysql_upgrade找不到它，请指定此选项。参见第 6.2.13 节“可插入身份验证”。

• --port=port_num, -P port_num

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

• --print-defaults

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

• --protocol={TCP|SOCKET|PIPE|MEMORY}

用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时，此功能很有用。有关允许值的详细信息，请参见第 4.2.5 节“连接传输协议”。

• --shared-memory-base-name=name

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

仅当在启用了shared_memory系统变量以支持共享内存连接的情况下启动服务器时，此选项才适用。

• --skip-sys-schema

默认情况下，mysql_upgrade安装sys模式(如果未安装)，否则将其升级到当前版本。 --skip-sys-schema选项禁止此行为。

• --socket=path, -S path

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

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

• --ssl*

以--ssl开头的选项指定是否使用 SSL 连接到服务器，并指示在何处查找 SSL 密钥和证书。参见加密连接的命令选项。

• --tls-version=protocol_list

加密连接允许的 TLS 协议。该值是一个或多个逗号分隔的协议名称的列 table。可以为此选项命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参见第 6.3.2 节“加密的连接 TLS 协议和密码”。

MySQL 5.7.10 中添加了此选项。

• --upgrade-system-tables, -s

仅升级mysql模式中的系统 table，不升级用户模式。

• --user=user_name, -u user_name

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

• --verbose

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

• --version-check, -k

检查mysql_upgrade所连接的服务器的版本，以验证它与构建mysql_upgrade的服务器的版本相同。如果不是，则mysql_upgrade退出。默认情况下启用此选项。要禁用检查，请使用--skip-version-check。

• --write-binlog

默认情况下，禁用mysql_upgrade的二进制日志记录。如果希望将其动作写入二进制日志，请使用--write-binlog调用该程序。

当服务器在启用全局事务标识符(GTID)的情况下(gtid_mode=ON)运行时，请勿通过mysql_upgrade启用二进制日志记录。