写在前面

做 DBA 这么多年，我用过 KStudio、Navicat、DBeaver 等 GUI 工具。但真正进入生产环境——特别是只能通过堡垒机跳进去、没有图形界面的服务器——你会发现能依赖的只有命令行。老实说，KingbaseES 自带的 ksql 就是这样一个趁手工具。功能比较多且针对国产环境做了不少调整。下面整理了我日常工作中最常用的 ksql 操作，希望能帮你少踩几个坑。

说到连接数据库。别小看这一行命令

找到你的 ksql

安装后ksql 一般藏在两个地方：

# 服务端自带
/opt/Kingbase/ES/V8/Server/bin/ksql
# 独立客户端
/opt/Kingbase/ES/V8/ClientTools/bin/ksql

生产环境建议用 ClientTools 目录下的版本，不依赖服务端库文件，可以直接拷贝到跳板机上使用。如果你懒得记方法，直接加到环境变量：

# ~/.bashrc
export PATH=/opt/Kingbase/ES/V8/ClientTools/bin:$PATH
source ~/.bashrc

基础连接方式

最朴素的连接命令长这样：

ksql -U system -d test

-U 指定使用者名。 -d 指定数据库名。 执行后会让你输密码，连上之后提示符变成这样：

# ksql Type "help" for help.test=#

注意那个 #它表示当前使用者是超级使用者；普通使用者提示符会变成 =>。这在写操作文档时很有用，一眼就能看出来权限级别。

远程连接与密码处理

本地 socket 连接有个坑：如果不指定 -h。KingbaseES 不会强制验密，输什么密码都能进。这在开发环境方便，但生产环境就是安全隐患。稳妥做法是始终指定主机地址：

# 主机地址必须明确，否则可能被恶意攻击者利用
ksql -U system -h . -p 5432 -W -d test

-W 是强制要求输入密码； -p 指定端口，注意别跟其它数据库冲突。

If you often connect to same database。create a password file to avoid repeated input:

# ~/.pgpass 文件权限必须是 600
cat> ~/.pgpass > ~/.bashrc
source ~/.bashrc

A 环境变量偷懒法

If your connection parameters are always same:

# .bashrc 或 .profile 中添加：
export KINGBASE_HOST=.
export KINGBASE_PORT=5432
export KINGBASE_DATABASE=test
export KINGBASE_USER=system
# 接下来直接：
ksql # 自动读取环境变量完成连接

至于交互模式，ksql 的主要战场

先搞清楚自己在哪？检查当前环境很关键，不过，

No matter how fast you type。always double-check you are in right database and environment before running DML.

Pain Point: 许多 DBA 在切换数据库后忘记检查导致误删数据。Solve it with: . \conninfo 输出示例:

• You are connected to database "test"" as user "system"" on host "." at port "".

• \conninfo : 查看当前连接信息。
• \l : 列出所有数据库。

TIPS: 当你想确认是否为超级使用者时只需观察提示符左侧 # 与 => 的区别。

数据库和对象地图工具

• \l 列出所有数据库
• \c dbname 切换到另一个库
• \dn 列出当前模式下所有 schema
• \dt 列出当前模式下所有表
• \di 列出索引
• \dv 列出视图
• \df 列出函数

Example: 想找所有以 “user” 开头的表，只需输入：

\dt user*

结果格式化。让输出更符合你的习惯

• \x toggle expanded display mode – one column per line

\t show data only

\H switch to HTML format

\pset format csv – CSV output for Excel import

\pset fieldsep '\t' – tab separated fields for Excel copy‑paste

timing on/off – see query execution time

\pset tuples_only true – suppress header row and column names when you just want raw data

\set VERBOSITY verbose – more detailed error messages

…etc.

Expanded Mode Output
---------+-------------------------- user_id | username zhangsanemail | created_at | -- ::last_login -- ::is_active | t department | 技术研发部 phone | ...

\x 再执行一次即可切回表格模式。

---