mysqlshow 客户端可用于快速查看哪些数据库存在、它们的表或表的列或索引。
mysqlshow 为多个 SQL SHOW 语句提供了命令行界面。请参阅 第 15.7.7 节,“SHOW 语句”。使用这些语句可以直接获得相同的信息。例如,您可以从 mysql 客户端程序发出这些语句。
像这样调用 mysqlshow
mysqlshow [options] [db_name [tbl_name [col_name]]]
如果未给出数据库,则显示数据库名称列表。
如果未给出表,则显示数据库中所有匹配的表。
如果未给出列,则显示表中所有匹配的列和列类型。
输出仅显示您具有某些权限的那些数据库、表或列的名称。
如果最后一个参数包含 shell 或 SQL 通配符 (*、?、% 或 _),则仅显示与通配符匹配的那些名称。如果数据库名称包含任何下划线,则应使用反斜杠 (某些 Unix shell 需要两个) 对其进行转义,以获取正确表的列表或列。 * 和 ? 字符将转换为 SQL % 和 _ 通配符。当您尝试显示包含 _ 的表的列时,这可能会造成一些混乱,因为在这种情况下,mysqlshow 仅向您显示与模式匹配的表名。这很容易解决,只需在命令行上添加一个额外的 % 作为单独的参数即可。
mysqlshow 支持以下选项,这些选项可以在命令行或选项文件中指定 [mysqlshow] 和 [client] 组。有关 MySQL 程序使用的选项文件的信息,请参阅 第 6.2.2.2 节,“使用选项文件”.
表 6.15 mysqlshow 选项
| 选项名称 | 描述 |
|---|---|
| --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 | 选项组后缀值 |
| --enable-cleartext-plugin | 启用明文身份验证插件 |
| --get-server-public-key | 从服务器请求 RSA 公钥 |
| --help | 显示帮助消息并退出 |
| --host | MySQL 服务器所在的计算机 |
| --keys | 显示表索引 |
| --login-path | 从 .mylogin.cnf 读取登录路径选项 |
| --no-defaults | 不读取任何选项文件 |
| --no-login-paths | 不从登录路径文件读取登录路径 |
| --password | 连接到服务器时使用的密码 |
| --password1 | 连接到服务器时使用的第一个多因素身份验证密码 |
| --password2 | 连接到服务器时使用的第二个多因素身份验证密码 |
| --password3 | 连接到服务器时使用的第三个多因素身份验证密码 |
| --pipe | 使用命名管道连接到服务器(仅限 Windows) |
| --plugin-dir | 安装插件的目录 |
| --port | 用于连接的 TCP/IP 端口号 |
| --print-defaults | 打印默认选项 |
| --protocol | 要使用的传输协议 |
| --server-public-key-path | 包含 RSA 公钥的文件的路径名 |
| --shared-memory-base-name | 共享内存连接的共享内存名称(仅限 Windows) |
| --show-table-type | 显示指示表类型的列 |
| --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 | 会话重用失败时是否建立连接 |
| --status | 显示有关每个表的额外信息 |
| --tls-ciphersuites | 允许用于加密连接的 TLSv1.3 密码套件 |
| --tls-sni-servername | 客户端提供的服务器名称 |
| --tls-version | 允许用于加密连接的 TLS 协议 |
| --user | 连接到服务器时使用的 MySQL 用户名 |
| --verbose | 详细模式 |
| --version | 显示版本信息并退出 |
| --zstd-compression-level | 使用 zstd 压缩的连接到服务器的压缩级别 |
--help,-?命令行格式 --help显示帮助信息并退出。
-
命令行格式 --bind-address=ip_address在拥有多个网络接口的计算机上,使用此选项选择用于连接到 MySQL 服务器的接口。
-
命令行格式 --character-sets-dir=path类型 字符串 默认值 [无]安装字符集的目录。参见 第 12.15 节,“字符集配置”。
--compress,-C命令行格式 --compress[={OFF|ON}]已弃用 是 类型 布尔值 默认值 OFF如果可能,压缩客户端和服务器之间发送的所有信息。参见 第 6.2.8 节,“连接压缩控制”。
此选项已弃用。预计将在未来版本的 MySQL 中删除。参见 配置旧版连接压缩。
--compression-algorithms=value命令行格式 --compression-algorithms=value类型 集 默认值 未压缩有效值 zlibzstd未压缩服务器连接允许的压缩算法。可用算法与
protocol_compression_algorithms系统变量相同。默认值为uncompressed。有关更多信息,请参见 第 6.2.8 节,“连接压缩控制”。
-
命令行格式 --count显示每个表的行数。对于非
MyISAM表,这可能很慢。 --debug[=,debug_options]-# [debug_options]命令行格式 --debug[=debug_options]类型 字符串 默认值 d:t:o写入调试日志。典型的
debug_options字符串是d:t:o,。默认值为file_named:t:o。此选项仅在使用
WITH_DEBUG构建 MySQL 时可用。Oracle 提供的 MySQL 发布二进制文件不使用此选项构建。-
命令行格式 --debug-check类型 布尔值 默认值 FALSE程序退出时打印一些调试信息。
此选项仅在使用
WITH_DEBUG构建 MySQL 时可用。Oracle 提供的 MySQL 发布二进制文件不使用此选项构建。 -
命令行格式 --debug-info类型 布尔值 默认值 FALSE程序退出时打印调试信息以及内存和 CPU 使用统计信息。
此选项仅在使用
WITH_DEBUG构建 MySQL 时可用。Oracle 提供的 MySQL 发布二进制文件不使用此选项构建。 --default-character-set=charset_name命令行格式 --default-character-set=charset_name类型 字符串 使用
charset_name作为默认字符集。参见 第 12.15 节,“字符集配置”。-
命令行格式 --default-auth=plugin类型 字符串 有关使用哪个客户端身份验证插件的提示。参见 第 8.2.17 节,“可插拔身份验证”。
--defaults-extra-file=file_name命令行格式 --defaults-extra-file=file_name类型 文件名 在全局选项文件之后但(在 Unix 上)在用户选项文件之前读取此选项文件。如果文件不存在或无法访问,则会发生错误。如果
file_name不是绝对路径名,则相对于当前目录进行解释。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --defaults-file=file_name类型 文件名 仅使用给定的选项文件。如果文件不存在或无法访问,则会发生错误。如果
file_name不是绝对路径名,则相对于当前目录进行解释。例外情况:即使使用
--defaults-file,客户端程序也会读取.mylogin.cnf。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --defaults-group-suffix=str类型 字符串 不仅读取通常的选项组,还读取具有通常名称和
str后缀的组。例如,mysqlshow 通常读取[client]和[mysqlshow]组。如果此选项被给出为--defaults-group-suffix=_other,则 mysqlshow 还读取[client_other]和[mysqlshow_other]组。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --enable-cleartext-plugin类型 布尔值 默认值 FALSE启用
mysql_clear_password明文身份验证插件。(参见 第 8.4.1.4 节,“客户端明文可插拔身份验证”。) -
命令行格式 --get-server-public-key类型 布尔值 从服务器请求用于基于密钥对的密码交换的 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-hhost_name命令行格式 --host=host_name类型 字符串 默认值 localhost连接到给定主机上的 MySQL 服务器。
--keys,-k命令行格式 --keys显示表索引。
-
命令行格式 --login-path=name类型 字符串 从
.mylogin.cnf登录路径文件中命名的登录路径读取选项。一个“登录路径” 是一个选项组,其中包含指定要连接的 MySQL 服务器以及要以其身份进行身份验证的帐户的选项。要创建或修改登录路径文件,请使用 mysql_config_editor 实用程序。参见 第 6.6.7 节,“mysql_config_editor — MySQL 配置实用程序”。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --no-login-paths跳过从登录路径文件读取选项。
参见
--login-path以获取相关信息。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --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]命令行格式 --password[=password]类型 字符串 用于连接到服务器的 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的语义;有关详细信息,请参阅该选项的描述。用于连接到服务器的 MySQL 帐户的多因素身份验证因子 3 的密码。此选项的语义类似于
--password1的语义;有关详细信息,请参阅该选项的描述。--pipe,-W命令行格式 --pipe类型 字符串 在 Windows 上,使用命名管道连接到服务器。此选项仅在服务器使用启用了支持命名管道连接的
named_pipe系统变量启动时适用。此外,进行连接的用户必须是named_pipe_full_access_group系统变量指定的 Windows 组的成员。-
命令行格式 --plugin-dir=dir_name类型 目录名称 查找插件的目录。如果使用
--default-auth选项指定身份验证插件,但 mysqlshow 未找到它,请指定此选项。请参阅 第 8.2.17 节,“可插拔身份验证”。 --port=,port_num-Pport_num命令行格式 --port=port_num类型 数字 默认值 3306对于 TCP/IP 连接,要使用的端口号。
-
命令行格式 --print-defaults打印程序名称以及从选项文件获取的所有选项。
有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
--protocol={TCP|SOCKET|PIPE|MEMORY}命令行格式 --protocol=type类型 字符串 默认值 [参见文本]有效值 TCPSOCKETPIPEMEMORY用于连接到服务器的传输协议。当其他连接参数通常会导致使用与所需协议不同的协议时,它很有用。有关允许值的详细信息,请参阅 第 6.2.7 节,“连接传输协议”。
--server-public-key-path=file_name命令行格式 --server-public-key-path=file_name类型 文件名 指向 PEM 格式文件的路径名,该文件包含服务器为基于 RSA 密钥对的密码交换所需的客户端副本公钥。此选项适用于使用
sha256_password(已弃用)或caching_sha2_password身份验证插件进行身份验证的客户端。对于不使用其中一个插件进行身份验证的帐户,此选项将被忽略。如果未使用基于 RSA 的密码交换,也会忽略它,例如,当客户端使用安全连接连接到服务器时。如果给出
--server-public-key-path=并指定有效公钥文件,则优先于file_name--get-server-public-key。对于
sha256_password(已弃用),此选项仅在使用 OpenSSL 构建 MySQL 时适用。有关
sha256_password和caching_sha2_password插件的信息,请参阅 第 8.4.1.3 节,“SHA-256 可插拔身份验证” 和 第 8.4.1.2 节,“缓存 SHA-2 可插拔身份验证”。--shared-memory-base-name=name命令行格式 --shared-memory-base-name=name平台特定 Windows 在 Windows 上,要用于使用共享内存连接到本地服务器的连接的共享内存名称。默认值为
MYSQL。共享内存名称区分大小写。此选项仅在服务器使用启用了支持共享内存连接的
shared_memory系统变量启动时适用。-
命令行格式 --show-table-type显示指示表类型的列,如
SHOW FULL TABLES中所示。该类型为BASE TABLE或VIEW。 --socket=,path-Spath命令行格式 --socket={file_name|pipe_name}类型 字符串 对于连接到
localhost,要使用的 Unix 套接字文件,或在 Windows 上,要使用的命名管道的名称。在 Windows 上,此选项仅在服务器使用启用了支持命名管道连接的
named_pipe系统变量启动时适用。此外,进行连接的用户必须是named_pipe_full_access_group系统变量指定的 Windows 组的成员。以
--ssl开头的选项指定是否使用加密连接到服务器,并指示在哪里查找 SSL 密钥和证书。请参阅 加密连接的命令选项。--ssl-fips-mode={OFF|ON|STRICT}命令行格式 --ssl-fips-mode={OFF|ON|STRICT}已弃用 是 类型 枚举 默认值 OFF有效值 OFFONSTRICT控制是否在客户端启用 FIPS 模式。
--ssl-fips-mode选项与其他--ssl-选项的不同之处在于,它不用于建立加密连接,而是用于影响允许执行哪些加密操作。请参阅 第 8.8 节,“FIPS 支持”。xxx以下
--ssl-fips-mode值是允许的OFF:禁用 FIPS 模式。ON:启用 FIPS 模式。STRICT:启用 “严格” FIPS 模式。
注意如果 OpenSSL FIPS 对象模块不可用,则
--ssl-fips-mode的唯一允许值为OFF。在这种情况下,将--ssl-fips-mode设置为ON或STRICT会导致客户端在启动时生成警告,并在非 FIPS 模式下运行。此选项已弃用。预计它将在 MySQL 的未来版本中删除。
--status,-i命令行格式 --status显示有关每个表的额外信息。
--tls-ciphersuites=ciphersuite_list命令行格式 --tls-ciphersuites=ciphersuite_list类型 字符串 使用 TLSv1.3 的加密连接的允许密码套件。该值是包含一个或多个以冒号分隔的密码套件名称的列表。可以为此选项指定名称的密码套件取决于用于编译 MySQL 的 SSL 库。有关详细信息,请参阅 第 8.3.2 节,“加密连接 TLS 协议和密码”。
--tls-sni-servername=server_name命令行格式 --tls-sni-servername=server_name类型 字符串 当指定时,该名称将使用
mysql_options()的MYSQL_OPT_TLS_SNI_SERVERNAME选项传递给libmysqlclientC API 库。服务器名称不区分大小写。要显示客户端为当前会话指定的服务器名称(如果有),请检查Tls_sni_server_name状态变量。服务器名称指示 (SNI) 是 TLS 协议的扩展(OpenSSL 必须使用 TLS 扩展进行编译才能使此选项正常工作)。MySQL 中的 SNI 实施仅代表客户端。
-
命令行格式 --tls-version=protocol_list类型 字符串 默认值 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_name命令行格式 --user=user_name,类型 字符串 用于连接到服务器的 MySQL 帐户的用户名。
--verbose,-v命令行格式 --verbose详细模式。打印有关程序执行操作的更多信息。此选项可以使用多次以增加信息量。
--version,-V命令行格式 --version显示版本信息并退出。
--zstd-compression-level=level命令行格式 --zstd-compression-level=#类型 整数 要用于使用
zstd压缩算法连接到服务器的压缩级别。允许的级别从 1 到 22,值越大表示压缩级别越高。默认的zstd压缩级别为 3。压缩级别设置对不使用zstd压缩的连接没有影响。有关更多信息,请参见 第 6.2.8 节,“连接压缩控制”。