6.5.2 mysqladmin — MySQL 服务器管理程序
mysqladmin 是一个用于执行管理操作的客户端程序。您可以使用它来检查服务器的配置和当前状态,创建和删除数据库等。
调用 mysqladmin 如下所示:
mysqladmin [options] command [command-arg] [command [command-arg]] ...
mysqladmin 支持以下命令。一些命令后面还可以跟一个参数。
-
创建一个名为
db_name
的新数据库。 -
告诉服务器将调试信息写入错误日志。连接的用户必须具有
SUPER
权限。该信息的格式和内容可能会发生变化。这还包括事件调度器的信息。请参阅 第 27.4.5 节,“事件调度器状态”。
-
删除名为
db_name
的数据库及其所有表。 -
显示服务器状态变量及其值。
-
清空所有主机缓存。请参阅 第 7.1.12.3 节,“DNS 查询和主机缓存”。
-
清空所有日志。
mysqladmin flush-logs 命令允许指定要清空的日志类型。命令后面可以跟一个或多个日志类型,使用空格分隔。这些对应于
FLUSH LOGS
SQL 语句中可用的日志类型:binary
、engine
、error
、general
、relay
和slow
。 -
重新加载授权表(与
reload
相同)。 -
清除状态变量。
-
清空所有表。
-
杀死服务器线程。如果提供了多个线程 ID 值,则必须没有空格。
要杀死其他用户的线程,连接的用户必须具有
CONNECTION_ADMIN
权限(或已弃用的SUPER
权限)。 -
设置新密码。这将更改用于连接到服务器的帐户的密码。因此,下次您使用 mysqladmin (或任何其他客户端程序) 连接到服务器时,您必须指定新密码。
Warning使用 mysqladmin 设置密码应该被认为是不安全的。在某些系统上,您的密码可能会暴露给系统状态程序,如 ps,这些程序可能由其他用户用于显示命令行。MySQL客户端通常在初始化序列中覆盖命令行密码参数,但仍然有一段时间内该值是可见的。此外,在某些系统上,这种覆盖策略无效,密码仍然对 ps 可见。 (可能受此问题影响的SystemV Unix系统以及其他系统。)
如果
new_ password
值包含空格或其他特殊字符,这些字符对您的命令解释器来说是特殊的,您需要将其包围在引号中。在Windows上,请确保使用双引号,而不是单引号;单引号不会从密码中移除,而是被视为密码的一部分。例如:mysqladmin password "my new password"
可以省略
password
命令后的新密码。在这种情况下,mysqladmin 会提示输入密码值,这样可以避免在命令行上指定密码。省略密码值应该只在password
是命令行上的最后一个命令时才做。如果不这样做,下一个参数将被视为密码。Caution不要使用该命令,如果服务器以包含
--skip-grant-tables
选项启动的方式运行。即使您在同一行命令中使用flush-privileges
命令来重新启用授权表,因为刷新操作发生在连接后,这种情况下密码更改也不会生效。不过,您可以使用 mysqladmin flush-privileges 来重新启用授权表,然后使用单独的 mysqladmin password 命令来更改密码。 -
检查服务器是否可用。mysqladmin 的返回状态为0,如果服务器正在运行,1如果它没有运行。这是0,即使出现错误,如
Access denied
,因为这意味着服务器正在运行但拒绝了连接,这与服务器未运行不同。 -
显示活动服务器线程的列表。这就像
SHOW PROCESSLIST
语句的输出。如果提供了--verbose
选项,输出就像SHOW FULL PROCESSLIST
的输出。 (请参阅reload
-
重新加载授权表。
-
刷新所有表并关闭和打开日志文件。
-
停止服务器。
-
在复制服务器上启动复制。
-
这是
start-replica
的一个过时别名。 -
显示服务器状态消息的简短版本。
-
在复制服务器上停止复制。
-
这是
stop-replica
的一个过时别名。 -
显示服务器系统变量及其值。
-
显示服务器版本信息。
所有命令都可以缩写为任何唯一前缀。例如:
$> mysqladmin proc stat
+----+-------+-----------+----+---------+------+-------+------------------+
| Id | User | Host | db | Command | Time | State | Info |
+----+-------+-----------+----+---------+------+-------+------------------+
| 51 | jones | localhost | | Query | 0 | | show processlist |
+----+-------+-----------+----+---------+------+-------+------------------+
Uptime: 1473624 Threads: 1 Questions: 39487
Slow queries: 0 Opens: 541 Flush tables: 1
Open tables: 19 Queries per second avg: 0.0268
执行mysqladmin status命令将显示以下值:
-
MySQL服务器运行的秒数。
-
活动线程(客户端)的数量。
-
自服务器启动以来从客户端收到的查询数量。
-
执行时间超过
long_ query_time
秒的查询数量。请参阅mysqladmin。 -
服务器打开的表的数量。
-
服务器执行的
flush-*
、refresh
和reload
命令的数量。 -
当前打开的表的数量。
如果您使用Unix套接字文件连接到本地服务器并执行mysqladmin shutdown,mysqladmin将等待服务器的进程ID文件被删除,以确保服务器已停止正确。
mysqladmin支持以下选项,可以在命令行或[mysqladmin]和[client]组中的选项文件中指定。有关MySQL程序使用选项文件的信息,请参阅mysqladmin。
表6.11 mysqladmin选项
Option Name | Description |
---|---|
--bind-address | 使用指定的网络接口连接到MySQL服务器 |
--character-sets-dir | 字符集可以找到到的目录 |
--compress | 压缩客户端和服务器之间发送的所有信息 |
--compression-algorithms | 连接到服务器时允许的压缩算法 |
--connect-timeout | 连接超时的秒数 |
--count | 重复命令执行的迭代次数 |
--debug | 写入调试日志 |
--debug-check | 程序退出时打印调试信息 |
--debug-info | 程序退出时打印调试信息、内存和CPU统计信息 |
--default-auth | 使用的身份验证插件 |
--default-character-set | 指定默认字符集 |
--defaults-extra-file | 读取额外的选项文件 |
--defaults-file | 只读指定的选项文件 |
--defaults-group-suffix | 选项组后缀值 |
--enable-cleartext-plugin | 启用明文认证插件 |
--force | 即使发生SQL错误也继续 |
--get-server-public-key | 从服务器请求RSA公钥 |
--help | 显示帮助信息并退出 |
--host | MySQL服务器所在主机 |
--login-path | 从~/.mylogin.cnf读取登录路径选项 |
--no-beep | 在发生错误时不发出声音 |
--no-defaults | 不读取默认选项文件 |
--no-login-paths | 不从登录路径文件中读取登录路径 |
--password | 连接到服务器时使用的密码 |
--password1 | 用于连接到服务器的第一个多因素认证密码 |
--password2 | 用于连接到服务器的第二个多因素认证密码 |
--password3 | 用于连接到服务器的第三个多因素认证密码 |
--pipe | (仅Windows) 使用命名管道连接到服务器 |
--plugin-dir | 插件安装目录 |
--port | TCP/IP端口号 |
--print-defaults | 打印默认选项 |
--protocol | 使用的传输协议 |
--relative | 与--sleep选项一起使用时显示当前和之前值之间的差异 |
--server-public-key-path | RSA公钥文件路径名 |
--shared-memory-base-name | (仅Windows) 共享内存名称(用于共享内存连接) |
--show-warnings | 执行语句后显示警告信息 |
--shutdown-timeout | 服务器关闭等待的最大秒数 |
--silent | 静默模式 |
--sleep | 重复执行命令,间隔delay秒 |
--socket | (Unix) 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 | 是否在会话重用失败时建立连接 |
--tls-ciphersuites | 用于加密连接的TLSv1.3合并套件 |
--tls-sni-servername | 客户端提供的服务器名称 |
--tls-version | 用于加密连接的TLS协议版本 |
--user | 连接到服务器时使用的MySQL用户名 |
--verbose | 详细模式 |
--version | 显示版本信息并退出 |
--vertical | 以垂直方式打印查询输出行(每个列值占一行) |
--wait | 如果无法建立连接,等待并重试而不是中止 |
--zstd-compression-level | 使用zstd压缩的服务器连接的压缩级别 |
-
--help
,-?
Command-Line Format --help
显示帮助信息并退出。
-
Command-Line Format --bind-address=ip_地址
在具有多个网络接口的计算机上,使用此选项选择用于连接到MySQL服务器的接口。
-
Command-Line Format --character-sets-dir=路径
Type 字符串 Default Value [none]
字符集安装目录。请参阅第12.15节,“字符集配置”。
-
--compress
,-C
Command-Line Format --compress[={OFF|ON}]
Deprecated 是的 Type 布尔值 Default Value OFF
如果可能,压缩客户端和服务器之间发送的所有信息。请参阅第6.2.8节,“连接压缩控制”。
此选项已被弃用。预计将在MySQL的未来版本中移除。请参阅配置遗留连接压缩。
-
Command-Line Format --compression-algorithms=值
Type 设置 Default Value uncompressed
Valid Values zlib
zstd
uncompressed
用于连接到服务器的允许压缩算法。可用的算法与
protocol_compression_algorithms
系统变量相同。默认值为uncompressed
。更多信息,请参阅第6.2.8节,“连接压缩控制”。
-
Command-Line Format --connect-timeout=值
Type 数字 Default Value 43200
连接超时的最大秒数。默认值为43200(12小时)。
-
--count=
,N
-c
N
Command-Line Format --count=#
重复命令执行的迭代次数,如果给出了
--sleep
选项。 -
--debug[=
,debug_options
]-# [
debug_options
]Command-Line Format --debug[=debug_options]
Type 字符串 Default Value d:t:o,/tmp/mysqladmin.trace
写入调试日志。一个典型的
WITH_DEBUG
字符串是d:t:o,
。默认值为file_name
d:t:o,/tmp/mysqladmin.trace
。这个选项只有在使用
WITH_DEBUG
编译MySQL时才可用。Oracle提供的MySQL发布版本是不使用这个选项。 -
Command-Line Format --debug-check
Type 布尔值 Default Value FALSE
程序退出时打印一些调试信息。
这个选项只有在使用
WITH_DEBUG
编译MySQL时才可用。Oracle提供的MySQL发布版本是不使用这个选项。 -
Command-Line Format --debug-info
Type 布尔值 Default Value FALSE
程序退出时打印调试信息和内存和CPU使用统计。
这个选项只有在使用
WITH_DEBUG
编译MySQL时才可用。Oracle提供的MySQL发布版本是不使用这个选项。 -
Command-Line Format --default-auth=plugin
Type 字符串 关于客户端身份验证插件的提示。见第8.2.17节,“可插拔身份验证”。
-
--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 文件名 在全局选项文件之后但在用户选项文件之前读取这个选项文件。如果文件不存在或无法访问,会发生错误。如果
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
的组。例如,mysqladmin 通常读取[client]
和[mysqladmin]
组。如果给出如--defaults-group-suffix=_other
,mysqladmin 也读取[client_other]
和[mysqladmin_other]
组。有关此和其他选项文件选项的更多信息,请参阅第6.2.2.3节,“命令行选项对选项文件处理的影响”。
-
Command-Line Format --enable-cleartext-plugin
Type 布尔值 Default Value FALSE
启用
mysql_clear_password
清文本认证插件。请参阅第8.4.1.4节,“客户端清文本可插拔认证”。 -
--force
,-f
Command-Line Format --force
不要对
drop
命令询问确认。对于多个命令,继续即使发生错误。db_name
-
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 String 从命名登录路径中读取选项,位于
.mylogin.cnf
登录路径文件中。一个 “登录路径” 是包含指定连接到哪个MySQL服务器以及以何种身份进行认证的选项组。要创建或修改登录路径文件,请使用 mysql_config_editor 工具。参见第6.6.7节,“mysql_config_editor — MySQL 配置工具”。关于此类选项文件选项的更多信息,请参见第6.2.2.3节,“cmd-line_options that Affect Option-File Handling”。
-
Command-Line Format --no-login-paths
跳过读取登录路径文件中的选项。
有关此选项的相关信息,请参见
--login-path
。关于此类选项文件选项的更多信息,请参见第6.2.2.3节,“cmd-line_options that Affect Option-File Handling”。
-
--no-beep
,-b
Command-Line Format --no-beep
抑制默认情况下发出警告的蜂鸣声,例如连接到服务器失败时。
-
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节,“cmd-line_options that Affect Option-File Handling”。
-
--password[=
,密码
]-p[
密码
]Command-Line Format --password[=password]
Type 字符串 MySQL账户用于连接到服务器的密码。密码值是可选的。如果不给出,mysqladmin 将提示输入一个。如果给出,那么必须在
--password=
或-p
后面没有空格地指定密码。如果不指定密码选项,缺省行为是发送无密码。在命令行上指定密码应该被认为是不安全的。为了避免在命令行上给出密码,请使用选项文件。参见第8.1.2.1节,“end-User Guidelines for Password Security”。
要明确指定没有密码,并且 mysqladmin 不应该提示输入一个,请使用
--skip-password
选项。 -
MySQL账户用于连接到服务器的多因素认证因素1的密码。密码值是可选的。如果不给出,mysql会提示输入一个。如果给出,那么在
--password1=
后面不能有空格。如果没有指定密码选项,默认情况下不会发送密码。在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码,请使用选项文件。请参阅第8.1.2.1节,“用户密码安全指南”。
要明确指定没有密码,并且mysqladmin不应该提示输入一个,请使用
--skip-password1
选项。--password1
和--password
是同义词,--skip-password1
和--skip-password
也是同义词。 -
MySQL账户用于连接到服务器的多因素认证因素2的密码。这个选项的语义与
--password1
的语义相同;请参阅该选项的描述。 -
MySQL账户用于连接到服务器的多因素认证因素3的密码。这个选项的语义与
--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
选项指定了一个认证插件,但mysqladmin找不到它。请参阅第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节,“连接传输协议”。
-
--relative
,-r
Command-Line Format --relative
当与
--sleep
选项一起使用时,显示当前值和之前值之间的差异。这一选项仅适用于extended-Status
命令。 -
--server-public-key-path=
file_name
Command-Line Format --server-public-key-path=file_name
Type 文件名 用于RSA密钥对密码交换所需的客户端公钥路径。该选项适用于使用SHA-256插件或缓存SHA-2插件进行身份验证的客户端。该选项对于不使用RSA密码交换或通过安全连接与服务器通信的客户端无效。此外,如果指定了有效的公钥文件路径,该选项将优先于
--get-server-public-key
。对于SHA-256插件,该选项仅在MySQL使用OpenSSL进行构建时才适用。
有关SHA-256插件和缓存SHA-2插件的信息,请参阅第 8.4.1.3节,“SHA-256可插拔身份验证”和第 8.4.1.2节,“缓存SHA-2可插拔身份验证”。
-
--shared-memory-base-name=name
Command-Line Format Windows Platform Specific 在Windows上,用于通过共享内存连接到本地服务器的共享内存名称。默认值为 MYSQL
。共享内存名称不区分大小写。该选项仅适用于服务器在支持共享内存连接时启动,并且
shared_ memory
系统变量被启用。 -
--show-warnings
Command-Line Format 显示执行在服务器上的语句时产生的警告。 -
--shutdown-timeout=seconds
Command-Line Format 数字 Type 3600
Default Value 服务器关闭等待的最大秒数。默认值为3600(1小时)。 --silent
,-s
-
--silent
Command-Line Format 如果无法建立到服务器的连接,则静默退出。 --sleep=
,delay
-i
delay
-
--sleep=delay
Command-Line Format --sleep=delay
重复执行命令,之间睡眠
延迟
秒。选项--count
决定迭代次数。如果没有给出--count
,mysqladmin 将无限执行命令直到被中断。 -
--socket=
,路径
-S
路径
Command-Line Format --socket={文件名|管道名}
Type 字符串 对于连接到
localhost
,要使用的 Unix 套接字文件,或在 Windows 上,要使用的命名管道名称。在 Windows 上,这个选项仅适用于服务器以支持命名管道连接方式启动时启用。另外,执行连接的用户必须是 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-
选项不同,xxx
--ssl-fips-mode
并非用于建立加密连接,而是用来影响哪些加密操作被允许。请参阅第 8.8 节,“FIPS 支持”。这些
--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 --tls-ciphersuites=密码套件列表
Type 字符串 用于使用 TLSv1.3 加密连接的可接受密码套件。值是一个或多个以冒号分隔的密码套件名称列表。可以为这个选项命名的密码套件取决于用来编译 MySQL 的 SSL 库。请参阅第 8.3.2 节,“加密连接 TLS 协议和密码”。
-
Command-Line Format --tls-sni-servername=server_name
Type 字符串 当指定时,名称将被传递给
libmysqlclient
C API 库,使用MYSQL_OPT_TLS_SNI_SERVERNAME
选项调用mysql_options()
。服务器名称不区分大小写。要显示客户端为当前会话指定的服务器名称(如果有),请检查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 协议和密码”。
-
--user=
,user_name
-u
user_name
Command-Line Format --user=user_name,
Type 字符串 用于连接到服务器的 MySQL 账户的用户名称。
如果您使用
Rewriter
插件,授予该用户SKIP_QUERY_REWRITE
权限。 -
--verbose
,-v
Command-Line Format --verbose
详细模式。打印程序执行的更多信息。
-
--version
,-V
Command-Line Format --version
显示版本信息并退出。
-
--vertical
,-E
Command-Line Format --vertical
以垂直方式打印输出。这与
--relative
相似,但以垂直方式打印。 -
--wait[=
,count
]-w[
count
]Command-Line Format --wait
如果连接无法建立,等待并重试,而不是中止。若提供
count
值,它表示重试次数的数量。默认为一次重试。 -
--zstd-compression-level=
level
Command-Line Format --zstd-compression-level=#
Type 整数 用于连接到服务器的
zstd
压缩算法的压缩级别。允许的级别从 1 到 22,较大的值表示更高的压缩级别。默认的zstd
压缩级别为 3。压缩级别设置对不使用zstd
压缩的连接无效。更多信息,请参阅 第 6.2.8 节,“连接压缩控制”。