客户端 mysqlshow 可以快速查看哪些数据库存在、它们的表或表的列或索引。
mysqlshow 提供了命令行接口来几个 SQL SHOW
语句。见 第 15.7.7 节,“SHOW 语句”。同样的信息可以通过直接使用这些语句来获得。例如,您可以从 mysql 客户端程序中发出这些语句。
调用 mysqlshow 如下:
mysqlshow [options] [db_name [tbl_name [col_name]]]
-
如果没有指定数据库,则显示数据库名称列表。
-
如果没有指定表,则显示数据库中的所有匹配表。
-
如果没有指定列,则显示表中的所有匹配列和列类型。
输出仅显示您拥有某些权限的数据库、表或列的名称。
如果最后一个参数包含 shell 或 SQL 通配符 (*
, ?
, %
, 或 _
),则仅显示与通配符匹配的名称。如果数据库名称包含下划线,则应使用反斜杠(某些 Unix shells 需要两个)来获取正确的表或列列表。*
和 ?
字符将被转换为 SQL %
和 _
通配符。这可能会在您尝试显示表名中包含 _
的列时引起一些混淆,因为在这种情况下,mysqlshow 将显示与模式匹配的表名称。可以通过在命令行上添加一个额外的 %
作为单独的参数来轻松解决这个问题。
mysqlshow 支持以下选项,可以在命令行或在 [mysqlshow]
和 [client]
组的选项文件中指定。有关 MySQL 程序使用的选项文件的信息,请参见 第 6.2.2.2 节,“使用选项文件”。
表 6.17 mysqlshow 选项
Option Name | Description |
---|---|
--bind-address | 使用指定的网络接口连接到 MySQL 服务器 |
--character-sets-dir | 字符集目录 |
--compress | 压缩客户端和服务器之间的所有信息 |
--compression-algorithms | 服务器连接的允许压缩算法 |
--count | 显示每个表的行数 |
--debug | 写入调试日志 |
--debug-check | 程序退出时打印调试信息 |
--debug-info | 程序退出时打印调试信息、内存和 CPU 统计信息 |
--default-auth | 身份验证插件 |
--default-character-set | 指定默认字符集 |
--defaults-extra-file | 读取命名的选项文件,除了通常的选项文件 |
--defaults-file | 仅读取命名的选项文件 |
--defaults-group-suffix | 选项组后缀值 |
--启用明文身份验证插件 | 启用 cleartext 身份验证插件 |
--获取服务器公钥 | 从服务器请求 RSA 公钥 |
--帮助 | 显示帮助信息并退出 |
--主机 | MySQL 服务器所在的主机 |
--键 | 显示表索引 |
--登录路径 | 从 .mylogin.cnf 读取登录路径选项 |
--不使用默认值 | 不读取选项文件 |
--不使用登录路径 | 不从登录路径文件中读取登录路径 |
--密码 | 连接到服务器时使用的密码 |
--密码1 | 连接到服务器时使用的第一个多因素身份验证密码 |
--密码2 | 连接到服务器时使用的第二个多因素身份验证密码 |
--密码3 | 连接到服务器时使用的第三个多因素身份验证密码 |
--管道 | 使用命名管道连接到服务器(仅限 Windows) |
--插件目录 | 插件安装的目录 |
--端口 | TCP/IP 端口号 |
--打印默认值 | 打印默认选项 |
--协议 | 用于连接的传输协议 |
--服务器公钥路径 | 包含 RSA 公钥的文件路径 |
--共享内存基础名称 | 共享内存连接的名称(仅限 Windows) |
--显示表类型 | 显示表类型的列 |
--套接字 | Unix 套接字文件或 Windows 命名管道 |
--ssl-ca | 包含受信任的 SSL 证书颁发机构的文件 |
--ssl-capath | 包含受信任的 SSL 证书颁发机构证书文件的目录 |
--ssl-cert | 包含 X.509 证书的文件 |
--ssl-cipher | 连接加密的可接受密码 |
--ssl-crl | 包含证书吊销列表的文件 |
--ssl-crlpath | 包含证书吊销列表文件的目录 |
--ssl-fips 模式 | 是否在客户端启用 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 | 显示版本信息并退出 |
--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 --count
显示每个表的行数。这可能对非
MyISAM
表很慢。 -
--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
。只有在使用
WITH_DEBUG
选项构建 MySQL 时,才可用此选项。 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 发行二进制文件不使用该选项。 -
--default-character-set=
charset_name
Command-Line Format --default-character-set=charset_name
Type 字符串 使用
charset_name
作为默认字符集。见 第 12.15 节,“字符集配置”。 -
Command-Line Format --default-auth=plugin
Type 字符串 客户端身份验证插件的提示。见 第 8.2.17 节,“可插拔身份验证”。
-
--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
后缀的组。例如,mysqlshow 通常读取[client]
和[mysqlshow]
组。如果使用--defaults-group-suffix=_other
,mysqlshow 也将读取[client_other]
和[mysqlshow_other]
组。有关该选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --启用明文插件
Type 布尔值 Default Value FALSE
启用
mysql_clear_password
明文身份验证插件。(见 第 8.4.1.4 节,“客户端明文插件身份验证”。) -
Command-Line Format --获取服务器公钥
Type 布尔值 从服务器请求 RSA 公钥,该公钥用于基于密钥对的密码交换。该选项适用于使用
caching_sha2_password
身份验证插件的客户端连接到服务器的账户。对于使用该插件的账户,服务器不会将公钥发送给客户端,除非请求。该选项被忽略,如果客户端使用安全连接连接到服务器,则 RSA 基于密码交换不需要公钥。如果
--服务器公钥路径=
指定了有效的公钥文件,则它将优先于文件名
--获取服务器公钥
。有关
caching_sha2_password
插件的信息,请参阅 第 8.4.1.2 节,“缓存 SHA-2 插件身份验证”。 -
--主机=
,主机名
-h
主机名
Command-Line Format --主机=主机名
Type 字符串 Default Value localhost
连接到指定主机的 MySQL 服务器。
-
--键
,-k
Command-Line Format --键
显示表索引。
-
Command-Line Format --登录路径=名称
Type 字符串 从命名的登录路径文件中读取选项。
.mylogin.cnf
登录路径文件是一个选项组,指定了连接到哪个 MySQL 服务器和以哪个账户身份验证。要创建或修改登录路径文件,请使用 mysql_config_editor 实用程序。见 第 6.6.7 节,“mysql_config_editor — MySQL 配置实用程序”。有关该选项和其他选项文件选项的更多信息,请参阅 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --不读取登录路径
跳过读取登录路径文件。
见
--登录路径
有关信息。有关该选项和其他选项文件选项的更多信息,请参阅 第 6.2.2.3 节,“命令行选项影响选项文件处理”。
-
Command-Line Format --不读取默认值
不读取任何选项文件。如果程序启动失败是由于从选项文件中读取未知选项,
--不读取默认值
可以用于防止它们被读取。异常是,
.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 帐户的密码。密码值是可选的。如果不给出,mysqlshow 将提示输入。如果给出,必须在
--password=
或-p
和其后的密码之间没有空格。如果没有指定密码选项,默认情况下不发送密码。在命令行上指定密码应该被认为是不安全的。要避免在命令行上给出密码,请使用选项文件。见 第 8.1.2.1 节,“最终用户密码安全指南”。
要明确指定没有密码并且 mysqlshow 不应该提示输入,请使用
--skip-password
选项。 -
用于连接到服务器的 MySQL 帐户的多因素身份验证因子 1 的密码。密码值是可选的。如果不给出,mysqlshow 将提示输入。如果给出,必须在
--password1=
和其后的密码之间没有空格。如果没有指定密码选项,默认情况下不发送密码。在命令行上指定密码应该被认为是不安全的。要避免在命令行上给出密码,请使用选项文件。见 第 8.1.2.1 节,“最终用户密码安全指南”。
要明确指定没有密码并且 mysqlshow 不应该提示输入,请使用
--skip-password1
选项。--password1
和--password
是同义的,如同--skip-password1
和--skip-password
。 -
用于连接到服务器的 MySQL 帐户的多因素身份验证因子 2 的密码。该选项的语义与
--password1
的语义相同;请参阅该选项的描述以获取详细信息。 -
多因素身份验证因子 3 的密码,用于连接到服务器的 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
选项指定身份验证插件,但 mysqlshow 未找到它。请参阅 第 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 节,“连接传输协议”。
-
--server-public-key-path=
file_name
Command-Line Format --server-public-key-path=file_name
Type 文件名称 包含服务器所需的 RSA 密钥对密码交换的客户端副本的公钥文件的路径名称。此选项适用于使用
sha256_password
或caching_sha2_password
身份验证插件的客户端。如果--server-public-key-path=
指定了有效的公钥文件,则它将优先于file_name
--get-server-public-key
。对于
sha256_password
,此选项仅适用于使用 OpenSSL 构建的 MySQL。For
sha256_password
, this option applies only if MySQL was built using OpenSSL.关于
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
系统变量以支持共享内存连接。 -
Command-Line Format --show-table-type
显示表类型的列,如
SHOW FULL TABLES
。类型是BASE TABLE
或VIEW
。 -
--socket=
,path
-S
path
Command-Line Format --socket={file_name|pipe_name}
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 中删除。
-
-
--status
,-i
Command-Line Format --status
显示每个表的额外信息。
-
Command-Line Format --tls-ciphersuites=套件列表
Type 字符串 用于TLSv1.3加密连接的可接受套件列表。该值是一个或多个以冒号分隔的套件名称。可以命名的套件取决于编译MySQL时使用的SSL库。详细信息,请参阅第8.3.2节,“加密连接TLS协议和套件”。
-
Command-Line Format --tls-sni-servername=服务器名称
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=协议列表
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=
,用户名
-u
用户名
Command-Line Format --user=用户名,
Type 字符串 用于连接服务器的MySQL帐户用户名。
-
--verbose
,-v
Command-Line Format --verbose
详细模式。打印程序执行的更多信息。该选项可以多次使用以增加信息量。
-
--version
,-V
Command-Line Format --version
显示版本信息并退出。
-
Command-Line Format --zstd-compression-level=#
Type 整数 用于连接服务器的zstd压缩算法的压缩级别。允许的级别从1到22,较高的值表示增加的压缩级别。默认的zstd压缩级别为3。压缩级别设置对不使用zstd压缩的连接没有影响。
详细信息,请参阅第6.2.8节,“连接压缩控制”。