印刻数据库

外观

KingBaseES 在 Windows 上安装 ​

安装前准备 ​

系统要求 ​

配置项最低要求推荐配置
操作系统Windows Server 2012 R2/Windows 10Windows Server 2019/Windows 11
CPU2核4核及以上
内存4GB8GB及以上
磁盘空间50GB100GB及以上
文件系统NTFSNTFS
网络100Mbps1Gbps及以上

软件依赖 ​

  • Microsoft Visual C++ 2015-2022 Redistributable (x64)
  • .NET Framework 4.6.2 或更高版本

安装包获取 ​

从官方渠道获取KingBaseES安装包，目前常用版本包括：

  • KingBaseES V8 R6
  • KingBaseES V8 R7

图形化安装步骤 ​

1. 启动安装程序 ​

双击KingBaseES安装包（如KingbaseES_V8R6_W64.exe），进入安装向导：

  1. 选择语言：默认简体中文
  2. 点击"下一步"进入欢迎页面
  3. 阅读许可证协议，勾选"我接受许可证协议"，点击"下一步"

2. 安装类型选择 ​

选择安装类型：

  • 完整安装：安装所有组件，包括数据库服务器、客户端工具、开发工具等
  • 自定义安装：可选择性安装组件
  • 客户端安装：仅安装客户端工具

推荐选择"完整安装"以获得所有功能。

3. 安装路径配置 ​

  • 默认安装路径：C:\Program Files\Kingbase\KingbaseES\V8
  • 数据文件路径：默认与安装路径分离，如C:\KingbaseData
  • 日志文件路径：默认C:\KingbaseLog

注意：安装路径和数据文件路径应避免使用中文和特殊字符。

4. 端口配置 ​

  • 数据库服务端口：默认54321
  • 集群通信端口：默认54322（仅集群安装时显示）

建议：如需同时安装多个KingBaseES实例，需修改端口号避免冲突。

5. 超级用户密码设置 ​

设置数据库超级用户（默认用户名：system）的密码：

  • 密码长度至少8位
  • 包含大小写字母、数字和特殊字符
  • 避免使用弱密码

6. 字符集配置 ​

选择数据库默认字符集：

  • UTF8（推荐，支持国际化字符）
  • GBK（兼容中文环境）
  • GB18030（支持更多中文生僻字）

7. 初始化参数配置 ​

根据实际需求调整初始化参数：

  • 最大连接数：默认100，根据业务需求调整
  • 共享缓冲区：默认256MB，推荐设置为系统内存的25%
  • WAL缓冲区：默认64MB，可根据写入负载调整

8. 开始安装 ​

确认所有配置无误后，点击"安装"按钮开始安装过程。

9. 安装完成 ​

安装完成后，可选择：

  • 启动KingBaseES服务
  • 启动KingBaseES Manager（KEM）
  • 查看安装日志

静默安装步骤 ​

1. 准备静默安装配置文件 ​

创建一个配置文件（如silent_install.xml），内容示例：

xml
<?xml version="1.0" encoding="UTF-8"?>
<KingbaseESInstallConfig>
  <InstallType>Full</InstallType>
  <InstallPath>C:\Program Files\Kingbase\KingbaseES\V8</InstallPath>
  <DataPath>C:\KingbaseData</DataPath>
  <LogPath>C:\KingbaseLog</LogPath>
  <Port>54321</Port>
  <SuperPassword>YourStrongPassword@123</SuperPassword>
  <Charset>UTF8</Charset>
  <MaxConnections>200</MaxConnections>
  <SharedBuffers>2GB</SharedBuffers>
</KingbaseESInstallConfig>

2. 执行静默安装 ​

在命令提示符中以管理员身份运行：

cmd
KingbaseES_V8R6_W64.exe /silent /config=silent_install.xml /log=install.log

3. 验证安装结果 ​

查看安装日志文件（如install.log）确认安装是否成功。

安装后验证 ​

1. 检查服务状态 ​

在"服务"管理控制台中，确认KingBaseES服务（默认名称：KingbaseES-V8）状态为"正在运行"。

2. 连接数据库验证 ​

使用KingBaseES客户端工具连接数据库：

cmd
ksql -h localhost -p 54321 -U system -d kingbase

输入密码后，若成功连接到数据库，显示类似以下信息：

