Documentation Home
MySQL 8.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 39.8Mb
PDF (A4) - 39.9Mb
Man Pages (TGZ) - 257.9Kb
Man Pages (Zip) - 364.9Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 Reference Manual  /  ...  /  mysqladmin — A MySQL Server Administration Program

6.5.2 mysqladmin — MySQL 服务器管理程序

mysqladmin 是一个用于执行管理操作的客户端程序。您可以使用它来检查服务器的配置和当前状态,创建和删除数据库等。

调用 mysqladmin 如下所示:

mysqladmin [options] command [command-arg] [command [command-arg]] ...

mysqladmin 支持以下命令。一些命令后面还可以跟一个参数。

  • create db_name

    创建一个名为 db_name 的新数据库。

  • debug

    告诉服务器将调试信息写入错误日志。连接的用户必须具有 SUPER 权限。该信息的格式和内容可能会发生变化。

    这还包括事件调度器的信息。请参阅 第 27.4.5 节,“事件调度器状态”

  • drop db_name

    删除名为 db_name 的数据库及其所有表。

  • extended-status

    显示服务器状态变量及其值。

  • flush-hosts

    清空所有主机缓存。请参阅 第 7.1.12.3 节,“DNS 查询和主机缓存”

  • flush-logs [log_type ...]

    清空所有日志。

    mysqladmin flush-logs 命令允许指定要清空的日志类型。命令后面可以跟一个或多个日志类型,使用空格分隔。这些对应于 FLUSH LOGS SQL 语句中可用的日志类型:binaryengineerrorgeneralrelayslow

  • flush-privileges

    重新加载授权表(与 reload 相同)。

  • flush-status

    清除状态变量。

  • flush-tables

    清空所有表。

  • kill id,id,...

    杀死服务器线程。如果提供了多个线程 ID 值,则必须没有空格。

    要杀死其他用户的线程,连接的用户必须具有 CONNECTION_ADMIN 权限(或已弃用的 SUPER 权限)。

  • password new_password

    设置新密码。这将更改用于连接到服务器的帐户的密码。因此,下次您使用 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 命令来更改密码。

  • ping

    检查服务器是否可用。mysqladmin 的返回状态为0,如果服务器正在运行,1如果它没有运行。这是0,即使出现错误,如 Access denied,因为这意味着服务器正在运行但拒绝了连接,这与服务器未运行不同。

  • processlist

    显示活动服务器线程的列表。这就像 SHOW PROCESSLIST 语句的输出。如果提供了 --verbose 选项,输出就像 SHOW FULL PROCESSLIST 的输出。 (请参阅reload

  • reload

    重新加载授权表。

  • refresh

    刷新所有表并关闭和打开日志文件。

  • shutdown

    停止服务器。

  • start-replica

    在复制服务器上启动复制。

  • start-slave

    这是 start-replica 的一个过时别名。

  • status

    显示服务器状态消息的简短版本。

  • stop-replica

    在复制服务器上停止复制。

  • stop-slave

    这是 stop-replica 的一个过时别名。

  • variables

    显示服务器系统变量及其值。

  • version

    显示服务器版本信息。

所有命令都可以缩写为任何唯一前缀。例如:

$> 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命令将显示以下值:

  • Uptime

    MySQL服务器运行的秒数。

  • Threads

    活动线程(客户端)的数量。

  • Questions

    自服务器启动以来从客户端收到的查询数量。

  • Slow queries

    执行时间超过long_ query_time秒的查询数量。请参阅mysqladmin

  • Opens

    服务器打开的表的数量。

  • Flush tables

    服务器执行的flush-*refreshreload命令的数量。

  • Open tables

    当前打开的表的数量。

如果您使用Unix套接字文件连接到本地服务器并执行mysqladmin shutdownmysqladmin将等待服务器的进程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压缩的服务器连接的压缩级别