首页/系统/信创系统运维速查/人大金仓 KingbaseES 安装要点
迁移适配65 条

人大金仓 KingbaseES 安装要点

金仓安装:专用账户运行安装程序、初始数据库、注册服务;默认端口 54321,登录账户与默认库名以安装向导选择为准。

信创系统运维速查系统更新于 2026-10-13

人大金仓安装要点

KingbaseES 是国内信创环境常用的关系数据库,安装流程与 PostgreSQL 系接近:用专用账户运行安装程序,初始化数据库实例,注册服务,默认端口 54321。登录账户与默认库名以安装向导里的选择为准。安装向导中的「兼容模式」(Oracle 或 PG 风格)会直接影响 SQL 语法行为与系统表结构,必须按业务来源库选择,并在测试环境验证应用兼容性,不能装完再调。

基本信息

运行账户专用账户(如 kingbase),不使用 root 运行安装
默认端口54321
安装目录示例/opt/Kingbase/ES/V8
常用工具initdb 初始化、sys_ctl 启停、ksql 客户端
关键选项兼容模式(Oracle/PG),影响 SQL 行为与系统视图

典型使用场景

  • 信创替换:从 Oracle 或 PostgreSQL 迁到金仓,先建实例验证兼容性
  • 新建生产库:按业务容量规划数据目录与实例参数
  • POC 验证:快速搭一套单实例做功能与性能比对
  • 开发自测:开发人员在本地或测试环境装一套验证 SQL 改写
  • 灾备部署:按同样流程在备机建实例并验证同步

安装与初始化(流程示例)

安装与初始化(流程示例)
id kingbase || useradd -m kingbase          # 创建专用账户
su - kingbase                              # 切换到该账户
# 解压或挂载安装包后运行安装程序(图形界面或 -i 命令行):
./KingbaseES_V008R006_*.run -i
cd /opt/Kingbase/ES/V8/Server/bin
./initdb -D /opt/Kingbase/ES/V8/data       # 初始化数据目录
./sys_ctl start -D /opt/Kingbase/ES/V8/data # 启动实例
ss -tlnp | grep 54321                      # 确认端口监听

验证

验证
/opt/Kingbase/ES/V8/Server/bin/ksql -U system -p 54321 -d test -c 'SELECT version();'
/opt/Kingbase/ES/V8/Server/bin/ksql -l        # 列出数据库
./sys_ctl status -D /opt/Kingbase/ES/V8/data  # 查看实例状态
# 注册为系统服务(按版本提供的脚本执行)
./root.sh 2>/dev/null || echo '按安装向导提示注册服务'

关键选项与参数

项目含义建议
兼容模式Oracle 或 PG 风格按业务来源库选择,装完难改
数据目录存放数据文件放独立盘,预留增长空间
端口默认 54321多实例必须错开
字符集数据库字符集与源库一致,避免乱码
登录用户如 system默认库与用户按向导选择
服务注册开机自启按向导或 root.sh 注册
安装向导中的兼容模式直接影响 SQL 行为:按业务来源库选择并在测试中验证应用是否能直接跑通。
root 直接运行安装程序会带来目录属主混乱,后续启动与服务注册都会受影响,按官方要求使用专用账户。

易错点

  • root 直跑安装造成属主混乱,后续启停报权限错误,务必用专用账户安装与运行。
  • 默认库与用户按向导选择,装完不先 ksql 登录确认就纳入配置管理,连接参数写错后难定位。
  • 兼容模式选错,应用 SQL 大量改写或直接执行失败,返工成本远高于装前确认。
  • 数据目录放在系统盘且未预留增长,运行一段时间后写满导致实例不可用。
  • 装完不放行防火墙 54321,应用连不上而数据库自检一切正常。

数据来源与参考

  • 人大金仓官方安装文档(公开资料)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