4.5.3 mysqlcheck —表维护程序

所述mysqlcheck的客户端执行表维护：它检查，修理，优化，或分析表。

每个表均被锁定，因此在处理过程中无法供其他会话使用，尽管对于检查操作，该表仅使用锁定进行READ锁定（有关以及的更多信息，请参见 第13.3.6节“ LOCK TABLES和UNLOCK TABLES语句”。 锁）。表维护操作可能很耗时，特别是对于大型表。如果使用 或 选项处理一个或多个数据库中的所有表，则调用 mysqlcheckREAD``WRITE--databases--all-databases可能需要很长时间。（如果MySQL升级过程确定需要检查表，因为它以相同的方式处理表，对于MySQL升级过程也是如此。）

当mysqld服务器运行时，必须使用 mysqlcheck，这意味着您不必停止服务器即可执行表维护。

mysqlcheck的使用SQL语句 CHECK TABLE， REPAIR TABLE， ANALYZE TABLE，并 OPTIMIZE TABLE在用户的便捷方式。它确定要用于该操作的语句，然后将这些语句发送到要执行的服务器。有关每个语句使用哪些存储引擎的详细信息，请参见第13.7.3节“表维护语句”中对这些语句的描述 。

所有存储引擎不一定都支持所有四个维护操作。在这种情况下，将显示错误消息。例如，如果test.t是一个 MEMORY表，则对其进行检查会产生以下结果：

shell> mysqlcheck test t
test.t
note     : The storage engine for the table doesn't support check

如果mysqlcheck无法修复表，请参见第2.11.13节“重建或修复表或索引”以获取手动表修复策略。例如，对于InnoDB表，就是这种情况， 可以使用检查 CHECK TABLE但不能使用对其进行修复REPAIR TABLE。

警告

最好在执行表修复操作之前先备份表。在某些情况下，该操作可能会导致数据丢失。可能的原因包括但不限于文件系统错误。

有三种通用的方法可以调用 mysqlcheck：

shell> mysqlcheck [options] db_name [tbl_name ...]
shell> mysqlcheck [options] --databases db_name ...
shell> mysqlcheck [options] --all-databases

如果未在其后命名任何表， *db_name*或者使用--databases或 --all-databases选项，则将 检查整个数据库。

与其他客户端程序相比， mysqlcheck具有特殊功能。--check可通过重命名二进制文件来更改检查表（）的默认行为。如果要使用默认情况下修复表的工具，则应仅复制一个名为 mysqlrepair的 mysqlcheck，或建立一个指向名为 mysqlrepair的mysqlcheck的符号链接 。如果调用 mysqlrepair，它将修复表。

下表中显示的名称可用于更改 mysqlcheck的默认行为。

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

表4.13 mysqlcheck选项

• --help， -?

  显示帮助消息并退出。

• --all-databases， -A

  检查所有数据库中的所有表。这与使用该--databases选项并在命令行上命名所有数据库相同，只是不检查INFORMATION_SCHEMA和 performance_schema数据库。可以通过使用--databases选项明确命名它们来检查它们。

• --all-in-1， -1

  不必为每个表发出一个语句，而是对每个数据库执行一个语句，该语句命名该数据库中要处理的所有表。

• --analyze， -a

  分析表。

• --auto-repair

  如果检查表已损坏，请自动对其进行修复。在检查完所有表之后，将进行任何必要的维修。

• --bind-address=*ip_address*

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

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

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

• --check， -c

  检查表中是否有错误。这是默认操作。

• --check-only-changed， -C

  仅检查自上次检查以来已更改的表或未正确关闭的表。

• --check-upgrade， -g

  调用CHECK TABLE与 FOR UPGRADE检查表的不兼容问题与服务器的最新版本选项。

• --compress

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

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

• --compression-algorithms=*value*

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

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

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

• --databases， -B

  处理命名数据库中的所有表。通常， mysqlcheck将命令行上的名字参数视为数据库名称，并将其后的名称视为表名称。使用此选项，它将所有名称参数视为数据库名称。

