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


