每次升级 MySQL 时,都应该执行 mysql_upgrade,它会查找与升级后的 MySQL 服务器的不兼容性:
它升级
mysql
模式中的系统表,以便您可以利用可能已添加的新特权或功能。它升级了性能模式。
它检查用户模式。
如果mysql_upgrade发现一个表可能不兼容,它会执行表检查,如果发现问题,则尝试修复表。如果表无法修复,请参阅第 2.11.10 节“重建或修复表或索引”以了解手动表修复策略。
如果在 Linux 上从 RPM 包安装 MySQL,则必须安装服务器和客户端 RPM。 mysql_upgrade包含在服务器 RPM 中,但需要客户端 RPM,因为后者包含 mysqlcheck。(参见 第 2.5.5 节,“使用来自 Oracle 的 RPM 包在 Linux 上安装 MySQL”。)
在 Windows 上,您必须以管理员权限运行mysql_upgrade 。您可以通过以管理员身份运行命令提示符并运行命令来执行此操作。否则可能会导致升级无法正确执行。
在执行升级之前 ,您应该始终备份当前的 MySQL 安装 。请参阅 第 7.2 节,“数据库备份方法”。
在升级 MySQL 安装和运行mysql_upgrade之前, 一些升级不兼容性可能需要特殊处理 。请参阅 第 2.11 节,“升级 MySQL”,以获取有关确定任何此类不兼容性是否适用于您的安装以及如何处理它们的说明。
像这样使用mysql_upgrade:
确保服务器正在运行。
调用mysql_upgrade升级schema中的系统表,
mysql
检查修复其他schema中的表:mysql_upgrade [options]
停止服务器并重新启动它以使任何系统表更改生效。
如果您有多个 MySQL 服务器实例要升级, 请使用适合连接到每个所需服务器的连接参数调用mysql_upgrade 。例如,对于在 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 上的本地主机连接,该
--protocol=tcp
选项强制使用 TCP/IP 而不是 Unix 套接字文件进行连接。
默认情况下,mysql_upgrade作为 MySQL
root
用户运行。如果在root
运行
mysql_upgrade时密码已过期,您应该会看到一条消息,表明您的密码已过期并且
mysql_upgrade 因此失败。要更正此问题,请重置root
密码以取消其有效期并再次运行mysql_upgrade:
$> mysql -u root -p
Enter password: **** <- enter root password here
mysql> SET PASSWORD = PASSWORD('root-password');
mysql> quit
$> mysql_upgrade [options]
mysql_upgrade执行以下命令来检查和修复表以及升级系统表:
mysqlcheck --no-defaults --databases
--fix-db-names --fix-table-names mysql
mysqlcheck --no-defaults --check-upgrade --databases
--auto-repair mysql
mysql < fix_priv_tables
mysqlcheck --no-defaults --all-databases
--skip-database=mysql --fix-db-names --fix-table-names
mysqlcheck --no-defaults --check-upgrade --all-databases
--skip-database=mysql --auto-repair
上述命令注意事项:
mysql_upgrade还 向mysqlcheck
--write-binlog
命令添加或 ,具体取决于是否在 mysql_upgrade命令上指定了该选项 。--skip-write-binlog
--write-binlog
除非使用该
--upgrade-system-tables
选项调用,否则mysql_upgrade 会根据需要处理所有用户模式中的所有表。表检查可能需要很长时间才能完成。每个表都被锁定,因此在处理时对其他会话不可用。检查和修复操作可能很耗时,尤其是对于大型表。表检查使用带有 and 选项的mysqlcheck 。蕴含什么 ,详见 声明中 选项的描述--all-databases
--check-upgrade
--check-upgrade
FOR UPGRADE
CHECK TABLE
第 13.7.2.2 节,“CHECK TABLE 语句”。fix_priv_tables
表示由 mysql_upgrade内部生成的脚本,其中包含用于升级数据库中的表的 SQL 语句mysql
。
mysql_upgrade用当前 MySQL 版本号标记所有检查和修复的表。这确保下次您使用相同版本的服务器运行mysql_upgrade时,可以确定是否需要再次检查或修复给定的表。
mysql_upgrade将 MySQL 版本号保存在mysql_upgrade_info
数据目录中命名的文件中。这用于快速检查是否已检查此版本的所有表,以便可以跳过表检查。要忽略此文件并执行检查,请使用该--force
选项。
mysql_upgrade不升级时区表或帮助表的内容。有关升级说明,请参阅第 5.1.13 节,“MySQL 服务器时区支持”和 第 5.1.14 节,“服务器端帮助支持”。
mysql_upgrade支持以下选项,可以在命令行或
选项文件的组中指定[mysql_upgrade]
。
[client]
无法识别的选项被传递给
mysqlcheck。有关选项文件的信息,请参阅第 4.2.2.2 节,“使用选项文件”。
表 4.9 mysql_upgrade 选项
选项名称 | 描述 | 介绍 |
---|---|---|
--basedir | 不曾用过 | |
--字符集目录 | 安装字符集的目录 | |
- 压缩 | 压缩客户端和服务器之间发送的所有信息 | |
--数据目录 | 不曾用过 | |
--调试 | 写调试日志 | |
--调试检查 | 程序退出时打印调试信息 | |
- 调试信息 | 程序退出时打印调试信息、内存和 CPU 统计信息 | |
--default-auth | 要使用的身份验证插件 | |
--默认字符集 | 指定默认字符集 | |
--defaults-extra-file | 除了通常的选项文件外,还读取命名的选项文件 | |
--defaults-文件 | 只读命名选项文件 | |
--defaults-group-suffix | 选项组后缀值 | |
- 力量 | 即使已经为当前 MySQL 版本执行了 mysql_upgrade,也强制执行 | |
- 帮助 | 显示帮助信息并退出 | |
- 主持人 | MySQL 服务器所在的主机 | |
--登录路径 | 从 .mylogin.cnf 读取登录路径选项 | |
--no-defaults | 不读取选项文件 | |
- 密码 | 连接到服务器时使用的密码 | |
- 管道 | 使用命名管道连接到服务器(仅限 Windows) | |
--插件目录 | 安装插件的目录 | |
- 港口 | 用于连接的 TCP/IP 端口号 | |
--print-defaults | 打印默认选项 | |
- 协议 | 使用的传输协议 | |
--shared-memory-base-name | 共享内存连接的共享内存名称(仅限 Windows) | |
- 插座 | 要使用的 Unix 套接字文件或 Windows 命名管道 | |
--ssl | 启用连接加密 | |
--ssl-ca | 包含可信 SSL 证书颁发机构列表的文件 | |
--ssl-capath | 包含受信任的 SSL 证书颁发机构证书文件的目录 | |
--ssl证书 | 包含 X.509 证书的文件 | |
--ssl密码 | 连接加密的允许密码 | |
--ssl-crl | 包含证书吊销列表的文件 | |
--ssl-crlpath | 包含证书吊销列表文件的目录 | |
--ssl-密钥 | 包含 X.509 密钥的文件 | |
--ssl模式 | 连接到服务器的所需安全状态 | 5.6.30 |
--ssl-verify-server-cert | 根据服务器证书公用名身份验证主机名 | |
--tmpdir | 临时文件目录 | |
--升级系统表 | 只更新系统表,不更新用户模式 | |
- 用户 | 连接到服务器时使用的 MySQL 用户名 | |
--冗长 | 详细模式 | |
--版本检查 | 检查正确的服务器版本 | 5.6.12 |
--write-binlog | 将所有语句写入二进制日志 |
显示一条简短的帮助消息并退出。
MySQL 安装目录的路径。接受此选项以实现向后兼容性但被忽略。它在 MySQL 5.7 中被删除。
安装字符集的目录。请参阅 第 10.15 节,“字符集配置”。
如果可能,压缩客户端和服务器之间发送的所有信息。请参阅 第 4.2.6 节,“连接压缩控制”。
数据目录的路径。接受此选项以实现向后兼容性但被忽略。它在 MySQL 5.7 中被删除。
--debug[=
,debug_options
]-# [
debug_options
]写调试日志。典型的
debug_options
字符串是 . 默认值为 。d:t:o,
file_name
d:t:O,/tmp/mysql_upgrade.trace
程序退出时打印一些调试信息。
--debug-info
,-T
程序退出时打印调试信息以及内存和 CPU 使用统计信息。
关于使用哪个客户端身份验证插件的提示。请参阅第 6.2.11 节,“可插入身份验证”。
--default-character-set=
charset_name
用作
charset_name
默认字符集。请参阅第 10.15 节,“字符集配置”。--defaults-extra-file=
file_name
在全局选项文件之后但(在 Unix 上)在用户选项文件之前读取此选项文件。如果该文件不存在或无法访问,则会发生错误。如果
file_name
不是绝对路径名,则将其解释为相对于当前目录。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
仅使用给定的选项文件。如果该文件不存在或无法访问,则会发生错误。如果
file_name
不是绝对路径名,则将其解释为相对于当前目录。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
不仅要阅读通常的选项组,还要阅读具有通常名称和后缀
str
. 例如, mysql_upgrade通常会读取[client]
和[mysql_upgrade]
组。如果此选项作为 给出--defaults-group-suffix=_other
, mysql_upgrade还会读取[client_other]
和[mysql_upgrade_other]
组。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
mysql_upgrade_info
即使已经为当前版本的 MySQL 执行了 mysql_upgrade ,也 忽略该文件并强制执行。--host=
,host_name
-h
host_name
连接到给定主机上的 MySQL 服务器。
从登录路径文件中指定的登录路径读取选项
.mylogin.cnf
。“ 登录路径”是一个选项组,其中包含指定要连接到哪个 MySQL 服务器以及要以哪个帐户进行身份验证的选项。要创建或修改登录路径文件,请使用 mysql_config_editor实用程序。请参阅 第 4.6.6 节,“mysql_config_editor — MySQL 配置实用程序”。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
不要读取任何选项文件。如果程序启动因从选项文件中读取未知选项而失败,
--no-defaults
可用于防止它们被读取。例外情况是
.mylogin.cnf
文件在所有情况下都会被读取(如果存在)。这允许以比在命令行上更安全的方式指定密码,即使在--no-defaults
使用 时也是如此。要创建.mylogin.cnf
,请使用 mysql_config_editor实用程序。请参阅 第 4.6.6 节,“mysql_config_editor — MySQL 配置实用程序”。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
--password[=
,password
]-p[
password
]用于连接到服务器的 MySQL 帐户的密码。密码值是可选的。如果没有给出, mysql_upgrade会提示输入一个。如果给定,则后面 的密码之间 不能有空格。如果未指定密码选项,则默认为不发送密码。
--password=
-p
在命令行上指定密码应该被认为是不安全的。为避免在命令行中提供密码,请使用选项文件。请参阅 第 6.1.2.1 节,“密码安全的最终用户指南”。
要明确指定没有密码并且 mysql_upgrade不应提示输入密码,请使用该
--skip-password
选项。--pipe
,-W
在 Windows 上,使用命名管道连接到服务器。仅当服务器启动时
named_pipe
启用了支持命名管道连接的系统变量时,此选项才适用。此外,进行连接的用户必须是named_pipe_full_access_group
系统变量指定的 Windows 组的成员。在其中查找插件的目录。如果该
--default-auth
选项用于指定身份验证插件但 mysql_upgrade未找到它,请指定此选项。请参阅 第 6.2.11 节,“可插入身份验证”。--port=
,port_num
-P
port_num
对于 TCP/IP 连接,要使用的端口号。
打印程序名称和它从选项文件中获取的所有选项。
有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
--protocol={TCP|SOCKET|PIPE|MEMORY}
用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时,它很有用。有关允许值的详细信息,请参阅 第 4.2.5 节“连接传输协议”。
--shared-memory-base-name=
name
在 Windows 上,用于使用共享内存与本地服务器建立连接的共享内存名称。默认值为
MYSQL
。共享内存名称区分大小写。仅当服务器启动时
shared_memory
启用了支持共享内存连接的系统变量时,此选项才适用。--socket=
,path
-S
path
对于与 的连接
localhost
,要使用的 Unix 套接字文件,或者在 Windows 上,要使用的命名管道的名称。在 Windows 上,仅当服务器启动时
named_pipe
启用了支持命名管道连接的系统变量时,此选项才适用。此外,进行连接的用户必须是named_pipe_full_access_group
系统变量指定的 Windows 组的成员。以 开头的选项
--ssl
指定是否使用加密连接到服务器并指示在哪里可以找到 SSL 密钥和证书。请参阅 加密连接的命令选项。--tmpdir=
,dir_name
-t
dir_name
用于创建临时文件的目录的路径名。
仅升级架构中的系统表
mysql
,不升级用户架构。--user=
,user_name
-u
user_name
用于连接到服务器的 MySQL 帐户的用户名。默认用户名为
root
。详细模式。打印有关程序功能的更多信息。
--version-check
,-k
检查 mysql_upgrade连接到的服务器的版本以验证它与 mysql_upgrade构建的版本相同。如果不是, mysql_upgrade退出。默认情况下启用此选项;要禁用检查,请使用
--skip-version-check
. 这个选项是在 MySQL 5.6.12 中添加的。导致在 mysql_upgrade运行时启用二进制日志记录。在 MySQL 5.6.6 及更早版本中,这是默认行为。(要在升级期间禁用二进制日志记录,有必要使用此选项的反函数,通过使用启动程序
--skip-write-binlog
。)从 MySQL 5.6.7 开始,默认情况下禁用mysql_upgrade的二进制日志记录(错误#14221043)。--write-binlog
如果您希望将其操作写入二进制日志,请显式调用该程序。(同样从 MySQL 5.6.7 开始,该--skip-write-binlog
选项实际上什么都不做。)当服务器在启用全局事务标识符 (GTID) 的情况下运行时 (
gtid_mode=ON
),不要通过mysql_upgrade启用二进制日志记录。