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
,-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 --check
检查表格以查找错误。这是默认操作。
-
Command-Line Format --check-only-changed
仅检查自上次检查以来已更改或未正确关闭的表格。
-
--check-upgrade
,-g
Command-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=
value
Command-Line Format --compression-algorithms=value
Type 设置 Default Value uncompressed
Valid Values zlib
zstd
uncompressed
用于连接到服务器的允许压缩算法。可用的算法与
protocol_compression_algorithms
系统变量相同。默认值为uncompressed
。更多信息,请参阅 第 6.2.8 节,“连接压缩控制”。
-
--databases
,-B
Command-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_name
d:t:o
。此选项仅在 MySQL 使用
WITH_ DEBUG
时可用。Oracle 提供的 MySQL 发行版是 不 使用此选项构建的。 -
Command-Line Format --debug-check
Type 布尔值 Default Value FALSE
程序退出时打印一些调试信息。
此选项仅在 MySQL 使用
WITH_ DEBUG
时可用。Oracle 提供的 MySQL 发行版是 不 使用此选项构建的。 -
Command-Line Format --debug-info
Type Boolean 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节,“Character Set Configuration”。 -
--defaults-extra-file=
file_name
Command-Line Format --defaults-extra-file=file_name
Type 文件名 在全局选项文件之后但在用户选项文件之前(在Unix上)读取此选项文件。如果
file_name
不是绝对路径名,它将相对于当前目录解释。有关此和其他影响选项文件处理的命令行选项的更多信息,请参阅第6.2.2.3节,“Command-Line Options that Affect Option-File Handling”。
-
Command-Line Format --defaults-file=file_name
Type 文件名 仅使用给定的选项文件。如果文件不存在或无法访问,会发生错误。如果
file_name
不是绝对路径名,它将相对于当前目录解释。例外情况,即使有
--defaults-file
,客户端程序仍然读取.mylogin.cnf
。有关此和其他影响选项文件处理的命令行选项的更多信息,请参阅第6.2.2.3节,“Command-Line Options that Affect Option-File Handling”。
-
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节,“Command-Line Options that Affect Option-File Handling”。
-
--extended
,-e
Command-Line Format --extended
如果您使用此选项来检查表格,它将确保它们是100%一致的,但这需要很长时间。
如果您使用此选项来修复表格,它将运行一个扩展的修复操作,这可能不仅需要很长时间执行,而且还可能产生大量垃圾行!
-
Command-Line Format --default-auth=plugin
Type 字符串 关于哪个客户端认证插件应该使用的提示。请参阅第8.2.17节,“Pluggable Authentication”。
-
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 节,“缓存 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 字符串 从命名的登录路径中读取选项。一个 “登录路径” 是包含指定 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-check
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 配置工具”。有关此类选项文件处理命令行选项的更多信息,请见第6.2.2.3节,“影响选项文件处理的命令行选项”。
-
--optimize
,-o
Command-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
,-W
Command-Line Format --pipe
Type 字符串 在Windows上,使用命名管道连接到服务器。这一选项仅适用于服务器以支持命名管道连接的方式启动,并且执行连接的用户必须是指定于
named_pipe_full_access_group
系统变量的Windows组成员。 -
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 [see text]
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
,这项选项仅适用于使用OpenSSL编译的MySQL版本。有关
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
系统变量。此外,执行连接的用户必须是指定在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 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 字符串 用于TLSv1.3加密连接的可接受密码套件。值是一个由冒号分隔的密码套件名称列表。可以为此选项命名的密码套件取决于用来编译MySQL的SSL库。详细信息,请参阅第8.3.2节,“加密连接TLS协议和密码套件”。
-
--tls-sni-servername=
server_name
Command-Line Format --tls-sni-servername=server_name
Type 字符串 当指定时,名称将传递给
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_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 节,“连接压缩控制”。