该 mysqlcheck 客户端执行表维护:它检查、修复、优化或分析表。
每个表在被处理时都会被锁定,无法被其他会话访问,尽管对于检查操作,表只会被锁定为 READ
锁(见 第 15.3.6 节,“LOCK TABLES 和 UNLOCK TABLES 语句”,以获取更多关于 READ
和 WRITE
锁的信息)。表维护操作可能需要很长时间,特别是对于大型表。如果您使用 --databases
或 --all-databases
选项来处理一个或多个数据库中的所有表,mysqlcheck 的调用可能需要很长时间。(这也是 MySQL 升级过程中需要检查表的原因,因为它以相同的方式处理表。)
mysqlcheck 必须在 mysqld 服务器运行时使用,这意味着您不需要停止服务器来执行表维护。
mysqlcheck 使用 SQL 语句 CHECK TABLE
、REPAIR TABLE
、ANALYZE TABLE
和 OPTIMIZE TABLE
以一种方便用户的方式。它确定要执行的语句,并将语句发送到服务器以执行。有关每个存储引擎支持的语句,请参阅 第 15.7.3 节,“表维护语句”。
并不是所有存储引擎都支持四种维护操作。在这种情况下,将显示错误消息。例如,如果 test.t
是一个 MEMORY
表,尝试检查它将产生以下结果:
$> mysqlcheck test t
test.t
note : The storage engine for the table doesn't support check
如果 mysqlcheck 无法修复表,请参阅 第 3.14 节,“重建或修复表或索引”,以获取手动表修复策略。这是 InnoDB
表的情况,例如,可以使用 CHECK TABLE
检查,但不能使用 REPAIR TABLE
修复。
在执行表修复操作之前,建议备份表;在某些情况下,操作可能会导致数据丢失。可能的原因包括但不限于文件系统错误。
有三种方式来调用 mysqlcheck:
mysqlcheck [options] db_name [tbl_name ...]
mysqlcheck [options] --databases db_name ...
mysqlcheck [options] --all-databases
如果您没有在 db_name
之后命名任何表,或者使用 --databases
或 --all-databases
选项,整个数据库将被检查。
mysqlcheck 有一个特殊的功能,相比其他客户端程序。默认行为检查表格(--check
)可以通过重命名二进制文件来更改。如果您想拥有一个默认修复表格的工具,只需将 mysqlcheck 复制到名为 mysqlrepair,或创建一个指向 mysqlcheck 的符号链接名为 mysqlrepair。如果您调用 mysqlrepair,它将修复表格。
以下表格显示了可以更改 mysqlcheck 默认行为的名称。
Command | Meaning |
---|---|
mysqlrepair | 默认选项是 --repair |
mysqlanalyze | 默认选项是 --analyze |
mysqloptimize | 默认选项是 --optimize |
mysqlcheck 支持以下选项,可以在命令行或在 [mysqlcheck]
和 [client]
组的选项文件中指定。有关 MySQL 程序使用的选项文件的信息,请参阅 第 6.2.2.2 节,“使用选项文件”。
表 6.13 mysqlcheck 选项
Option Name | Description |
---|---|
--all-databases | 检查所有数据库中的所有表格 |
--all-in-1 | 执行单个语句以命名每个数据库中的所有表格 |
--analyze | 分析表格 |
--auto-repair | 如果检查的表格损坏了,自动修复它 |
--bind-address | 使用指定的网络接口连接到 MySQL 服务器 |
--character-sets-dir | 字符集安装的目录 |
--check | 检查表格以查找错误 |
--check-only-changed | 仅检查自上次检查以来已更改的表格 |
--check-upgrade | 使用 FOR UPGRADE 选项调用 CHECK TABLE |
--compress | 压缩客户端和服务器之间的所有信息 |
--compression-algorithms | 服务器连接的允许压缩算法 |
--databases | 将所有参数解释为数据库名称 |
--debug | 写入调试日志 |
--debug-check | 在程序退出时打印调试信息 |
--debug-info | 在程序退出时打印调试信息、内存和 CPU 统计信息 |
--default-auth | 要使用的身份验证插件 |
--default-character-set | 指定默认字符集 |
--defaults-extra-file | 除了通常的选项文件外,还读取命名的选项文件 |
--defaults-file | 仅读取命名的选项文件 |
--默认组后缀 | 选项组后缀值 |
--启用明文身份验证插件 | 启用明文身份验证插件 |
--扩展 | 检查和修复表 |
--快速 | 仅检查未正确关闭的表 |
--强制 | 即使出现 SQL 错误,也继续执行 |
--获取服务器公钥 | 从服务器请求 RSA 公钥 |
--帮助 | 显示帮助信息并退出 |
--主机 | MySQL 服务器所在的主机 |
--登录路径 | 从 .mylogin.cnf 读取登录路径选项 |
--中等检查 | 执行比 --extended 操作更快的检查 |
--不使用默认值 | 不读取选项文件 |
--不使用登录路径 | 不从登录路径文件中读取登录路径 |
--优化 | 优化表 |
--密码 | 连接服务器时使用的密码 |
--密码1 | 连接服务器时使用的第一个多因素身份验证密码 |
--密码2 | 连接服务器时使用的第二个多因素身份验证密码 |
--密码3 | 连接服务器时使用的第三个多因素身份验证密码 |
--管道 | 使用命名管道连接服务器(仅限 Windows) |
--插件目录 | 插件安装目录 |
--端口 | TCP/IP 端口号 |
--打印默认值 | 打印默认选项 |
--协议 | 传输协议 |
--快速 | 最快的检查方法 |
--修复 | 执行可以修复几乎所有问题的修复操作,除了唯一键不唯一的问题 |
--服务器公钥路径 | 包含 RSA 公钥的文件路径 |
--共享内存基础名称 | 共享内存名称(仅限 Windows) |
--沉默 | 沉默模式 |
--跳过数据库 | 跳过该数据库的操作 |
--套接字 | Unix 套接字文件或 Windows 命名管道 |
--ssl-ca | 包含受信任的 SSL 证书颁发机构的文件 |
--ssl-capath | 包含受信任的 SSL 证书颁发机构证书文件的目录 |
--ssl-cert | 包含 X.509 证书的文件 |
--ssl-cipher | 连接加密的可接受密码 |
--ssl-crl | 包含证书吊销列表的文件 |
--ssl-crlpath | 包含证书吊销列表文件的目录 |
--ssl-fips 模式 | 是否在客户端启用 FIPS 模式 |
--ssl-key | 包含 X.509 密钥的文件 |
--ssl-mode | 连接到服务器的所需安全状态 |
--ssl-session-data | 包含 SSL 会话数据的文件 |
--ssl-session-data-continue-on-failed-reuse | 如果会话重用失败,是否建立连接 |
--tables | 覆盖 --databases 或 -B 选项 |
--tls-ciphersuites | 加密连接的可接受 TLSv1.3 密码套件 |
--tls-sni-servername | 客户端提供的服务器名称 |
--tls-version | 加密连接的可接受 TLS 协议 |
--use-frm | 用于 MyISAM 表的修复操作 |
--user | 连接到服务器时使用的 MySQL 用户名 |
--verbose | 详细模式 |
--version | 显示版本信息并退出 |
--write-binlog | 将 ANALYZE、OPTIMIZE、REPAIR 语句记录到二进制日志中。--skip-write-binlog 添加 NO_WRITE_TO_BINLOG 到这些语句中 |
--zstd-compression-level | 使用 zstd 压缩的连接的压缩级别 |
-
--help
,-?
Command-Line Format --help
显示帮助信息并退出。
-
--all-databases
,-A
Command-Line Format --all-databases
检查所有数据库中的所有表。这与使用
--databases
选项并在命令行中命名所有数据库相同,除了 INFORMATION_SCHEMA 和 performance_schema 数据库不会被检查。它们可以通过使用--databases
选项来检查。 -
--all-in-1
,-1
Command-Line Format --all-in-1
而不是为每个表执行语句,执行一个语句来处理每个数据库中的所有表。
-
--analyze
,-a
Command-Line Format --analyze
分析表。
-
Command-Line Format --auto-repair
如果检查表损坏,自动修复它。在所有表都被检查后,执行任何必要的修复。
-
Command-Line Format --bind-address=ip_address
在具有多个网络接口的计算机上,使用此选项选择连接到 MySQL 服务器时使用的接口。
-
Command-Line Format --character-sets-dir=dir_name
Type 目录名称 字符集安装的目录。参见 第 12.15 节,“字符集配置”。
-
--check
,-c
Command-Line Format --检查
检查表格错误。这是默认操作。
-
--仅检查已更改
,-C
Command-Line Format --仅检查已更改
仅检查自上次检查以来已更改的表格或未正确关闭的表格。
-
--检查升级
,-g
Command-Line Format --检查升级
使用
CHECK TABLE
语句的FOR UPGRADE
选项来检查表格与当前服务器版本的不兼容性。 -
Command-Line Format --压缩[={OFF|ON}]
Deprecated 是 Type 布尔值 Default Value OFF
如果可能,压缩客户端和服务器之间的所有信息。请参阅 第 6.2.8 节,“连接压缩控制”。
该选项已弃用。预计在未来版本的 MySQL 中删除该选项。请参阅 配置遗留连接压缩。
-
Command-Line Format --压缩算法=value
Type 设置 Default Value 未压缩
Valid Values zlib
zstd
未压缩
服务器连接的允许压缩算法。可用的算法与
protocol_compression_algorithms
系统变量相同。默认值为未压缩
。更多信息,请参阅 第 6.2.8 节,“连接压缩控制”。
-
--数据库
,-B
Command-Line Format --数据库
处理命名数据库中的所有表格。通常,mysqlcheck 将命令行上的第一个名称参数视为数据库名称,随后的名称参数视为表格名称。使用此选项,所有名称参数都将被视为数据库名称。
-
--调试[=
,调试选项
]-# [
调试选项
]Command-Line Format --调试[=调试选项]
Type 字符串 Default Value d:t:o
写入调试日志。典型的
调试选项
字符串是d:t:o,
。默认值为文件名
d:t:o
。该选项仅在 MySQL 使用
WITH_DEBUG
选项构建时可用。Oracle 提供的 MySQL 发行版二进制文件 不 使用该选项。 -
Command-Line Format --调试检查
Type 布尔值 Default Value FALSE
程序退出时打印一些调试信息。
该选项仅在 MySQL 使用
WITH_DEBUG
选项构建时可用。Oracle 提供的 MySQL 发行版二进制文件 不 使用该选项。 -
Command-Line Format --调试信息
Type 布尔值 Default Value FALSE
打印调试信息和内存和 CPU 使用情况统计信息当程序退出时。
只有在 MySQL 使用
WITH_DEBUG
选项构建时才可用。 Oracle 提供的 MySQL 发行二进制文件 不 使用此选项。 -
--default-character-set=
charset_name
Command-Line Format --default-character-set=charset_name
Type 字符串 使用
charset_name
作为默认字符集。见 第 12.15 节,“字符集配置”。 -
--defaults-extra-file=
file_name
Command-Line Format --defaults-extra-file=file_name
Type 文件名 在全局选项文件之后但(在 Unix 上)在用户选项文件之前读取此选项文件。如果文件不存在或不可访问,将发生错误。如果
file_name
不是绝对路径名,则相对于当前目录进行解释。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --defaults-file=file_name
Type 文件名 仅使用给定的选项文件。如果文件不存在或不可访问,将发生错误。如果
file_name
不是绝对路径名,则相对于当前目录进行解释。例外:即使使用
--defaults-file
,客户端程序也将读取.mylogin.cnf
。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --defaults-group-suffix=str
Type 字符串 不仅读取通常的选项组,还读取具有通常名称和
str
后缀的组。例如,mysqlcheck 通常读取[client]
和[mysqlcheck]
组。如果使用--defaults-group-suffix=_other
,mysqlcheck 也将读取[client_other]
和[mysqlcheck_other]
组。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
--extended
,-e
Command-Line Format --extended
如果您使用此选项来检查表,则确保它们是 100% 一致的,但需要很长时间。
如果您使用此选项来修复表,则运行扩展修复,这不仅需要很长时间执行,还可能产生大量垃圾行。
-
Command-Line Format --default-auth=plugin
Type 字符串 客户端身份验证插件的提示。见 第 8.2.17 节,“可插拔身份验证”。
-
Command-Line Format --enable-cleartext-plugin
Type 布尔值 Default Value FALSE
启用
mysql_clear_password
明文身份验证插件。(见 第 8.4.1.4 节,“客户端明文可插拔身份验证”。) -
--fast
,-F
Command-Line Format --fast
仅检查未正确关闭的表。
-
--force
,-f
Command-Line Format --force
即使出现 SQL 错误,也继续执行。
-
Command-Line Format --get-server-public-key
Type 布尔值 从服务器请求用于 RSA 密钥对基于密码交换的公钥。此选项适用于使用
caching_sha2_password
身份验证插件的客户端。对于该插件,服务器不会发送公钥,除非被请求。此选项将被忽略,如果客户端使用安全连接连接到服务器时,不使用基于 RSA 的密码交换。如果
--server-public-key-path=
指定了有效的公钥文件,则它将优先于file_name
--get-server-public-key
。有关
caching_sha2_password
插件的信息,请参阅 第 8.4.1.2 节,“caching SHA-2 可插拔身份验证”。 -
--host=
,host_name
-h
host_name
Command-Line Format --host=host_name
Type 字符串 Default Value localhost
连接到指定主机的 MySQL 服务器。
-
Command-Line Format --login-path=name
Type 字符串 从命名的登录路径文件中读取选项
.mylogin.cnf
。一个 “登录路径” 是一个选项组,包含指定要连接的 MySQL 服务器和要身份验证的账户的选项。要创建或修改登录路径文件,请使用 mysql_config_editor 实用程序。见 第 6.6.7 节,“mysql_config_editor — MySQL 配置实用程序”。有关此选项和其他选项文件选项的更多信息,请参阅 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --no-login-paths
跳过从登录路径文件中读取选项。
见
--login-path
有关信息。有关此选项和其他选项文件选项的更多信息,请参阅 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
--medium-check
,-m
Command-Line Format --medium-check
执行比
--extended
操作更快的检查。这只找到99.99%的所有错误,在大多数情况下应该足够。 -
Command-Line Format --no-defaults
不读取任何选项文件。如果程序启动失败是由于从选项文件中读取未知选项,
--no-defaults
可以用于防止它们被读取。唯一的例外是,如果存在,总是读取
.mylogin.cnf
文件。这允许在命令行上使用--no-defaults
时以更安全的方式指定密码。要创建.mylogin.cnf
,使用mysql_config_editor实用程序。见第 6.6.7 节,“mysql_config_editor — MySQL Configuration Utility”。有关此选项和其他选项文件选项的更多信息,请参见第 6.2.2.3 节,“Command-Line Options that Affect Option-File Handling”。
-
--optimize
,-o
Command-Line Format --optimize
优化表。
-
--password[=
,password
]-p[
password
]Command-Line Format --password[=password]
Type 字符串 用于连接服务器的 MySQL 帐户的密码。密码值是可选的。如果不提供,mysqlcheck 将提示输入。如果提供,必须在
--password=
或-p
和密码之间没有空格。如果不指定密码选项,默认情况下不发送密码。在命令行上指定密码应该被认为是不安全的。要避免在命令行上提供密码,请使用选项文件。见第 8.1.2.1 节,“End-User Guidelines for Password Security”。
要明确指定没有密码并且 mysqlcheck 不应该提示输入,请使用
--skip-password
选项。 -
用于连接服务器的 MySQL 帐户的多因素身份验证因子 1 的密码。密码值是可选的。如果不提供,mysqlcheck 将提示输入。如果提供,必须在
--password1=
和密码之间没有空格。如果不指定密码选项,默认情况下不发送密码。在命令行上指定密码应该被认为是不安全的。要避免在命令行上提供密码,请使用选项文件。见第 8.1.2.1 节,“End-User Guidelines for Password Security”。
要明确指定没有密码并且 mysqlcheck 不应该提示输入,请使用
--skip-password1
选项。--密码1
和--密码
是同义的,如同--skip-password1
和--skip-password
。 -
MySQL 帐户用于连接到服务器的多因素身份验证因子 2 的密码。该选项的语义与
--密码1
的语义相似;请参阅该选项的描述以获取详细信息。 -
MySQL 帐户用于连接到服务器的多因素身份验证因子 3 的密码。该选项的语义与
--密码1
的语义相似;请参阅该选项的描述以获取详细信息。 -
--pipe
,-W
Command-Line Format --pipe
Type 字符串 在 Windows 上,使用命名管道连接到服务器。该选项仅适用于服务器启用了
named_pipe
系统变量以支持命名管道连接。此外,进行连接的用户必须是 Windows 组named_pipe_full_access_group
的成员。 -
Command-Line Format --plugin-dir=dir_name
Type 目录名称 查找插件的目录。如果使用
--default-auth
选项指定身份验证插件,但 mysqlcheck 未找到它。请参阅 第 8.2.17 节,“可插拔身份验证”。 -
--port=
,port_num
-P
port_num
Command-Line Format --port=port_num
Type 数字 Default Value 3306
对于 TCP/IP 连接,使用的端口号。
-
Command-Line Format --print-defaults
打印程序名称和从选项文件获取的所有选项。
有关该选项和其他选项文件选项的更多信息,请参阅 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
--protocol={TCP|SOCKET|PIPE|MEMORY}
Command-Line Format --protocol=type
Type 字符串 Default Value [见文本]
Valid Values TCP
SOCKET
PIPE
MEMORY
用于连接到服务器的传输协议。当其他连接参数通常导致使用其他协议时,该选项非常有用。有关允许值的详细信息,请参阅 第 6.2.7 节,“连接传输协议”。
-
--quick
,-q
Command-Line Format --quick
如果您使用该选项来检查表,则它将阻止检查扫描行以检查不正确的链接。这是最快的检查方法。
如果您使用此选项来修复表,则尝试仅修复索引树。这是最快的修复方法。
-
--repair
,-r
Command-Line Format --repair
执行可以修复几乎所有内容的修复,除了唯一键不唯一的。
-
--server-public-key-path=
file_name
Command-Line Format --server-public-key-path=file_name
Type 文件名 服务器所需的 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
插件的信息,请参阅 第 8.4.1.3 节,“SHA-256 可插拔身份验证” 和 第 8.4.1.2 节,“Caching SHA-2 可插拔身份验证”。 -
--shared-memory-base-name=
name
Command-Line Format --shared-memory-base-name=name
Platform Specific Windows 在 Windows 上,用于使用共享内存连接到本地服务器的共享内存名称。默认值为
MYSQL
。共享内存名称区分大小写。该选项仅适用于服务器启用了
shared_memory
系统变量以支持共享内存连接的情况。 -
--silent
,-s
Command-Line Format --silent
静默模式。仅打印错误消息。
-
Command-Line Format --skip-database=db_name
不包括指定的数据库(区分大小写)在 mysqlcheck 执行的操作中。
-
--socket=
,path
-S
path
Command-Line Format --socket={file_name|pipe_name}
Type 字符串 对于连接到
localhost
的连接,Unix 套接字文件的名称,或者在 Windows 上,命名管道的名称。在 Windows 上,该选项仅适用于服务器启用了
named_pipe
系统变量以支持命名管道连接的情况。此外,进行连接的用户必须是 Windows 组named_pipe_full_access_group
的成员。 -
以
--ssl
开头的选项指定是否使用加密连接到服务器,并指示 SSL 密钥和证书的位置。请参阅 命令选项用于加密连接。 -
--ssl-fips-mode={OFF|ON|STRICT}
Command-Line Format --ssl-fips-mode={OFF|ON|STRICT}
Deprecated 是 Type 枚举 Default Value OFF
Valid Values OFF
ON
STRICT
控制客户端是否启用 FIPS 模式。该
--ssl-fips-mode
选项不同于其他--ssl-
选项,因为它不是用于建立加密连接,而是影响哪些加密操作被允许。详见 第 8.8 节,“FIPS 支持”。xxx
这些
--ssl-fips-mode
值是允许的:-
OFF
:禁用 FIPS 模式。 -
ON
:启用 FIPS 模式。 -
STRICT
:启用“严格”FIPS 模式。
Note如果 OpenSSL FIPS 对象模块不可用,则唯一允许的
--ssl-fips-mode
值是OFF
。在这种情况下,设置--ssl-fips-mode
为ON
或STRICT
将导致客户端在启动时产生警告,并在非 FIPS 模式下操作。该选项已弃用。预计在未来版本的 MySQL 中删除。
-
-
Command-Line Format --tables
覆盖
--databases
或-B
选项。所有名称参数都将被视为表名。 -
--tls-ciphersuites=
ciphersuite_list
Command-Line Format --tls-ciphersuites=ciphersuite_list
Type 字符串 用于加密连接的可接受加密套件列表。该值是一个或多个以冒号分隔的加密套件名称。可以命名的加密套件取决于编译 MySQL 的 SSL 库。详见 第 8.3.2 节,“加密连接 TLS 协议和加密套件”。
-
--tls-sni-servername=
server_name
Command-Line Format --tls-sni-servername=server_name
Type 字符串 当指定时,该名称将被传递给
libmysqlclient
C API 库使用MYSQL_OPT_TLS_SNI_SERVERNAME
选项的mysql_options()
。服务器名称不区分大小写。要显示客户端当前会话中指定的服务器名称(如果有),请检查Tls_sni_server_name
状态变量。服务器名称指示(SNI)是 TLS 协议的扩展(OpenSSL 必须使用 TLS 扩展来编译以使该选项生效)。MySQL 实现 SNI 仅表示客户端。
-
Command-Line Format --tls-version=protocol_list
Type 字符串 Default Value TLSv1,TLSv1.1,TLSv1.2,TLSv1.3
(OpenSSL 1.1.1 或更高版本)TLSv1,TLSv1.1,TLSv1.2
(否则)用于加密连接的可接受 TLS 协议列表。该值是一个或多个以逗号分隔的协议名称。可以命名的协议取决于编译 MySQL 的 SSL 库。详见 第 8.3.2 节,“加密连接 TLS 协议和加密套件”。
-
Command-Line Format --use-frm
对于 MyISAM 表的修复操作,从数据字典中获取表结构,以便即使
.MYI
头文件损坏也可以修复表。 -
--user=
,用户名
-u
用户名
Command-Line Format --user=用户名,
Type 字符串 用于连接服务器的 MySQL 帐户用户名。
-
--verbose
,-v
Command-Line Format --verbose
详细模式。打印程序操作的各个阶段的信息。
-
--version
,-V
Command-Line Format --version
显示版本信息并退出。
-
Command-Line Format --write-binlog
该选项默认启用,以便
ANALYZE TABLE
、OPTIMIZE TABLE
和REPAIR TABLE
语句生成的 mysqlcheck 被写入二进制日志。使用--skip-write-binlog
使语句添加NO_WRITE_TO_BINLOG
,以便它们不被记录到日志中。使用--skip-write-binlog
当这些语句不应被发送到副本或在从备份中恢复时使用二进制日志。 -
Command-Line Format --zstd-compression-level=#
Type 整数 用于服务器连接的 zstd 压缩算法的压缩级别。允许的级别从 1 到 22,越高的值表示越高的压缩级别。默认的 zstd 压缩级别为 3。压缩级别设置对不使用 zstd 压缩的连接没有影响。
有关更多信息,请参阅 第 6.2.8 节,“连接压缩控制”。