前置环境检查
在执行连接命令前，需确认本地 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 数据库的本地连接流程，包括环境核查、建立连接、断开连接、基本交互以及问题排查。掌握这些操作是进行后续数据库管理的基础。
