前置环境检查
在执行连接命令前,需确认本地 KingbaseES 数据库已启动,并获取服务端口。
KingbaseES 数据库的本地连接流程。内容包括启动实例、查询端口、使用 ksql 命令行连接及断开数据库、基础交互命令(如查看帮助、清屏、执行 SQL)以及常见连接问题的排查方法。掌握这些操作是进行后续数据库管理的基础。

在执行连接命令前,需确认本地 KingbaseES 数据库已启动,并获取服务端口。
打开后,左侧导航选择【单节点列表】(集群环境选'读写分离集群列表'),右侧显示当前实例。
点击【创建新实例】进入配置向导。在【单节点列表】界面点击红色按钮【创建新实例】设置参数。
弹出'创建数据库实例'窗口,按步骤填写参数。如需调整内存、连接数等,勾选【高级配置】;否则直接点击【下一步】。
进入'执行'页面,勾选关键选项:
点击【执行】等待进度条完成。若失败,查看下方执行日志排查(常见原因:端口被占、权限不足)。
回到【单节点列表】刷新,运行状态显示为'运行中'(绿色)。若为红色,点击【查看】 - 【日志】查找原因。
Win + R,输入 services.msc 打开'服务'窗口,找到实例名称(默认 kes_instance),右键→【启动】。ps aux |grep kingbase,若有包含 kingbase 的进程则说明已启动。KingbaseES 默认端口为 54321。若修改过或不确定,需查询:
cat /你的数据文件路径/kingbase.conf |grep ^\s*port
示例:
cat /opt/kingbase/data/kingbase.conf |grep ^\s*port
结果如 port = 54321。
按下 Win + R,输入 cmd 打开命令提示符:
findstr /R "^\s*port" D:\Tools\Kingbase\ES\kes_instance\kingbase.conf
结果如 port = 54321。
ksql 是 KingbaseES 自带的命令行连接工具。前提:打开命令行终端(Linux 终端或 Windows cmd/PowerShell)。
cd /d D:\Tools\Kingbase\ES\Server\bin
system,密码 manager,数据库 test,端口 54321):
ksql -U system -d test -h localhost -p 54321
test=# 提示符,说明连接成功。退出 ksql 时需注意未提交的事务。
在 test=# 提示符后输入以下任一命令:
\qQUIT 或 quit断开前请确认操作是否保存:
COMMIT;ROLLBACK;输入 \? 查看 ksql 命令详细说明。
执行 conninfo 查看当前连接的数据库、用户、端口等信息。
! clear ! cls例如查看当前数据库的所有表:
\dt
报错:could not connect to server: Connection refused...
解决:确认数据库已启动,且命令中的 -p 参数与实际端口一致。
报错:password authentication failed for user "system"
解决:确认用户名拼写正确,密码区分大小写。若忘记密码需联系管理员重置。
报错:database "kingbase_test" does not exist
解决:确认数据库名拼写正确,或先创建所需数据库。
本文介绍了 KingbaseES 数据库的本地连接流程,包括环境核查、建立连接、断开连接、基本交互以及问题排查。掌握这些操作是进行后续数据库管理的基础。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
在线格式化和美化您的 SQL 查询(它支持各种 SQL 方言)。 在线工具,SQL 美化和格式化在线工具,online
解析 INSERT 等受限 SQL,导出为 CSV、JSON、XML、YAML、HTML 表格(见页内语法说明)。 在线工具,SQL转CSV/JSON/XML在线工具,online
CSV 与 JSON/XML/HTML/TSV/SQL 等互转,单页多 Tab。 在线工具,CSV 工具包在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online