ksql (V8R6) 输入 "help" 来获取帮助信息.

kingbase=#

3. 执行基本SQL测试 ​

sql
-- 创建测试数据库
CREATE DATABASE testdb;

-- 切换到测试数据库
\c testdb;

-- 创建测试表
CREATE TABLE test_table (
    id SERIAL PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 插入测试数据
INSERT INTO test_table (name) VALUES ('测试数据');

-- 查询测试数据
SELECT * FROM test_table;

-- 删除测试数据库
\c kingbase;
DROP DATABASE testdb;

安装常见问题 ​

Q1: 安装过程中提示"无法创建服务" ​

解决方案：

  • 检查当前用户是否具有管理员权限
  • 确保安装路径和数据文件路径具有写入权限
  • 关闭杀毒软件和防火墙后重试

Q2: 安装完成后无法启动服务 ​

解决方案：

  • 检查数据文件路径是否正确
  • 查看日志文件（C:\KingbaseLog\startup.log）获取详细错误信息
  • 确认端口未被占用：netstat -ano | findstr 54321

Q3: 连接数据库时提示"密码错误" ​

解决方案：

  • 确认密码输入正确，注意大小写
  • 检查是否开启了大小写敏感验证
  • 可通过ksql工具重置密码：
    cmd
    ksql -h localhost -p 54321 -U system -d template1 -c "ALTER USER system WITH PASSWORD '新密码';"

Q4: 安装过程中磁盘空间不足 ​

解决方案：

  • 清理磁盘空间，确保至少有50GB可用空间
  • 选择自定义安装，减少不必要的组件
  • 更改安装路径到空间充足的磁盘

版本差异注意事项 ​

V8 R6 与 V8 R7 安装差异 ​

特性V8 R6V8 R7
安装包大小约1GB约1.5GB
默认端口5432154321
新增组件无KingBaseES Manager 3.0
安装向导传统向导优化后的图形化向导
静默安装支持增强支持，配置更灵活

安装后的基本配置 ​

1. 配置环境变量 ​

添加以下环境变量到系统环境变量中：

  • KINGBASE_HOME：指向安装路径，如C:\Program Files\Kingbase\KingbaseES\V8
  • PATH：添加%KINGBASE_HOME%\bin

2. 配置防火墙 ​

允许KingBaseES端口通过防火墙：

cmd
netsh advfirewall firewall add rule name="KingBaseES" dir=in action=allow protocol=TCP localport=54321

3. 配置远程访问 ​

修改kingbase.conf文件：

ini
# 监听所有网络接口
listen_addresses = '*'

修改pg_hba.conf文件，添加远程访问规则：

# 允许所有IP访问（生产环境不推荐）
host    all             all             0.0.0.0/0               md5

卸载KingBaseES ​

图形化卸载 ​

  1. 打开"控制面板" → "程序和功能"
  2. 找到"KingBaseES V8"
  3. 点击"卸载"，按照向导完成卸载

命令行卸载 ​

cmd
"C:\Program Files\Kingbase\KingbaseES\V8\uninstall\uninstall.exe" /silent

注意：卸载前请备份好所有数据文件，卸载过程会删除数据文件。

最佳实践 ​

  1. 安装路径规划：将安装路径、数据文件路径、日志文件路径分离到不同磁盘，提高性能和安全性
  2. 权限管理：安装和运行KingBaseES服务的用户应具有适当的权限，避免使用管理员账户直接运行
  3. 备份策略：安装完成后立即配置备份策略，包括全量备份和增量备份
  4. 监控配置：安装后及时配置监控，使用KingBaseES Manager或第三方监控工具
  5. 定期更新：关注官方发布的补丁和更新，及时安装以修复安全漏洞和性能问题

故障排查 ​

安装日志位置 ​

  • 安装过程日志：C:\KingbaseLog\setup.log
  • 服务启动日志：C:\KingbaseLog\startup.log
  • 数据库运行日志：C:\KingbaseData\kingbase.log

常见错误代码 ​

错误代码可能原因解决方案
1001安装包损坏重新下载安装包
2003端口被占用更改端口号或关闭占用端口的进程
3001权限不足以管理员身份运行安装程序
4001磁盘空间不足清理磁盘空间
5002数据库初始化失败查看日志文件获取详细错误信息