5.7 輸出格式

MySQL Shell 可以以表格、Tab 分隔或垂直格式列印結果,或以美化或原始 JSON 輸出。MySQL Shell 配置選項 resultFormat 可用於指定任何這些輸出格式,作為所有工作階段的持續預設值,或僅適用於目前的工作階段。變更此選項會立即生效。如需設定 MySQL Shell 配置選項的說明,請參閱 第 13.4 節「設定 MySQL Shell 選項」。或者,可以使用啟動時的命令列選項 --result-format 或其別名(--table--tabbed--vertical)來指定工作階段的輸出格式。如需命令列選項的清單,請參閱 第 A.1 節「mysqlsh — MySQL Shell」

如果尚未指定 resultFormat 配置選項,當 MySQL Shell 處於互動模式時,列印結果集的預設格式是格式化的表格,當 MySQL Shell 處於批次模式時,列印結果集的預設格式是 Tab 分隔的輸出。當您使用 resultFormat 配置選項設定預設值時,此預設值會同時套用在互動模式和批次模式中。

MySQL Shell 函數 shell.dumpRows() 可以使用 MySQL Shell 支援的任何輸出格式,格式化查詢傳回的結果集,並將其轉儲到主控台。(請注意,結果集會被該函數使用。)

為了協助將 MySQL Shell 與外部工具整合,當您從命令列啟動 MySQL Shell 時,可以使用 --json 選項來控制所有 MySQL Shell 輸出的 JSON 包裝。當 JSON 包裝開啟時,MySQL Shell 會產生美化列印的 JSON(預設值)或原始 JSON,並且會忽略 resultFormat MySQL Shell 配置選項的值。當 JSON 包裝關閉,或未要求該工作階段使用 JSON 包裝時,結果集會以 resultFormat 配置選項指定的格式正常輸出。

outputFormat 配置選項現在已過時。此選項結合了 JSON 包裝和結果列印函數。如果您的 MySQL Shell 配置檔或指令碼中仍然指定此選項,其行為如下:

  • 使用 jsonjson/raw 值時,outputFormat 會分別使用美化或原始 JSON 啟用 JSON 包裝。

  • 使用 tabletabbedvertical 值時,outputFormat 會關閉 JSON 包裝,並將工作階段的 resultFormat 配置選項設定為適當的值。