文件首頁
MySQL 8.4 參考手冊
相關文件 下載本手冊
PDF (美國信紙) - 39.9Mb
PDF (A4) - 40.0Mb
Man Pages (TGZ) - 258.5Kb
Man Pages (Zip) - 365.5Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 參考手冊  /  ...  /  mysqlshow — 顯示資料庫、表格和欄位資訊

6.5.6 mysqlshow — 顯示資料庫、表格和欄位資訊

可以使用 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 socket 檔案或 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

    命令列格式 --bind-address=ip_address

    在具有多個網路介面的電腦上,使用此選項選擇要用於連線到 MySQL 伺服器的介面。

  • --character-sets-dir=dir_name

    命令列格式 --character-sets-dir=路徑
    類型 字串
    預設值 [無]

    安裝字元集的目錄。請參閱第 12.15 節,「字元集設定」

  • --compress, -C

    命令列格式 --compress[={OFF|ON}]
    已棄用
    類型 布林值
    預設值 OFF

    如果可能,壓縮客戶端和伺服器之間傳送的所有資訊。請參閱第 6.2.8 節,「連線壓縮控制」

    此選項已棄用。預期會在未來版本的 MySQL 中移除。請參閱設定舊版連線壓縮

  • --compression-algorithms=value

    命令列格式 --compression-algorithms=值
    類型 設定
    預設值 未壓縮
    有效值

    zlib

    zstd

    未壓縮

    允許伺服器連線使用的壓縮演算法。可用的演算法與protocol_compression_algorithms系統變數相同。預設值為 uncompressed

    有關更多資訊,請參閱第 6.2.8 節,「連線壓縮控制」

  • --count

    命令列格式 --count

    顯示每個表格的列數。對於非MyISAM 表格,這可能會很慢。

  • --debug[=debug_options], -# [debug_options]

    命令列格式 --debug[=debug_options]
    類型 字串
    預設值 d:t:o

    寫入除錯日誌。典型的 debug_options 字串為 d:t:o,file_name。預設值為 d:t:o

    僅當使用 WITH_DEBUG 建置 MySQL 時,此選項才可用。Oracle 提供的 MySQL 發行二進位檔並非使用此選項建置。

  • --debug-check

    命令列格式 --debug-check
    類型 布林值
    預設值 FALSE

    在程式結束時列印一些除錯資訊。

    僅當使用 WITH_DEBUG 建置 MySQL 時,此選項才可用。Oracle 提供的 MySQL 發行二進位檔並非使用此選項建置。

  • --debug-info

    命令列格式 --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

    命令列格式 --default-auth=plugin
    類型 字串

    關於要使用哪個客戶端驗證外掛程式的提示。請參閱第 8.2.17 節,「可插拔驗證」

  • --defaults-extra-file=file_name

    命令列格式 --defaults-extra-file=檔案名稱
    類型 檔案名稱

    在全域選項檔案之後,但在使用者選項檔案(在 Unix 上)之前,讀取此選項檔案。如果檔案不存在或無法存取,則會發生錯誤。如果 file_name 不是絕對路徑名稱,則會將其解譯為相對於目前目錄。

    有關此選項和其他選項檔案選項的更多資訊,請參閱第 6.2.2.3 節,「影響選項檔案處理的命令列選項」

  • --defaults-file=file_name

    命令列格式 --defaults-file=檔案名稱
    類型 檔案名稱

    僅使用指定的選項檔案。如果檔案不存在或無法存取,則會發生錯誤。如果 file_name 不是絕對路徑名稱,則會將其解譯為相對於目前目錄。

    例外:即使使用--defaults-file,客戶端程式也會讀取 .mylogin.cnf

    有關此選項和其他選項檔案選項的更多資訊,請參閱第 6.2.2.3 節,「影響選項檔案處理的命令列選項」

  • --defaults-group-suffix=str

    命令列格式 --defaults-group-suffix=str
    類型 字串

    不僅讀取一般的選項群組,還讀取具有一般名稱和 str 字尾的群組。例如,mysqlshow 通常讀取 [client][mysqlshow] 群組。如果此選項指定為--defaults-group-suffix=_other,則mysqlshow 也會讀取 [client_other][mysqlshow_other] 群組。

    有關此選項和其他選項檔案選項的更多資訊,請參閱第 6.2.2.3 節,「影響選項檔案處理的命令列選項」

  • --enable-cleartext-plugin

    命令列格式 --enable-cleartext-plugin
    類型 布林值
    預設值 FALSE

    啟用 mysql_clear_password 明文驗證外掛程式。(請參閱第 8.4.1.4 節,「客戶端明文可插拔驗證」。)

  • --get-server-public-key

    命令列格式 --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, -h host_name

    命令列格式 --host=host_name
    類型 字串
    預設值 localhost

    連線到指定主機上的 MySQL 伺服器。

  • --keys, -k

    命令列格式 --keys

    顯示表格索引。

  • --login-path=name

    命令列格式 --login-path=name
    類型 字串

    .mylogin.cnf 登入路徑檔案中指定的登入路徑讀取選項。「登入路徑」是一個選項群組,其中包含指定要連線到哪個 MySQL 伺服器以及要以哪個帳戶進行驗證的選項。若要建立或修改登入路徑檔案,請使用 mysql_config_editor 公用程式。請參閱第 6.6.7 節,「mysql_config_editor — MySQL 設定公用程式」

    有關此選項和其他選項檔案選項的更多資訊,請參閱第 6.2.2.3 節,「影響選項檔案處理的命令列選項」

  • --no-login-paths

    命令列格式 --no-login-paths

    略過從登入路徑檔案讀取選項。

    有關相關資訊,請參閱--login-path

    有關此選項和其他選項檔案選項的更多資訊,請參閱第 6.2.2.3 節,「影響選項檔案處理的命令列選項」

  • --no-defaults

    命令列格式 --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 選項。

  • --password1[=pass_val]

    用於連線至伺服器的 MySQL 帳戶多因素驗證因素 1 的密碼。密碼值為選填。如果未給定,mysqlshow 會提示輸入密碼。如果給定,則 --password1= 與其後的密碼之間不得有空格。如果未指定密碼選項,預設為不傳送密碼。

    在命令列上指定密碼應視為不安全。為了避免在命令列上提供密碼,請使用選項檔案。請參閱第 8.1.2.1 節「使用者密碼安全準則」

    若要明確指定沒有密碼且 mysqlshow 不應提示輸入密碼,請使用 --skip-password1 選項。

    --password1--password 是同義詞,--skip-password1--skip-password 也是同義詞。

  • --password2[=pass_val]

    用於連線至伺服器的 MySQL 帳戶多因素驗證因素 2 的密碼。此選項的語義與 --password1 的語義類似;詳細資訊請參閱該選項的描述。

  • --password3[=pass_val]

    用於連線至伺服器的 MySQL 帳戶多因素驗證因素 3 的密碼。此選項的語義與 --password1 的語義類似;詳細資訊請參閱該選項的描述。

  • --pipe, -W

    命令列格式 --pipe
    類型 字串

    在 Windows 上,使用具名管道連線至伺服器。只有在伺服器啟動時啟用 named_pipe 系統變數以支援具名管道連線時,此選項才適用。此外,建立連線的使用者必須是 named_pipe_full_access_group 系統變數所指定 Windows 群組的成員。

  • --plugin-dir=dir_name

    命令列格式 --plugin-dir=dir_name
    類型 目錄名稱

    尋找外掛程式的目錄。如果 --default-auth 選項用於指定驗證外掛程式,但 mysqlshow 找不到它,請指定此選項。請參閱第 8.2.17 節「可插拔驗證」

  • --port=port_num, -P port_num

    命令列格式 --port=port_num
    類型 數值
    預設值 3306

    對於 TCP/IP 連線,要使用的連接埠號碼。

  • --print-defaults

    命令列格式 --print-defaults

    列印程式名稱以及從選項檔案取得的所有選項。

    有關此選項和其他選項檔案選項的更多資訊,請參閱第 6.2.2.3 節,「影響選項檔案處理的命令列選項」

  • --protocol={TCP|SOCKET|PIPE|MEMORY}

    命令列格式 --protocol=type
    類型 字串
    預設值 [請參閱文字]
    有效值

    TCP

    SOCKET

    PIPE

    MEMORY

    用於連線至伺服器的傳輸協定。當其他連線參數通常導致使用非您想要的協定時,它會很有用。有關允許值的詳細資訊,請參閱第 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_passwordcaching_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, -t

    命令列格式 --show-table-type

    顯示一個指示表格類型的欄,如同 SHOW FULL TABLES 中一樣。類型為 BASE TABLEVIEW

  • --socket=path, -S path

    命令列格式 --socket={file_name|pipe_name}
    類型 字串

    對於連線到 localhost,要使用的 Unix socket 檔案,或在 Windows 上,要使用的具名管道名稱。

    在 Windows 上,只有在伺服器啟動時啟用 named_pipe 系統變數以支援具名管道連線時,此選項才適用。此外,建立連線的使用者必須是 named_pipe_full_access_group 系統變數所指定 Windows 群組的成員。

  • --ssl*

    --ssl 開頭的選項會指定是否使用加密連線至伺服器,並指示在哪裡尋找 SSL 金鑰和憑證。請參閱加密連線的命令選項

  • --ssl-fips-mode={OFF|ON|STRICT}

    命令列格式 --ssl-fips-mode={OFF|ON|STRICT}
    已棄用
    類型 列舉
    預設值 OFF
    有效值

    OFF

    ON

    STRICT

    控制是否在用戶端啟用 FIPS 模式。--ssl-fips-mode 選項與其他 --ssl-xxx 選項不同,它不是用於建立加密連線,而是用於影響允許的加密作業。請參閱第 8.8 節「FIPS 支援」

    允許使用以下 --ssl-fips-mode

    • OFF:停用 FIPS 模式。

    • ON:啟用 FIPS 模式。

    • STRICT:啟用嚴格 FIPS 模式。

    注意

    如果 OpenSSL FIPS 物件模組不可用,則 --ssl-fips-mode 唯一允許的值為 OFF。在此情況下,將 --ssl-fips-mode 設定為 ONSTRICT 會導致用戶端在啟動時產生警告,並在非 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 選項傳遞至 libmysqlclient C API 函式庫。伺服器名稱不區分大小寫。若要顯示用戶端為目前會話指定的伺服器名稱(如果有的話),請檢查 Tls_sni_server_name 狀態變數。

    伺服器名稱指示 (SNI) 是 TLS 通訊協定的擴充功能(OpenSSL 必須使用 TLS 擴充功能編譯,此選項才能運作)。MySQL 的 SNI 實作僅代表用戶端。

  • --tls-version=protocol_list

    命令列格式 --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, -u user_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 節,「連線壓縮控制」