• --debug[=*debug_options*\]， -# [*debug_options*]

  编写调试日志。典型的 *debug_options*字符串是 。默认值为。 d:t:o,*file_name*``d:t:o

  仅当MySQL是使用构建的时，此选项才可用 WITH_DEBUG。Oracle提供的MySQL版本二进制文件不是 使用此选项构建的。

• --debug-check

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

  仅当MySQL是使用构建的时，此选项才可用 WITH_DEBUG。Oracle提供的MySQL版本二进制文件不是 使用此选项构建的。

• --debug-info

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

  仅当MySQL是使用构建的时，此选项才可用 WITH_DEBUG。Oracle提供的MySQL版本二进制文件不是 使用此选项构建的。

• --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*如果给出为相对路径名而不是完整路径名，则相对于当前目录解释。

  例外：即使这样--defaults-file，客户端程序也会 读取.mylogin.cnf。

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

• --defaults-group-suffix=*str*

  不仅阅读常规选项组，而且阅读具有常规名称和后缀的组 str。例如， mysqlcheck通常读取 [client]和 [mysqlcheck]组。如果--defaults-group-suffix=_other 给出了该 选项，则mysqlcheck还将读取[client_other]和 [mysqlcheck_other]组。

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

• --extended， -e

  如果使用此选项检查表，则可确保它们是100％一致的，但是要花费很长时间。

  如果使用此选项修复表，则它将运行扩展的修复，这不仅可能花费很长时间来执行，而且还会产生很多垃圾行！

• --default-auth=*plugin*

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

• --enable-cleartext-plugin

  启用mysql_clear_password明文身份验证插件。（请参见 第6.4.1.4节“客户端明文可插入身份验证”。）

• --fast， -F

  仅检查尚未正确关闭的表。

• --force， -f

  即使发生SQL错误，也要继续。

• --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节“影响选项文件处理的命令行选项”。

• --medium-check， -m

  进行比--extended操作更快的检查 。这样只会发现所有错误的99.99％，在大多数情况下应该足够了。

• --no-defaults

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

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

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

• --optimize， -o

  优化表。

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

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

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

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

• --pipe， -W

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

• --plugin-dir=*dir_name*

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

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

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

• --print-defaults

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

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

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

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

• --quick， -q

  如果使用此选项检查表，它将阻止检查扫描行以检查不正确的链接。这是最快的检查方法。

  如果使用此选项修复表，它将尝试仅修复索引树。这是最快的修复方法。

• --repair， -r

  进行修复可以修复几乎所有东西，除了不是唯一的唯一键。

• --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启用系统变量以支持共享内存连接的情况下启动时，此选项才适用 。

• --silent， -s

  静音模式。仅打印错误消息。

• --skip-database=*db_name*

  mysqlcheck 执行的操作中不要包括命名数据库（区分大小写）。

• --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模式运行。

• --tables

  覆盖--databases or-B选项。选项后的所有名称参数均视为表名称。

• --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协议和密码”。

• --use-frm

  对于MyISAM表的修复操作，请从数据字典中获取表结构，以便即使表.MYI 头损坏也可以修复表。

• --user=*user_name*， -u *user_name*

  用于连接到服务器的MySQL帐户的用户名。

• --verbose， -v

  详细模式。打印有关程序操作各个阶段的信息。

• --version， -V

  显示版本信息并退出。

• --write-binlog

  此选项是默认启用的，这样 ANALYZE TABLE， OPTIMIZE TABLE和 REPAIR TABLE所产生的报表mysqlcheck的被写入二进制日志。使用 --skip-write-binlog 到的原因NO_WRITE_TO_BINLOG被添加到让他们没有记录的语句。--skip-write-binlog 当使用这些二进制日志从备份中恢复时，请使用 when不应将这些语句发送到副本或运行这些语句。

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

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

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

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