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 LOGSSQL 语句中可以指定的日志类型。 -
重新加载授权表(与
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=pathType 字符串 Default Value [none]字符集安装的目录。参见第 12.15 节,“字符集配置”。
-
--compress,-CCommand-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 节,“连接压缩控制”。
-
Command-Line Format --connect-timeout=valueType 数字 Default Value 43200连接超时前的最大秒数。默认值为 43200(12 小时)。
-
--count=,N-cNCommand-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_named:t:o,/tmp/mysqladmin.trace。只有在 MySQL 使用
WITH_DEBUG选项构建时才可用。 Oracle 提供的 MySQL 发行二进制文件不使用这个选项。 -
Command-Line Format --debug-checkType 布尔值 Default Value FALSE程序退出时打印一些调试信息。
只有在 MySQL 使用
WITH_DEBUG选项构建时才可用。 Oracle 提供的 MySQL 发行二进制文件不使用这个选项。 -
Command-Line Format --debug-infoType 布尔值 Default Value FALSE程序退出时打印调试信息和内存和 CPU 使用情况统计信息。
只有在 MySQL 使用
WITH_DEBUG选项构建时才可用。 Oracle 提供的 MySQL 发行二进制文件不使用这个选项。 -
Command-Line Format --default-auth=pluginType 字符串 客户端身份验证插件的提示。见第 8.2.17 节,“可插拔身份验证”。
-
--default-character-set=charset_nameCommand-Line Format --default-character-set=charset_nameType 字符串 使用
charset_name作为默认字符集。见第 12.15 节,“字符集配置”。 -
--defaults-extra-file=file_nameCommand-Line Format --defaults-extra-file=file_nameType 文件名 在全局选项文件之后但(在 Unix 上)在用户选项文件之前读取这个选项文件。如果文件不存在或不可访问,将发生错误。如果
file_name不是绝对路径名,则相对于当前目录进行解释。有关这个和其他选项文件选项的更多信息,请参见第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --defaults-file=file_nameType 文件名 仅使用给定的选项文件。如果文件不存在或不可访问,将发生错误。如果
file_name不是绝对路径名,则相对于当前目录进行解释。异常:即使使用
--defaults-file,客户端程序读取.mylogin.cnf。有关此选项和其他选项文件选项的更多信息,请参阅 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --defaults-group-suffix=strType 字符串 不仅读取通常的选项组,还读取具有通常名称和
str后缀的组。例如, mysqladmin 通常读取[client]和[mysqladmin]组。如果给出这个选项为--defaults-group-suffix=_other, mysqladmin 也读取[client_other]和[mysqladmin_other]组。有关此选项和其他选项文件选项的更多信息,请参阅 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --enable-cleartext-pluginType 布尔值 Default Value FALSE启用
mysql_clear_password明文身份验证插件。(参阅 第 8.4.1.4 节,“客户端明文可插拔身份验证”。) -
--force,-fCommand-Line Format --force不要确认
drop命令。在多个命令中,即使出现错误,也继续执行。db_name -
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 节,“caching SHA-2 可插拔身份验证”。 -
--host=,host_name-hhost_nameCommand-Line Format --host=host_nameType 字符串 Default Value localhost连接到给定的主机上的 MySQL 服务器。
-
Command-Line Format --login-path=nameType 字符串 从命名的登录路径文件中读取选项。
.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,-bCommand-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,-WCommand-Line Format --pipeType 字符串 在 Windows 上,使用命名管道连接到服务器。该选项仅在服务器启用了
named_pipe系统变量以支持命名管道连接时生效。此外,进行连接的用户必须是 Windows 组named_pipe_full_access_group的成员。 -
Command-Line Format --plugin-dir=dir_nameType 目录名称 查找插件的目录。如果使用
--default-auth选项指定身份验证插件,但 mysqladmin 未找到它。请参阅 第 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 节,“影响选项文件处理的命令行选项”。
-
Command-Line Format --协议=typeType 字符串 Default Value [见文本]Valid Values TCPSOCKETPIPEMEMORY用于连接到服务器的传输协议。当其他连接参数通常导致使用其他协议时,该选项非常有用。有关允许值的详细信息,请参阅 第 6.2.7 节,“连接传输协议”。
-
--相对,-rCommand-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 小时)。
-
--沉默,-sCommand-Line Format --沉默如果无法建立与服务器的连接,则退出沉默。
-
--睡眠=,延迟-i延迟Command-Line Format --睡眠=延迟重复执行命令,睡眠
delay秒,然后继续执行。--count选项确定迭代次数。如果没有给出--count,则 mysqladmin 将无限期地执行命令,直到被中断。 -
--socket=,path-SpathCommand-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 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 中删除。
-
-
--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 字符串 当指定时,名称将传递给
libmysqlclientC API 库,使用MYSQL_OPT_TLS_SNI_SERVERNAME选项的mysql_options()。服务器名称不区分大小写。要显示客户端指定的当前会话的服务器名称(如果有),请检查Tls_sni_server_name状态变量。服务器名称指示(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 协议和密码”。
-
--user=,user_name-uuser_nameCommand-Line Format --user=user_name,Type 字符串 用于连接到服务器的 MySQL 帐户的用户名。
如果您使用
Rewriter插件,请授予该用户SKIP_QUERY_REWRITE权限。 -
--verbose,-vCommand-Line Format --verbose详细模式。打印程序执行的更多信息。
-
--version,-VCommand-Line Format --version显示版本信息并退出。
-
--vertical,-ECommand-Line Format --vertical垂直打印输出。这类似于
--relative,但垂直打印输出。 -
--wait[=,count]-w[count]Command-Line Format --wait如果无法建立连接,请等待并重试,而不是中止。如果提供了
count值,它将指示重试的次数。默认值为一次。 -
--zstd-compression-level=levelCommand-Line Format --zstd-compression-level=#Type 整数 用于连接到服务器的压缩级别,该服务器使用
zstd压缩算法。允许的级别从 1 到 22,较高的值表示增加的压缩级别。默认的zstd压缩级别为 3。压缩级别设置对不使用zstd压缩的连接没有影响。有关更多信息,请参阅 第 6.2.8 节,“连接压缩控制”。