6.5.3 mysqldump — 数据库备份程序
MySQL客户端mysqlcheck执行表维护:它检查、修复、优化或分析表。
每个表在被处理时都会被锁定,因此对其他会话 unavailable,尽管对于检查操作,表只被锁定为READ锁(请参阅Section 15.3.6, “LOCK TABLES and UNLOCK TABLES Statements”,了解READ和WRITE锁的更多信息)。表维护操作可能耗时,尤其是对于大型表。如果您使用--databases或--all-databases选项来处理一个或多个数据库中的所有表,mysqlcheck的调用可能会很长时间。(这也是MySQL升级过程中如果需要对表进行检查,因为它以相同方式处理表)。
mysqlcheck必须在mysqld服务器运行时使用,这意味着您不必停止服务器来执行表维护。
.html" title="15.7.3.1 ANALYZE TABLE 语句">.html" title="15.7.3.5 REPAIR TABLE 语句">mysqlcheck使用SQL语句CHECK TABLE、tableREPAIR TABLE、tableANALYZE TABLE和table.html" title="15.7.3.4 OPTIMIZE TABLE 语句">OPTIMIZE TABLE以便于用户。它确定要执行哪些语句来进行您想要执行的操作,然后将这些语句发送到服务器以供执行。有关每个语句在哪些存储引擎上工作的详细信息,请参阅Section 15.7.3, “Table Maintenance Statements”。
所有存储引擎都不是必需的四种维护操作。对于这样的情况,会显示错误消息。例如,如果test.t是一个MEMORY表,尝试检查它将产生以下结果:
$> mysqlcheck test t
test.t
note : The storage engine for the table doesn't support check
如果mysqlcheck无法修复一个表,请参阅tables.html" title="3.14 重建或修复表或索引">Section 3.14, “Rebuilding or Repairing Tables or Indexes”以获取手动表修复策略的信息。这是InnoDB表的情况,它们可以使用table.html" title="15.7.3.2 CHECK TABLE 语句">CHECK TABLE检查,但不能使用table.html" title="15.7.3.5 REPAIR 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,它将修复表格。
以下表格中显示的名称可以用来改变 mysqlcheck 的默认行为。
| Command | Meaning |
|---|---|
| mysqlrepair | 默认选项是 --repair |
| mysqlanalyze | 默认选项是 --analyze |
| mysqloptimize | 默认选项是 --optimize |
mysqlcheck 支持以下选项,可以在命令行或 [mysqlcheck] 和 [client] 小组中的选项文件中指定。有关 MySQL 程序使用的选项文件的信息,请参阅 mysqlcheck。
表格 6.12 mysqlcheck Options
| Option Name | Description |
|---|---|
| --all-databases | 检查所有数据库中的所有表格 |
| --all-in-1 | 为每个数据库执行一个包含该数据库所有表格的单个语句 |
| --analyze | 分析表格 |
| --auto-repair | 如果检查的表格损坏,自动修复它 |
| --bind-address | 使用指定的网络接口连接到 MySQL 服务器 |
| --character-sets-dir | 字符集安装目录 |
| --check | 检查表格以查找错误 |
| --check-only-changed | 仅检查自上次检查以来已更改的表格 |
| --check-upgrade | 调用 CHECK TABLE WITH FOR UPGRADE 选项 |
| --compress | 压缩客户端和服务器之间发送的所有信息 |
| --compression-algorithms | 客户端与服务器之间允许的压缩算法 |
| --databases | 将所有参数解释为数据库名称 |
| --debug | 写入调试日志 |
| --debug-check | 程序退出时打印调试信息 |
| --debug-info | 程序退出时打印调试信息、内存和 CPU 统计信息 |
| --default-auth | 使用的身份验证插件 |
| --default-character-set | 指定默认字符集 |
| --defaults-extra-file | 在通常的选项文件之外读取命名的选项文件 |
| --defaults-file | 仅读取命名的选项文件 |
| --defaults-group-suffix | 选项组后缀值 |
| --enable-cleartext-plugin | 启用清文本认证插件 |
| --extended | 检查并修复表格 |
| --fast | 仅检查尚未正确关闭的表格 |
| --force | 即使发生SQL错误也继续执行 |
| --get-server-public-key | 从服务器请求RSA公钥 |
| --help | 显示帮助信息并退出 |
| --host | MySQL服务器所在主机 |
| --login-path | 从~/.mylogin.cnf读取登录路径选项 |
| --medium-check | 执行比--extended操作更快的检查 |
| --no-defaults | 不读取任何选项文件 |
| --no-login-paths | 不从登录路径文件中读取登录路径 |
| --optimize | 优化表格 |
| --password | 连接到服务器时使用的密码 |
| --password1 | 用于连接到服务器的第一个多因素认证密码 |
| --password2 | 用于连接到服务器的第二个多因素认证密码 |
| --password3 | 用于连接到服务器的第三个多因素认证密码 |
| --pipe | 使用命名管道连接到服务器(仅限Windows) |
| --plugin-dir | 插件安装目录 |
| --port | TCP/IP端口号码 |
| --print-defaults | 打印默认选项 |
| --protocol | 使用的传输协议 |
| --quick | 执行最快的检查操作 |
| --repair | 执行修复操作,除了非唯一键以外几乎可以修复任何问题 |
| --server-public-key-path | 包含RSA公钥的文件路径名 |
| --shared-memory-base-name | 用于共享内存连接的共享内存名称(仅限Windows) |
| --silent | 静默模式 |
| --skip-database | 从执行的操作中排除这个数据库 |
| --socket | Unix域套接字文件或Windows命名管道 |
| --ssl-ca | 包含信任的SSL证书颁发机构列表的文件 |
| --ssl-capath | 包含信任的SSL证书颁发机构证书文件的目录 |
| --ssl-cert | 包含X.509证书的文件 |
| --ssl-cipher | 允许的加密套件列表 |
| --ssl-crl | 包含证书吊销列表的文件 |
| --ssl-crlpath | 包含证书吊销列表文件的目录 |
| --ssl-fips-mode | 是否启用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,-ACommand-Line Format --all-databases检查所有数据库中的所有表。这与在命令行上列出所有数据库并使用
--databases选项相同,除了不检查INFORMATION_SCHEMA和performance_schema数据库。它们可以通过显式地在--databases选项中列出它们来检查。 -
--all-in-1,-1Command-Line Format --all-in-1而不是为每个表发出单独的语句,执行一个单独的语句来处理来自该数据库的所有表。
-
--analyze,-aCommand-Line Format --analyze分析表。
-
Command-Line Format --auto-repair如果检查的表损坏,自动修复它。所有必要的修复在所有表都被检查之后进行。
-
Command-Line Format --bind-address=ip_address在具有多个网络接口的计算机上,使用此选项选择要用于连接到MySQL服务器的接口。
-
Command-Line Format --character-sets-dir=dir_nameType 目录名称 字符集安装的目录。请参阅第 12.15节,“字符集配置”。
-
--check,-cCommand-Line Format --check检查表格以查找错误。这是默认操作。
-
Command-Line Format --check-only-changed仅检查自上次检查以来已更改或未正确关闭的表格。
-
--check-upgrade,-gCommand-Line Format --check-upgrade使用
CHECK TABLE语句的 FOR UPGRADE 选项检查表格是否与当前服务器版本兼容。 -
Command-Line Format --compress[={OFF|ON}]Deprecated 是 Type 布尔值 Default Value OFF如果可能,压缩客户端和服务器之间传输的所有信息。请参阅 第 6.2.8 节,“连接压缩控制”。
此选项已被弃用。预计将在未来版本的 MySQL 中移除。请参阅 配置遗留连接压缩。
-
--compression-algorithms=valueCommand-Line Format --compression-algorithms=valueType 设置 Default Value uncompressedValid Values zlibzstduncompressed用于连接到服务器的允许压缩算法。可用的算法与
protocol_compression_algorithms系统变量相同。默认值为uncompressed。更多信息,请参阅 第 6.2.8 节,“连接压缩控制”。
-
--databases,-BCommand-Line Format --databases处理命令行中指定的所有数据库。通常,mysqlcheck 会将命令行中的第一个名称参数视为数据库名,将后续的参数视为表格名。使用此选项时,它会将所有名称参数视为数据库名。
-
--debug[=,debug_options]-#[debug_options]Command-Line Format --debug[=debug_options]Type 字符串 Default Value d:t:o写入调试日志。一个典型的
debug_options字符串是d:t:o,。默认值为file_named:t:o。此选项仅在 MySQL 使用
WITH_ DEBUG时可用。Oracle 提供的 MySQL 发行版是 不 使用此选项构建的。 -
Command-Line Format --debug-checkType 布尔值 Default Value FALSE程序退出时打印一些调试信息。
此选项仅在 MySQL 使用
WITH_ DEBUG时可用。Oracle 提供的 MySQL 发行版是 不 使用此选项构建的。 -
Command-Line Format --debug-infoType Boolean Default Value FALSE在程序退出时打印调试信息、内存和CPU使用统计。
这项选项仅在MySQL使用
WITH_ DEBUG进行构建时可用。Oracle提供的MySQL发布版本是不使用此选项构建的。 -
--default-character-set=charset_nameCommand-Line Format --default-character-set=charset_nameType 字符串 将
charset_name作为默认字符集使用。请参阅第12.15节,“Character Set Configuration”。 -
--defaults-extra-file=file_nameCommand-Line Format --defaults-extra-file=file_nameType 文件名 在全局选项文件之后但在用户选项文件之前(在Unix上)读取此选项文件。如果
file_name不是绝对路径名,它将相对于当前目录解释。有关此和其他影响选项文件处理的命令行选项的更多信息,请参阅第6.2.2.3节,“Command-Line Options that Affect Option-File Handling”。
-
Command-Line Format --defaults-file=file_nameType 文件名 仅使用给定的选项文件。如果文件不存在或无法访问,会发生错误。如果
file_name不是绝对路径名,它将相对于当前目录解释。例外情况,即使有
--defaults-file,客户端程序仍然读取.mylogin.cnf。有关此和其他影响选项文件处理的命令行选项的更多信息,请参阅第6.2.2.3节,“Command-Line Options that Affect Option-File Handling”。
-
Command-Line Format --defaults-group-suffix=strType 字符串 不仅读取通常的选项组,还读取具有通常名称和
str后缀的组。例如,对于mysqlcheck,通常读取[client]和[mysqlcheck]组。如果给出了--defaults-group-suffix=_other,mysqlcheck也读取[client_other]和[mysqlcheck_other]组。有关此和其他影响选项文件处理的命令行选项的更多信息,请参阅第6.2.2.3节,“Command-Line Options that Affect Option-File Handling”。
-
--extended,-eCommand-Line Format --extended如果您使用此选项来检查表格,它将确保它们是100%一致的,但这需要很长时间。
如果您使用此选项来修复表格,它将运行一个扩展的修复操作,这可能不仅需要很长时间执行,而且还可能产生大量垃圾行!
-
Command-Line Format --default-auth=pluginType 字符串 关于哪个客户端认证插件应该使用的提示。请参阅第8.2.17节,“Pluggable Authentication”。
-
Command-Line Format --enable-cleartext-pluginType 布尔值 Default Value FALSE启用
mysql_clear_password清文本认证插件。 (参见第 8.4.1.4 节,“客户端清文本插件认证”。) -
--fast,-FCommand-Line Format --fast仅检查未正确关闭的表格。
-
--force,-fCommand-Line Format --force即使发生 SQL 错误,也继续执行。
-
Command-Line Format --get-server-public-keyType 布尔值 从服务器请求用于 RSA 密钥对密码交换所需的公钥。这选项适用于使用
caching_sha2_password认证插件的客户端。对于该插件,服务器不会发送公钥,除非被请求。此选项对于不使用 RSA 密钥对密码交换的客户端(即通过安全连接连接到服务器)是无效的。它也会被忽略,如果客户端连接到服务器时使用了其他认证方式。如果给出了
--server-public-key-path=并指定了一个有效的公钥文件,它将优先于file_name--get-server-public-key。有关
caching_sha2_password插件的信息,请参见第 8.4.1.2 节,“缓存 SHA-2 插件认证”。 -
--host=,host_name-hhost_nameCommand-Line Format --host=host_nameType 字符串 Default Value localhost连接到 MySQL 服务器的给定主机上。
-
Command-Line Format --login-path=nameType 字符串 从命名的登录路径中读取选项。一个 “登录路径” 是包含指定 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 -
--medium-checkCommand-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 配置工具”。有关此类选项文件处理命令行选项的更多信息,请见第6.2.2.3节,“影响选项文件处理的命令行选项”。
-
--optimize,-oCommand-Line Format --optimize优化表格。
-
--password[=,密码]-p[密码]Command-Line Format --password[=password]Type 字符串 MySQL账户用于连接服务器的密码。密码值是可选的。如果不给出,mysqlcheck会提示输入一个。如果给出,那么在
--password=或-p后面不能有空格。若无密码选项指定,默认情况下不发送密码。在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码,请使用选项文件。见第8.1.2.1节,“用户指南:密码安全”。
要显式指定没有密码,并且mysqlcheck不应该提示输入密码,请使用
--skip-password选项。 -
用于连接到服务器的MySQL账户的多因素认证因素1的密码。密码值是可选的。如果不给出,mysqlcheck会提示输入一个。如果给出,那么在
--password1=后面不能有空格。若无密码选项指定,默认情况下不发送密码。在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码,请使用选项文件。见第8.1.2.1节,“用户指南:密码安全”。
要显式指定没有密码,并且mysqlcheck不应该提示输入密码,请使用
--skip-password1选项。--password1和--password是同义词,同样地,--skip-password1和--skip-password也是一对同义词。 -
用于MySQL连接到服务器的MySQL账户的第二个多因素认证密码。该选项的语义与
--password1的语义相似;请参阅该选项的描述以获取详细信息。 -
用于MySQL连接到服务器的MySQL账户的第三个多因素认证密码。该选项的语义与
--password1的语义相似;请参阅该选项的描述以获取详细信息。 -
--pipe,-WCommand-Line Format --pipeType 字符串 在Windows上,使用命名管道连接到服务器。这一选项仅适用于服务器以支持命名管道连接的方式启动,并且执行连接的用户必须是指定于
named_pipe_full_access_group系统变量的Windows组成员。 -
Command-Line Format --plugin-dir=dir_nameType 目录名称 用于查找插件的目录。指定此选项如果使用
--default-auth选项指定了认证插件但 mysqlcheck 无法找到它。请参阅 第8.2.17节,“可插拔认证”。 -
--port=,port_num-Pport_numCommand-Line Format --port=port_numType 数字 Default Value 3306用于TCP/IP连接的端口号。
-
Command-Line Format --print-defaults打印程序名称及其来自选项文件的所有选项。
有关此类以及其他影响选项文件处理的命令行选项的详细信息,请参阅 第6.2.2.3节,“影响选项文件处理的命令行选项”。
-
--protocol={TCP|SOCKET|PIPE|MEMORY}Command-Line Format --protocol=typeType 字符串 Default Value [see text]Valid Values TCPSOCKETPIPEMEMORY用于连接到服务器的传输协议。它在其他连接参数通常导致使用不同于您想要的协议时非常有用。在可接受值的详细信息,请参阅 第6.2.7节,“连接传输协议”。
-
--quick,-qCommand-Line Format --quick如果您使用此选项检查表格,它会防止扫描行以检查链接错误。这是最快的检查方法。
如果您使用此选项来修复表格,它将尝试只修复索引树。这是最快的修复方法。
-
--repair,-rCommand-Line Format --repair执行一个修复操作,该操作可以修复几乎所有问题,除了非唯一键不唯一的问题。
-
--server-public-key-path=file_nameCommand-Line Format --server-public-key-path=file_nameType 文件名 服务器端公钥的路径名,用于RSA密钥对密码交换。该选项适用于使用
sha256_password或caching_sha2_password身份验证插件进行客户端认证的客户端。这一选项对于不使用RSA密码交换的客户端(即通过安全连接与服务器通信的客户端)是无效的。如果指定了
--server-public-key-path=并且指定了一个有效的公钥文件,它将优先于file_name--get-server-public-key。对于sha256_password,这项选项仅适用于使用OpenSSL编译的MySQL版本。有关sha256_password和caching_sha2_password插件的信息,请参阅第8.4.1.3节,“SHA-256可插拔身份验证”和第8.4.1.2节,“Caching SHA-2可插拔身份验证”。 -
--shared-memory-base-name=nameCommand-Line Format --shared-memory-base-name=namePlatform Specific Windows在Windows上,用于通过共享内存连接到本地服务器的共享内存名称。默认值为MYSQL。共享内存名称是大小写敏感的。这项选项仅适用于服务器以支持共享内存连接的方式启动,并且启用了shared_memory系统变量。 -
--silent,-sCommand-Line Format --silent静默模式。只打印错误消息。 -
Command-Line Format --skip-database=db_name不包括指定的数据库(大小写敏感)在mysqlcheck执行的操作中。 -
--socket=,path-SpathCommand-Line Format --socket={file_name|pipe_name}Type 字符串对于连接到localhost的连接,Unix套接字文件路径,或在Windows上,命名管道名称。在Windows上,这项选项仅适用于服务器以支持命名管道连接的方式启动,并且启用了named_pipe系统变量。此外,执行连接的用户必须是指定在named_pipe_full_access_group系统变量中定义的Windows组成员。 -
以--ssl开头的选项指定是否使用加密连接,并指示SSL密钥和证书的位置。请参阅命令行选项:加密连接。 -
--ssl-fips-mode={OFF|ON|STRICT}Command-Line Format --ssl-fips-mode={OFF|ON|STRICT}Deprecated 是 Type 枚举值 Default Value OFFValid Values OFFONSTRICT控制是否在客户端启用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_listCommand-Line Format --tls-ciphersuites=ciphersuite_listType 字符串 用于TLSv1.3加密连接的可接受密码套件。值是一个由冒号分隔的密码套件名称列表。可以为此选项命名的密码套件取决于用来编译MySQL的SSL库。详细信息,请参阅第8.3.2节,“加密连接TLS协议和密码套件”。
-
--tls-sni-servername=server_nameCommand-Line Format --tls-sni-servername=server_nameType 字符串 当指定时,名称将传递给
mysql_options()的MYSQL_OPT_TLS_SNI_SERVERNAME选项。服务器名称不区分大小写。要查看客户端为当前会话指定的服务器名称(如果有),请检查Tls_sni_server_name状态变量。Server Name Indication (SNI) 是TLS协议的一个扩展(OpenSSL必须使用TLS扩展编译才能使此选项工作)。MySQL对SNI的实现仅限于客户端侧。
-
Command-Line Format --tls-version=protocol_listType 字符串 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,-vCommand-Line Format --verbose详细模式。打印程序操作的各种阶段信息。
-
--version,-VCommand-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 节,“连接压缩控制”。