mysqladmin 是一个用于执行管理操作的客户端。你可以使用它来检查服务器的配置和当前状态,创建和删除数据库,等等。
使用以下方式调用 mysqladmin:
mysqladmin [options] command [command-arg] [command [command-arg]] ...
mysqladmin 支持以下命令。一些命令在命令名称后面需要一个参数。
-
创建一个名为
db_name
的新数据库。 -
在 MySQL 8.0.20 之前,告诉服务器将调试信息写入错误日志。连接的用户必须具有
SUPER
权限。该信息的格式和内容可能会更改。这包括关于事件计划程序的信息。见 第 27.4.5 节,“事件计划程序状态”。
-
删除名为
db_name
的数据库及其所有表。 -
显示服务器状态变量及其值。
-
刷新主机缓存中的所有信息。见 第 7.1.12.3 节,“DNS 查找和主机缓存”。
-
刷新所有日志。
该 mysqladmin flush-logs 命令允许指定要刷新的日志类型。可以在
flush-logs
命令后提供一个或多个日志类型的空格分隔列表:binary
、engine
、error
、general
、relay
、slow
。这些对应于FLUSH LOGS
SQL 语句中可以指定的日志类型。 -
重新加载授权表(与
reload
相同)。 -
清除状态变量。
-
刷新所有表。
-
杀死服务器线程。如果提供了多个线程 ID 值,则列表中不能有空格。
要杀死属于其他用户的线程,连接的用户必须具有
CONNECTION_ADMIN
权限(或已弃用的SUPER
权限)。 -
设置新密码。这将更改 mysqladmin 连接到服务器时使用的账户的密码。因此,下次使用相同账户调用 mysqladmin(或任何其他客户端程序)时,必须指定新密码。
Warning使用 mysqladmin 设置密码应该被认为 不安全。在某些系统上,您的密码可能会被系统状态程序如 ps 所见,可能会被其他用户调用以显示命令行。MySQL 客户端通常在初始化序列中覆盖命令行密码参数,但是在某些系统上,这种策略无效,密码仍然对 ps 可见。(SystemV Unix 系统和其他系统可能存在这个问题。)
如果
new_password
值包含空格或其他特殊字符,请将其括在引号中。在 Windows 上,请使用双引号而不是单引号;单引号不会从密码中删除,而是作为密码的一部分被解释。例如:mysqladmin password "my new password"
新的密码可以在
password
命令后省略。mysqladmin 将提示输入密码值,从而避免在命令行中指定密码。省略密码值应该仅在password
是 mysqladmin 命令行的最后一个命令时进行。否则,下一个参数将被视为密码。Caution如果服务器以
--skip-grant-tables
选项启动,请不要使用该命令。密码更改将不生效。这甚至适用于在同一命令行上使用flush-privileges
重新启用授权表,因为刷新操作是在连接后进行的。但是,您可以使用 mysqladmin flush-privileges 重新启用授权表,然后使用单独的 mysqladmin password 命令更改密码。 -
检查服务器是否可用。mysqladmin 的返回状态为 0 表示服务器正在运行,1 表示服务器不可用。这甚至适用于错误情况,如
Access denied
,因为这意味着服务器正在运行,但拒绝了连接,这与服务器不可用不同。 -
显示活动服务器线程列表。这类似于
SHOW PROCESSLIST
语句的输出。如果给出了--verbose
选项,输出将类似于SHOW FULL PROCESSLIST
。(见 第 15.7.7.31 节,“SHOW PROCESSLIST 语句”。) -
重新加载授权表。
-
刷新所有表并关闭和打开日志文件。
-
停止服务器。
-
在副本服务器上启动复制。
-
这是 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 状态 结果显示以下值:
-
MySQL 服务器已经运行的秒数。
-
活动线程(客户端)的数量。
-
自服务器启动以来从客户端收到的查询数量。
-
查询时间超过
long_query_time
秒的数量。见 第 7.4.5 节,“慢查询日志”。 -
服务器已经打开的表数量。
-
服务器执行的
flush-*
、refresh
和reload
命令的数量。 -
当前打开的表数量。
如果您在使用 Unix 套接字文件连接到本地服务器时执行 mysqladmin shutdown,mysqladmin 将等待服务器的进程 ID 文件被删除,以确保服务器已经正确停止。
mysqladmin 支持以下选项,可以在命令行或在 [mysqladmin]
和 [client]
组的选项文件中指定。有关 MySQL 程序使用的选项文件的信息,请参见 第 6.2.2.2 节,“使用选项文件”。
表 6.12 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 套接字文件或 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_address
在具有多个网络接口的计算机上,使用此选项选择用于连接到MySQL服务器的接口。
-
Command-Line Format --character-sets-dir=path
Type 字符串 Default Value [none]
字符集安装的目录。参见第 12.15 节,“字符集配置”。
-
--compress
,-C
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 节,“连接压缩控制”。
-
Command-Line Format --connect-timeout=value
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
写入调试日志。典型的
debug_options
字符串是d:t:o,
。默认是file_name
d:t:o,/tmp/mysqladmin.trace
。只有在 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 布尔值 Default Value FALSE
程序退出时打印调试信息和内存和 CPU 使用情况统计信息。
只有在 MySQL 使用
WITH_DEBUG
选项构建时才可用。 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 文件名 在全局选项文件之后但(在 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
后缀的组。例如, 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 节,“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 节,“命令行选项影响选项文件处理”。
-
--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 节,“命令行选项影响选项文件处理”。
-
--password[=
,password
]-p[
password
]Command-Line Format --password[=password]
Type 字符串 用于连接到服务器的 MySQL 账户的密码。密码值是可选的。如果不提供,mysqladmin 将提示输入密码。如果提供,必须在
--password=
或-p
和其后的密码之间没有空格。如果不指定密码选项,默认情况下不发送密码。在命令行上指定密码应该被认为是不安全的。要避免在命令行上指定密码,请使用选项文件。见第 8.1.2.1 节,“最终用户密码安全指南”。
要明确指定没有密码并且mysqladmin 不应该提示输入密码,请使用
--skip-password
选项。 -
多因素身份验证的 MySQL 帐户的密码,用于连接到服务器。密码值是可选的。如果不提供,将提示输入密码。如果提供,必须紧跟在 mysql 后面,不允许有空格。如果不指定密码选项,默认情况下不发送密码。
在命令行中指定密码被认为是不安全的。为了避免在命令行中输入密码,请使用选项文件。请参阅 第 8.1.2.1 节,“最终用户密码安全指南”。
要明确指定没有密码并且 mysqladmin 不应该提示输入密码,请使用
--skip-password1
选项。--password1
和--password
是同义的,如同--skip-password1
和--skip-password
。 -
多因素身份验证的第二个因素的密码,用于连接到 MySQL 服务器。该选项的语义与
--password1
相似;请参阅该选项的描述以获取详细信息。 -
多因素身份验证的第三个因素的密码,用于连接到 MySQL 服务器。该选项的语义与
--password1
相似;请参阅该选项的描述以获取详细信息。 -
--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
选项指定身份验证插件,但 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 节,“影响选项文件处理的命令行选项”。
-
Command-Line Format --协议=type
Type 字符串 Default Value [见文本]
Valid Values TCP
SOCKET
PIPE
MEMORY
用于连接到服务器的传输协议。当其他连接参数通常导致使用其他协议时,该选项非常有用。有关允许值的详细信息,请参阅 第 6.2.7 节,“连接传输协议”。
-
--相对
,-r
Command-Line Format --相对
当与
--睡眠
选项一起使用时,显示当前和前一个值之间的差异。此选项仅适用于extended-status
命令。 -
Command-Line Format --服务器公共密钥路径=文件名
Type 文件名 包含服务器所需的 RSA 密钥对的客户端副本的文件路径名,该密钥对用于基于密码交换的身份验证。此选项仅适用于使用
sha256_password
或caching_sha2_password
身份验证插件的客户端。如果客户端使用安全连接连接到服务器,则忽略此选项。如果指定了
--服务器公共密钥路径=
并指定了有效的公共密钥文件,则它将优先于文件名
--获取服务器公共密钥
。对于
sha256_password
,此选项仅在 MySQL 使用 OpenSSL 构建时适用。有关
sha256_password
和caching_sha2_password
插件的信息,请参阅 第 8.4.1.3 节,“SHA-256 可插拔身份验证” 和 第 8.4.1.2 节,“缓存 SHA-2 可插拔身份验证”。 -
Command-Line Format --共享内存基准名称=名称
Platform Specific Windows 在 Windows 上,对于使用共享内存连接到本地服务器的共享内存名称。默认值为
MYSQL
。共享内存名称区分大小写。此选项仅在服务器启用
共享内存
系统变量以支持共享内存连接时适用。 -
Command-Line Format --显示警告
显示从服务器执行语句生成的警告。
-
Command-Line Format --关闭超时=秒
Type 数字 Default Value 3600
服务器关闭的最大等待时间(以秒为单位)。默认值为 3600(1 小时)。
-
--沉默
,-s
Command-Line Format --沉默
如果无法建立与服务器的连接,则退出沉默。
-
--睡眠=
,延迟
-i
延迟
Command-Line Format --睡眠=延迟
重复执行命令,睡眠
delay
秒,然后继续执行。--count
选项确定迭代次数。如果没有给出--count
,则 mysqladmin 将无限期地执行命令,直到被中断。 -
--socket=
,path
-S
path
Command-Line Format --socket={文件名|管道名}
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 中删除。
-
-
--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 字符串 当指定时,名称将传递给
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 协议和密码”。
-
--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 节,“连接压缩控制”。