4.5.3 mysqlcheck —table 维护程序
mysqlcheckClient 端执行 table 维护:它检查,修复,优化或分析 table。
每个 table 都被锁定,因此在处理它时其他会话无法使用,尽管对于检查操作,该 table 仅用READ
锁锁定(有关READ
和WRITE
锁的更多信息,请参见第 13.3.5 节“ LOCK TABLES 和 UNLOCK TABLES 语句”)。table 维护操作可能很耗时,特别是对于大型 table。如果使用--databases或--all-databases选项处理一个或多个数据库中的所有 table,则mysqlcheck的调用可能会花费很长时间。 (如果 MySQL 升级过程确定需要进行 table 检查,则这也适用于 MySQL 升级过程,因为它以相同的方式处理 table.)
mysqld服务器正在运行时必须使用mysqlcheck,这意味着您不必停止服务器即可执行 table 维护。
mysqlcheck以方便用户的方式使用 SQL 语句CHECK TABLE,REPAIR TABLE,ANALYZE TABLE和OPTIMIZE TABLE。它确定要用于该操作的语句,然后将这些语句发送到要执行的服务器。有关每个语句使用哪些存储引擎的详细信息,请参见第 13.7.2 节“table 维护声明”中对这些语句的描述。
所有存储引擎不一定支持所有四个维护操作。在这种情况下,将显示错误消息。例如,如果test.t
是MEMORY
table,则尝试检查它会产生以下结果:
shell> mysqlcheck test t
test.t
note : The storage engine for the table doesn't support check
如果mysqlcheck无法修复 table,请参见第 2.11.12 节,“重建或修复 table 或索引”了解手动 table 修复策略。例如InnoDB
table 就是这种情况,可以用CHECK TABLE检查,但不能用REPAIR TABLE修复。
Caution
最好在执行 table 修复操作之前先备份 table。在某些情况下,该操作可能会导致数据丢失。可能的原因包括但不限于文件系统错误。
有三种通用的方法来调用mysqlcheck:
shell> mysqlcheck [options] db_name [tbl_name ...]
shell> mysqlcheck [options] --databases db_name ...
shell> mysqlcheck [options] --all-databases
如果未在* db_name
*之后命名任何 table,或者如果使用--databases或--all-databases选项,则将检查整个数据库。
mysqlcheck与其他 Client 端程序相比具有特殊功能。可通过重命名二进制文件来更改检查 table(--check)的默认行为。如果要使用默认情况下修复 table 的工具,则应仅复制一个名为_mysqlrepair 的mysqlcheck,或构建一个名为 mysqlrepair 的符号链接.如果调用 mysqlrepair **,它将修复 table。
下 table 中显示的名称可用于更改mysqlcheck默认行为。
Command | Meaning |
---|---|
mysqlrepair | 默认选项是--repair |
mysqlanalyze | 默认选项是--analyze |
mysqloptimize | 默认选项是--optimize |
mysqlcheck支持以下选项,可以在命令行或选项文件的[mysqlcheck]
和[client]
组中指定这些选项。有关 MySQL 程序使用的选项文件的信息,请参见第 4.2.2.2 节“使用选项文件”。
table4.14 mysqlcheck 选项
Option Name | Description | Introduced | Deprecated |
---|---|---|---|
--all-databases | 检查所有数据库中的所有 table | ||
--all-in-1 | 对每个数据库执行一个语句,该语句命名该数据库中的所有 table | ||
--analyze | 分析 table | ||
--auto-repair | 如果检查 table 已损坏,请自动修复它 | ||
--bind-address | 使用指定的网络接口连接到 MySQL Server | ||
--character-sets-dir | 字符集的安装目录 | ||
--check | 检查 table 中的错误 | ||
--check-only-changed | 仅检查自上次检查以来已更改的 table | ||
--check-upgrade | 使用 FOR UPGRADE 选项调用 CHECK TABLE | ||
--compress | 压缩 Client 端和服务器之间发送的所有信息 | ||
--databases | 将所有参数解释为数据库名称 | ||
--debug | 编写调试日志 | ||
--debug-check | 程序退出时打印调试信息 | ||
--debug-info | 程序退出时打印调试信息,内存和 CPU 统计信息 | ||
--default-auth | 身份验证插件使用 | ||
--default-character-set | 指定默认字符集 | ||
--defaults-extra-file | 除常规选项文件外,还读取命名的选项文件 | ||
--defaults-file | 只读命名的选项文件 | ||
--defaults-group-suffix | 选项组后缀值 | ||
--enable-cleartext-plugin | 启用明文身份验证插件 | 5.7.10 | |
--extended | 检查和维修 table | ||
--fast | 仅检查未正确关闭的 table | ||
--fix-db-names | 将数据库名称转换为 5.1 格式 | Yes | |
--fix-table-names | 将 table 名称转换为 5.1 格式 | Yes | |
--force | 即使发生 SQL 错误,也要 continue | ||
--get-server-public-key | 从服务器请求 RSA 公钥 | 5.7.23 | |
--help | 显示帮助信息并退出 | ||
--host | MySQL 服务器所在的主机 | ||
--login-path | 从.mylogin.cnf 中读取登录路径选项 | ||
--medium-check | 进行比--extended 操作更快的检查 | ||
--no-defaults | 不读取选项文件 | ||
--optimize | 优化 table | ||
--password | 连接服务器时使用的密码 | ||
--pipe | 使用命名管道连接到服务器(仅 Windows) | ||
--plugin-dir | 安装插件的目录 | ||
--port | 用于连接的 TCP/IP 端口号 | ||
--print-defaults | 打印默认选项 | ||
--protocol | 使用的传输协议 | ||
--quick | 最快的检查方法 | ||
--repair | 执行修复,可以修复几乎所有东西,除了不是唯一的唯一键 | ||
--secure-auth | 不要以旧(4.1 之前)格式向服务器发送密码 | Yes | |
--server-public-key-path | 包含 RSA 公钥的文件的路径名 | 5.7.23 | |
--shared-memory-base-name | 共享内存连接的共享内存名称(仅 Windows) | ||
--silent | Silent mode | ||
--skip-database | 从执行的操作中忽略此数据库 | ||
--socket | Unix 套接字文件或 Windows 命名管道使用 | ||
--ssl | 启用连接加密 | ||
--ssl-ca | 包含受信任的 SSL 证书颁发机构列 table 的文件 | ||
--ssl-capath | 包含受信任的 SSL 证书颁发机构证书文件的目录 | ||
--ssl-cert | 包含 X.509 证书的文件 | ||
--ssl-cipher | 连接加密的允许密码 | ||
--ssl-crl | 包含证书吊销列 table 的文件 | ||
--ssl-crlpath | 包含证书吊销列 table 文件的目录 | ||
--ssl-key | 包含 X.509 密钥的文件 | ||
--ssl-mode | 与服务器连接的所需安全状态 | 5.7.11 | |
--ssl-verify-server-cert | 根据服务器证书的通用名身份验证主机名 | ||
--tables | 覆盖--databases 或-B 选项 | ||
--tls-version | 允许的 TLS 协议进行加密连接 | 5.7.10 | |
--use-frm | 对于 MyISAMtable 的修复操作 | ||
--user | 连接服务器时使用的 MySQL 用户名 | ||
--verbose | Verbose mode | ||
--version | 显示版本信息并退出 | ||
--write-binlog | 将 ANALYZE,OPTIMIZE,REPAIR 语句记录到二进制日志中。 --skip-write-binlog 将 NO_WRITE_TO_BINLOG 添加到这些语句 |
- --help,
-?
显示帮助消息并退出。
- --all-databases,
-A
检查所有数据库中的所有 table。这与使用--databases选项并在命令行上命名所有数据库相同,只是不检查INFORMATION_SCHEMA
和performance_schema
数据库。可以通过使用--databases选项将其明确命名来对其进行检查。
- --all-in-1,
-1
与其对每个 table 发出一个语句,不对每个数据库执行一个语句,该语句命名该数据库中要处理的所有 table。
- --analyze,
-a
分析 table。
如果检查 table 已损坏,请自动对其进行修复。检查完所有 table 后,将进行任何必要的维修。
在具有多个网络接口的计算机上,使用此选项选择用于连接到 MySQL 服务器的接口。
字符集的安装目录。参见第 10.15 节“字符集配置”。
- --check,
-c
检查 table 中是否有错误。这是默认操作。
仅检查自上次检查以来已更改的 table 或未正确关闭的 table。
- --check-upgrade,
-g
使用FOR UPGRADE
选项调用CHECK TABLE,以检查 table 是否与服务器的当前版本不兼容。此选项自动启用--fix-db-names和--fix-table-names选项。
尽可能压缩 Client 端和服务器之间发送的所有信息。参见第 4.2.6 节“连接压缩控制”。
- --databases,
-B
处理命名数据库中的所有 table。通常,mysqlcheck将命令行上的名字参数视为数据库名称,并将其后的名称视为 table 名称。使用此选项,它将所有名称参数视为数据库名称。
- --debug[=debug_options],
-# [debug_options]
编写调试日志。典型的* debug_options
*字符串是d:t:o,file_name
。默认值为d:t:o
。
仅当使用WITH_DEBUG构建 MySQL 时,此选项才可用。使用此选项不是构建 Oracle 提供的 MySQL 发行版二进制文件。
程序退出时,打印一些调试信息。
仅当使用WITH_DEBUG构建 MySQL 时,此选项才可用。使用此选项不是构建 Oracle 提供的 MySQL 发行版二进制文件。
程序退出时,打印调试信息以及内存和 CPU 使用情况统计信息。
仅当使用WITH_DEBUG构建 MySQL 时,此选项才可用。使用此选项不是构建 Oracle 提供的 MySQL 发行版二进制文件。
使用* charset_name
*作为默认字符集。参见第 10.15 节“字符集配置”。
在全局选项文件之后但在用户选项文件之前(在 Unix 上)读取此选项文件。如果该文件不存在或无法访问,则发生错误。 * file_name
*如果是相对路径名而不是完整路径名,则相对于当前目录进行解释。
有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。
仅使用给定的选项文件。如果该文件不存在或无法访问,则发生错误。 * file_name
*如果是相对路径名而不是完整路径名,则相对于当前目录进行解释。
exception:即使使用--defaults-file,Client 端程序也读取.mylogin.cnf
。
有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。
不仅阅读常规选项组,还阅读具有常规名称和后缀* str
*的组。例如,mysqlcheck通常读取[client]
和[mysqlcheck]
组。如果提供了--defaults-group-suffix=_other选项,则mysqlcheck也会读取[client_other]
和[mysqlcheck_other]
组。
有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。
- --extended,
-e
如果使用此选项检查 table,则可以确保它们是 100%一致的,但是要花费很长时间。
如果使用此选项修复 table,则它将运行扩展的修复,这不仅可能花费很长时间来执行,而且还会产生很多垃圾行!
有关使用哪个 Client 端身份验证插件的提示。参见第 6.2.13 节“可插入身份验证”。
启用mysql_clear_password
明文身份验证插件。 (请参阅第 6.4.1.6 节“Client 端明文可插入身份验证”。)
MySQL 5.7.10 中添加了此选项。
- --fast,
-F
仅检查尚未正确关闭的 table。
将数据库名称转换为 5.1 格式。仅包含特殊字符的数据库名称会受到影响。
此选项在 MySQL 5.7.6 中已弃用,并将在以后的 MySQL 版本中删除。如果需要转换 MySQL 5.0 数据库或 table 名,一种解决方法是在升级到最新版本之前将 MySQL 5.0 安装升级到 MySQL 5.1.
将 table 名称转换为 5.1 格式。仅包含特殊字符的 table 名会受到影响。此选项也适用于视图。
此选项在 MySQL 5.7.6 中已弃用,并将在以后的 MySQL 版本中删除。如果需要转换 MySQL 5.0 数据库或 table 名,一种解决方法是在升级到最新版本之前将 MySQL 5.0 安装升级到 MySQL 5.1.
- --force,
-f
即使发生 SQL 错误,也要 continue。
从服务器请求基于 RSA 密钥对的密码交换所需的公共密钥。此选项适用于使用caching_sha2_password
身份验证插件进行身份验证的 Client 端。对于该插件,除非请求,否则服务器不会发送公钥。对于未使用该插件进行身份验证的帐户,将忽略此选项。如果不使用基于 RSA 的密码交换,也将被忽略,例如 Client 端使用安全连接连接到服务器时。
如果给出了--server-public-key-path=file_name并指定了有效的公共密钥文件,则它优先于--get-server-public-key。
有关caching_sha2_password
插件的信息,请参见第 6.4.1.4 节“缓存 SHA-2 可插入身份验证”。
--get-server-public-key选项已添加到 MySQL 5.7.23 中。
- --host=host_name,
-h host_name
连接到给定主机上的 MySQL 服务器。
从.mylogin.cnf
登录路径文件中的命名登录路径中读取选项。 “登录路径”是一个选项组,其中包含一些选项,这些选项指定要连接到哪个 MySQL 服务器以及要作为身份验证的帐户。要创建或修改登录路径文件,请使用mysql_config_editorUtil。参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”。
有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。
- --medium-check,
-m
进行比--extended操作更快的检查。这样只会发现所有错误的 99.99%,在大多数情况下应该足够了。
不要读取任何选项文件。如果由于从选项文件中读取未知选项而导致程序启动失败,则可以使用--no-defaults来防止读取它们。
exception 是在所有情况下都读取.mylogin.cnf
文件(如果存在)。这样即使在使用--no-defaults的情况下,也可以通过比命令行更安全的方式指定密码。 (.mylogin.cnf
由mysql_config_editorUtil 创建。请参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”。)
有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。
- --optimize,
-o
优化 table。
- --password[=password],
-p[password]
用于连接服务器的 MySQL 帐户的密码。密码值是可选的。如果未给出,mysqlcheck提示 Importing 一个。如果提供,则--password=或-p
与后面的密码之间必须没有空格。如果未指定密码选项,则默认为不发送密码。
在命令行上指定密码应该被认为是不安全的。为避免在命令行上 Importing 密码,请使用选项文件。参见第 6.1.2.1 节,“最终用户密码安全准则”。
要明确指定没有密码并且mysqlcheck不应提示 Importing 密码,请使用--skip-password选项。
- --pipe,
-W
在 Windows 上,使用命名管道连接到服务器。仅当服务器在启用了named_pipe系统变量的情况下启动以支持命名管道连接时,此选项才适用。此外,构建连接的用户必须是named_pipe_full_access_group系统变量指定的 Windows 组的成员。
在其中查找插件的目录。如果--default-auth选项用于指定身份验证插件,但mysqlcheck找不到它,请指定此选项。参见第 6.2.13 节“可插入身份验证”。
- --port=port_num,
-P port_num
对于 TCP/IP 连接,使用的端口号。
打印程序名称及其从选项文件中获取的所有选项。
有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。
用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时,此功能很有用。有关允许值的详细信息,请参见第 4.2.5 节“连接传输协议”。
- --quick,
-q
如果使用此选项检查 table,它将阻止检查扫描行以检查不正确的链接。这是最快的检查方法。
如果使用此选项修复 table,它将尝试仅修复索引树。这是最快的修复方法。
- --repair,
-r
进行修复可以修复几乎所有东西,除了不是唯一的唯一键。
不要以旧(4.1 之前)格式向服务器发送密码。这样可以防止除使用较新密码格式的服务器以外的其他连接。
从 MySQL 5.7.5 开始,此选项已被弃用,并将在以后的 MySQL 版本中删除。它始终处于启用状态,尝试禁用它(--skip-secure-auth,--secure-auth=0)会产生错误。在 MySQL 5.7.5 之前,此选项默认为启用,但可以禁用。
Note
使用 4.1 之前的哈希方法的密码比使用本地密码哈希方法的密码安全性较低,应避免使用。不建议使用 4.1 之前的密码,并在 MySQL 5.7.5 中删除了对它们的支持。有关帐户升级的说明,请参阅第 6.4.1.3 节“迁移到 4.1 版之前的密码哈希和 mysql_old_password 插件”。
PEM 格式的文件的路径名,其中包含服务器用于基于 RSA 密钥对的密码交换所需的公用密钥的 Client 端副本。此选项适用于使用sha256_password
或caching_sha2_password
身份验证插件进行身份验证的 Client 端。对于未通过这些插件之一进行身份验证的帐户,将忽略此选项。如果不使用基于 RSA 的密码交换,也将被忽略,例如 Client 端使用安全连接连接到服务器时。
如果给出了--server-public-key-path=file_name并指定了有效的公共密钥文件,则它优先于--get-server-public-key。
对于sha256_password
,仅当使用 OpenSSL 构建 MySQL 时,此选项才适用。
有关sha256_password
和caching_sha2_password
插件的信息,请参见第 6.4.1.5 节“ SHA-256 可插拔身份验证”和第 6.4.1.4 节“缓存 SHA-2 可插入身份验证”。
--server-public-key-path选项已添加到 MySQL 5.7.23 中。
在 Windows 上,共享内存名称,用于使用共享内存与本地服务器构建的连接。默认值为MYSQL
。共享内存名称区分大小写。
仅当在启用了shared_memory系统变量以支持共享内存连接的情况下启动服务器时,此选项才适用。
- --silent,
-s
静音模式。仅打印错误消息。
mysqlcheck执行的操作中不要包括命名数据库(区分大小写)。
- --socket=path,
-S path
对于到localhost
的连接(要使用的 Unix 套接字文件),或者在 Windows 上,要使用的命名管道的名称。
在 Windows 上,仅当在启用了named_pipe系统变量以支持命名管道连接的情况下启动服务器时,此选项才适用。此外,构建连接的用户必须是named_pipe_full_access_group系统变量指定的 Windows 组的成员。
以--ssl
开头的选项指定是否使用 SSL 连接到服务器,并指示在何处查找 SSL 密钥和证书。参见加密连接的命令选项。
覆盖--databases或-B
选项。选项后的所有名称参数均视为 table 名称。
加密连接允许的 TLS 协议。该值是一个或多个逗号分隔的协议名称的列 table。可以为此选项命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息,请参见第 6.3.2 节“加密的连接 TLS 协议和密码”。
MySQL 5.7.10 中添加了此选项。
对于MyISAM
table 的修复操作,请从.frm
文件获取 table 结构,以便即使.MYI
Headers 损坏也可以修复该 table。
- --user=user_name,
-u user_name
用于连接到服务器的 MySQL 帐户的用户名。
- --verbose,
-v
详细模式。打印有关程序操作各个阶段的信息。
- --version,
-V
显示版本信息并退出。
默认情况下启用此选项,以便将mysqlcheck生成的ANALYZE TABLE,OPTIMIZE TABLE和REPAIR TABLE语句写入二进制日志。使用--skip-write-binlog将NO_WRITE_TO_BINLOG
添加到语句中,以便不记录它们。当不应将这些语句发送到复制从站或在使用二进制日志从备份中恢复时运行这些语句时,请使用--skip-write-binlog。