前置环境检查
在执行连接命令前，需确认本地 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
