5.7 输出格式

MySQL Shell 可以以表格、选项卡式或垂直格式打印结果,或者作为漂亮或原始的 JSON 输出。从 MySQL Shell 8.0.14 开始,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 与外部工具集成,--json当您从命令行启动 MySQL Shell 时,您可以使用该选项来控制所有 MySQL Shell 输出的 JSON 包装。当打开 JSON 包装时,MySQL Shell 生成漂亮打印的 JSON(默认)或原始 JSON,并且resultFormat 忽略 MySQL Shell 配置选项的值。当关闭 JSON 包装或未为会话请求时,结果集将以 resultFormat配置选项指定的格式正常输出。

配置outputFormat选项现已弃用。此选项结合了 JSON 包装和结果打印功能。如果您的 MySQL Shell 配置文件或脚本中仍指定此选项,则行为如下:

  • 使用jsonjson/raw值, outputFormat分别激活使用漂亮或原始 JSON 的 JSON 包装。

  • 使用tabletabbedvertical值, outputFormat关闭 JSON 包装并将resultFormat会话的配置选项设置为适当的值。