4.4.5 mysql_upgrade —检查和升级MySQL表

注意

从MySQL 8.0.16开始，MySQL服务器执行以前由mysql_upgrade处理的升级任务 （有关详细信息，请参见 第2.11.3节“ MySQL升级过程将进行哪些升级”）。因此， 从该版本开始，不再需要mysql_upgrade并已弃用；希望在将来的MySQL版本中将其删除。由于mysql_upgrade不再执行升级任务，因此它无条件退出，状态为0。

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

• 它将升级mysql架构中的系统表， 以便您可以利用可能已添加的新特权或功能。
• 它将升级性能架构 INFORMATION_SCHEMA，和 sys架构。
• 它检查用户架构。

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

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

警告

执行升级之前， 应始终备份当前的MySQL安装 。请参见 第7.2节“数据库备份方法”。

在升级MySQL安装并运行mysql_upgrade之前， 某些升级不兼容性可能需要特殊处理 。请参见 第2.11节“升级MySQL”，以获取有关确定是否存在此类不兼容性以及如何处理这些不兼容问题的说明。

像这样 使用mysql_upgrade：

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

2. 调用mysql_upgrade升级mysql模式中的系统表，并检查和修复其他模式中的表：

   shell> mysql_upgrade [options]
   

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

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

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上的本地主机连接，该 --protocol=tcp选项强制使用TCP / IP而不是Unix套接字文件进行连接。

默认情况下，mysql_upgrade以MySQLroot用户身份运行 。如果在root 运行mysql_upgrade时密码已过期 ，则会显示一条消息，提示您密码已过期，并且 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]

注意

如果在disabled_storage_engines 系统变量设置为禁用某些存储引擎的情况下运行服务器 （例如MyISAM），则 mysql_upgrade可能会失败，并显示如下错误：

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

要解决此问题，请在disabled_storage_engines 禁用的情况下重新启动服务器 。然后，您应该能够成功运行 mysql_upgrade。此后，将服务器重新 disabled_storage_engines设置为其原始值。

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

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

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

注意

该mysql_upgrade_info文件已弃用；希望在将来的MySQL版本中将其删除。

mysql_upgrade检查 mysql.user系统表行，对于任何具有空plugin列的行，将其设置'mysql_native_password'为凭据是否使用与该插件兼容的哈希格式。具有4.1之前的密码哈希值的行必须手动升级。

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

除非使用该--skip-sys-schema选项调用，否则 mysql_upgrade将安装该sys模式（如果未安装该模式）， 否则将其 升级到当前版本。如果sys存在一个架构但没有 version视图，那么会发生错误，并假设该架构的缺失表示用户创建的架构：

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

表4.10 mysql_upgrade选项

• --help

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

• --bind-address=*ip_address*

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

• --character-sets-dir=*dir_name*

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

• --compress， -C

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

  从MySQL 8.0.18开始，此选项已被弃用。希望在将来的MySQL版本中将其删除。请参阅 配置旧版连接压缩。

• --compression-algorithms=*value*

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

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

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

• --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*

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

• --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_upgrade_info即使已经针对当前版本的MySQL执行了mysql_upgrade，也 忽略该文件并强制执行。

• --get-server-public-key

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

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

  有关caching_sha2_password插件的信息 ，请参见 第6.4.1.2节“缓存SHA-2可插拔身份验证”。

• --host=*host_name*， -h *host_name*

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

• --login-path=*name*

  从.mylogin.cnf登录路径文件中的命名登录路径读取选项 。阿 “登录路径”是含有指定要连接到哪个MySQL服务器和选项哪个帐户作为认证选项组。要创建或修改登录路径文件，请使用 mysql_config_editor实用程序。请参见 第4.6.7节“ mysql_config_editor -MySQL配置实用程序”。

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

• --max-allowed-packet=*value*

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

• --net-buffer-length=*value*

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

• --no-defaults

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

  唯一的例外是，.mylogin.cnf 在所有情况下都将读取该文件（如果存在）。这样，即使--no-defaults使用密码，也可以通过比命令行更安全的方式指定密码 。（.mylogin.cnf由mysql_config_editor实用程序创建 。请参见 第4.6.7节“ mysql_config_editor -MySQL配置实用程序”。）

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

• --password[=*password*\]， -p[*password*]

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

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

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

• --pipe， -W

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

• --plugin-dir=*dir_name*

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

• --port=*port_num*， -P *port_num*

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

• --print-defaults

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

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

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

• --server-public-key-path=*file_name*

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

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

  对于sha256_password，仅当MySQL使用OpenSSL构建时，此选项才适用。

  有关sha256_password 和caching_sha2_password插件的信息，请参见 第6.4.1.3节“ SHA-256可插拔身份验证”和 第6.4.1.2节“缓存SHA-2可插拔身份验证”。

• --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密钥和证书。请参阅 加密连接的命令选项。

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

  控制是否在客户端上启用FIPS模式。该--ssl-fips-mode选项与其他选项的不同之处在于，该 选项 不用于建立加密连接，而是影响允许的加密操作。请参见第6.8节“ FIPS支持”。 --ssl-*xxx*

  这些--ssl-fips-mode 值是允许的：

  • OFF：禁用FIPS模式。
  • ON：启用FIPS模式。
  • STRICT：启用“严格” FIPS模式。

  注意

  如果OpenSSL的FIPS对象模块不可用时，对于唯一的允许值 --ssl-fips-mode是 OFF。在这种情况下，设置 --ssl-fips-mode为 ON或STRICT导致客户端在启动时发出警告并以非FIPS模式运行。

• --tls-ciphersuites=*ciphersuite_list*

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

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

• --tls-version=*protocol_list*

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

• --upgrade-system-tables， -s

  仅升级mysql架构中的系统表 ，而不升级用户架构。

• --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_mode=ON）全局事务标识符（GTID）的情况下运行时，请勿通过mysql_upgrade启用二进制日志记录。

• --zstd-compression-level=*level*

  用于与使用zstd压缩算法的服务器的连接的压缩级别。允许的级别是1到22，更大的值表示压缩级别增加。默认 zstd压缩级别为3。压缩级别设置对不使用zstd压缩的连接无效。

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

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