字段太多看不全,ksql 的展开模式和输出控制怎么用

MySQL 里查宽表,字段多了输出就会折行,列对应关系容易看乱。MySQL 的解法是在 SQL 末尾加 \G,把每行的字段竖着列出来。ksql 里处理这个问题的方式不同------通过几个元命令控制整个会话的输出行为,不用每条 SQL 末尾单独加。

这篇在 KingbaseES V009R001C010 环境里验证:\x(展开模式)、\x auto(自动判断)、\timing(执行耗时)、\pset border(边框调整)、\o(输出重定向)。演示在 app_db 库的 app_schema.t_meta_demo 表上进行,用 app_user 连接,进入后先执行 set search_path to app_schema, public 让后续查询不带 schema 前缀。

有几个活动推荐给大家:

"1、荐商机·赢好礼------金仓社区"同行者计划"开启(bbs.kingbase.com.cn/forumDetail... 2、2026金仓数据库智能运维工具开发大赛(bbs.kingbase.com.cn/forumDetail..."

默认输出下的宽表问题

关掉分页器,直接查全表:

sql 复制代码
\pset pager off

select * from t_meta_demo;

t_meta_demoidorder_nouser_namestatusamountcreated_at 六个字段,终端宽度不够时每行折成多行,字段名和值的对应关系很难一眼看清。这就是 \x 要解决的问题。

\x 开关:竖排展开和关闭

打开展开模式,再查一次:

sql 复制代码
\x

select * from t_meta_demo limit 2;

再执行一次 \x 关掉,对比两次输出:

sql 复制代码
\x

select * 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 自动判断:

sql 复制代码
\x auto

ksql 返回 Expanded display is used automatically

查单行结果:

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

再查多行:

sql 复制代码
select * from t_meta_demo;

单行查询下 ksql 自动用了竖排展开;多行查询 ksql 判断终端宽度够用,直接输出横排表格。

\x auto 的判断依据是当前终端宽度,不是字段数量。同一张表,终端窗口调窄 ksql 更倾向于展开,调宽相同查询可能回到横排。MySQL 里没有这个模式,\G 每次都要手写在 SQL 末尾。

\timing 显示执行耗时

关掉展开模式,开启计时:

sql 复制代码
\x off
\timing

执行几条查询观察耗时:

sql 复制代码
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 开启后提示 Timing is on,每条 SQL 执行完都会跟着一行 Time: x.xxx ms

MySQL 里看执行耗时通常需要 show profiles 或者借助客户端工具,ksql 里 \timing 打开以后自动附在每个结果后面,不用额外操作。

\timing 给的是客户端侧的壁钟时间,包含网络往返和客户端处理,只适合粗粒度判断某条查询快不快。精确分析 SQL 是否走了索引、各执行节点耗时分布,要用 EXPLAIN (ANALYZE, BUFFERS),不能把 \timing 当性能分析工具来用。

\pset border 调整输出边框

关掉计时,演示三种边框样式:

sql 复制代码
\timing off

默认边框(border 1):

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

无边框(border 0):

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

双线边框(border 2):

sql 复制代码
\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 在把终端输出粘贴进文档时最有用,不用手动清格线。演示完以后恢复默认:

sql 复制代码
\pset border 1

\o 把输出写进文件

在交互会话里把查询结果重定向到文件,不需要退出去用 shell 重定向:

sql 复制代码
\pset border 1
\o /tmp/ksql-output.txt

select 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 可以直接在会话内切换,用完记得关。

相关推荐
大志说编程1 小时前
Agent面试真题06: 十分钟带你快速掌握Agent记忆管理高频面试题(附详细答案)
后端·面试·ai编程
ServBay1 小时前
Claude Code 被曝植入后门,AI 时代如何安全打造本地 DevOps
后端·ai编程·claude
王二端茶倒水1 小时前
从千兆到万兆:宽带运营不能只卖套餐,要管用户生命周期从千兆到万兆:宽带运营需要管理用户生命周期
后端·网络协议·架构
网易云信2 小时前
重磅认证!网易智企智能融合通信获鸿蒙生态权威认可,斩获「Harmony Trusted SDK」认证
人工智能·后端·aigc
神奇小汤圆2 小时前
我把祖传Java项目重构后,接口响应从3s砍到了200ms,只改了这几行代码
后端
神奇小汤圆3 小时前
面试官:你们项目里的线程池是怎么用的?怎么管理的?
后端
网易云信3 小时前
网易智企IM Web体验馆:一站式在线体验即时通讯
人工智能·后端·aigc
shengjk13 小时前
从 ASCII 到 UTF-8:一部字符集的发展史
后端