KSQL字段显示不全？展开模式与输出控制用法

在 MySQL 中查询宽表时，字段一多输出就容易折行，列与值的对应关系也容易让人眼花缭乱。MySQL 的常见做法是在 SQL 末尾加上 G，将每行字段竖着排列出来。而 KingbaseES 的 ksql 命令行工具则提供了不同的处理方式——通过几个内置的元命令来控制整个会话的输出行为，无需在每条 SQL 后面单独添加。

本文以 KingbaseES V009R001C010 环境为例，在 app_db 库的 app_schema.t_meta_demo 表上进行演示。使用 app_user 连接后，先执行 set search_path to app_schema, public，这样后续查询就不需要再带上 schema 前缀，操作更加便捷。

默认输出下的宽表问题

关闭分页器后直接查询全表：

 复制代码pset pager offselect * from t_meta_demo;

t_meta_demo 表包含 id、order_no、user_name、status、amount、created_at 共六个字段。当终端宽度不足时，每行会被折成多行，字段名和对应值的关系很难一目了然。这正是 x 元命令要解决的核心痛点。

x 开关：竖排展开与关闭

开启竖排展开模式后再次查询：

 复制代码xselect * from t_meta_demo limit 2;

再次执行 x 关闭该模式，对比两次输出效果：

 复制代码xselect * from t_meta_demo limit 2;

当 x 打开后，ksql 会提示 Expanded display is on，输出格式从横排表格转变为竖列展示，每个字段单独一行，格式为 字段名 | 值。再次执行 x 则提示 Expanded display is off，恢复为横排表格。

在 MySQL 中实现竖排显示需要使用 select ... G，写在 SQL 末尾，只对当前语句生效。而 x 是一个会话级别的开关，开启后所有查询都会采用竖排格式，无需每条 SQL 后面都添加。当需要连续查看多张宽表数据时，x 无疑比 G 更省时省力。

x auto：让 ksql 自动判断是否展开

手动切换 x 开关有时略显繁琐。x auto 模式下，ksql 会自动根据终端宽度决定是否展开输出：

 复制代码x auto

ksql 会返回 Expanded display is used automatically 提示。

查询单行结果：

 复制代码select * from t_meta_demo where order_no = 'ORD-20240601-001';

再查询多行数据：

 复制代码select * from t_meta_demo;

单行查询时，ksql 自动启用了竖排展开；而多行查询时，ksql 判断终端宽度足够，直接输出横排表格。

x auto 的判断依据是当前终端宽度，而非字段数量。对于同一张表，如果调窄终端窗口，ksql 更倾向于使用展开模式；调宽窗口后，相同的查询可能又会回到横排输出。MySQL 中没有类似的自动模式，G 每次都需要手动写在 SQL 末尾。

timing 显示执行耗时

关闭展开模式，开启计时功能：

 复制代码x off
timing

执行几条查询语句来查看耗时：

 复制代码select count(*) from t_meta_demo;select * from t_meta_demo where status = 'paid';select user_name, sum(amount) from t_meta_demo group by user_name;

开启 timing 后，ksql 会提示 Timing is on，每条 SQL 执行完毕都会自动附带一行 Time: x.xxx ms 信息。

在 MySQL 中查看执行耗时通常需要借助 show profiles 或外部客户端工具，而 ksql 的 timing 开启后会自动附加在每个结果后面，无需额外操作。

不过需要注意，timing 给出的是客户端侧的壁钟时间，其中包含了网络往返和客户端处理的耗时，仅适合粗略判断某条查询的快慢。若要精确分析 SQL 是否使用了索引、各执行节点的耗时分布，应使用 EXPLAIN (ANALYZE, BUFFERS)，不能把 timing 当作性能分析工具来使用。

pset border 调整输出边框

关闭计时，演示三种边框样式：

 复制代码timing off

默认边框（border 1）：

 复制代码pset border 1
select order_no, user_name, status, amount from t_meta_demo limit 3;

无边框（border 0）：

 复制代码pset border 0
select order_no, user_name, status, amount from t_meta_demo limit 3;

双线边框（border 2）：

 复制代码pset border 2
select order_no, user_name, status, amount from t_meta_demo limit 3;

三种样式的区别如下：

• border 1：列之间以 | 分隔，标题行下方有 +---+---+ 形式的分隔线，为默认样式
• border 0：去掉所有分隔符，列之间仅保留空格，标题与数据之间使用短横线对齐
• border 2：整个结果集外围添加一圈完整边框，顶部、底部以及标题与数据之间均有分隔线

pset border 仅影响显示格式，不会改变数据内容，切换后立即生效。MySQL 客户端的输出边框样式是固定的，而 ksql 允许按需调整。border 0 在将终端输出粘贴到文档中时最为实用，无需手动清理格线。演示完成后恢复默认设置：

 复制代码pset border 1

o 将输出写入文件

在交互会话中直接将查询结果重定向到文件，无需退出 ksql 或使用 shell 重定向：

 复制代码pset border 1
o /tmp/ksql-output.txtselect order_no, user_name, status, amount from t_meta_demo;o

执行 o /tmp/ksql-output.txt 后，ksql 不再将查询结果输出到终端——select 执行后直接返回提示符，没有任何表格显示，所有结果均写入到指定文件中。不带参数的 o 命令用于关闭重定向，恢复终端输出。在另一个终端中使用 cat /tmp/ksql-output.txt 可以查看到全部五行数据，内容与直接在终端查询的结果一致。

这里有一个容易踩的坑：关闭重定向时必须使用 o 且不带任何参数。如果忘记关闭，后续所有的查询输出甚至元命令的提示都会继续写入文件，终端里将看不到任何信息，容易误以为命令没有执行。在 MySQL 中，在交互会话内导出结果通常要借助外部工具，而 ksql 的 o 命令可以直接在会话内切换，使用后记得及时关闭。