KingbaseES 数据库配置

人大金仓数据库（KingbaseES）是北京人大金仓信息技术股份有限公司研发的具有自主知识产权的国产大型通用数据库管理系统，致力于解决高并发、高可靠数据存储计算问题。iPortal 支持使用 KingbaseES V8 R6 版本数据库存储门户数据和安全信息。

门户数据存储配置

iPortal 门户数据存储的数据库配置，建议在 iPortal 启动之前（创建初始化管理员账号之前）进行配置，配置信息在安装目录（%SuperMap iPortal_HOME%\webapps\iportal\WEB-INF）下的 iportal.xml 配置文件中，详情可参见：iPortal 配置文件说明。使用 KingbaseES 数据库时，您只需将默认的 SQLite 数据库连接池配置信息注释掉或删除掉，将如下 KingbaseES 数据库连接池配置信息的注释符号去掉即可，示例配置如下：

<dbType>POSTGRESQL </dbType>

<driverClass>org.postgresql.Driver</driverClass>

<jdbcUrl>jdbc:postgresql://localhost:54321/iportal?useUnicode=true&characterEncoding=UTF-8</jdbcUrl>

<username>system</username>

<dbType>：数据库类型，字符需要大写。由于 KingbaseES V8 R6 数据库采用 PostgreSQL 内核，因此该处填写 POSTGRESQL。
<driverClass>：数据库驱动的类全名。
<jdbcUrl>：连接至驱动的 url，如果您的 SuperMap iPortal 和 KingbaseES 在同一台机器中，IP 就为 localhost，如果不在同一台机器上，此处的 IP 应该写 KingbaseES 所在机器的 IP 地址。KingbaseES 的默认端口为：54321，您可以根据您安装的 KingbaseES 的实际情况来配置。iportal 为数据库名，只需与您创建的数据库名称一致即可。
<maxPoolSize>：连接池在同一时刻内所提供最大活动连接数。
<initialPoolSize>：初始化连接池大小。
<minPoolSize>：连接池在同一时刻内所提供最小活动连接数。
<maxIdleTime>：最大空闲时间，maxIdleTime 秒内未使用则连接被丢弃。若为0则永不丢弃，默认值: 0。
<maxWait>：当发生异常时数据库等待最大毫秒数（当没有可用连接时）。
<username>：用户名。根据您实际安装 KingbaseES 时设置的用户名进行配置。
<password>：密码。根据您实际安装 KingbaseES 时设置的密码进行配置。

注意：

以上操作以及切换至 KingbaseES 数据库的操作，均请在 iPortal 初始化服务启动之前（即创建管理员账号之前），如果在 iPortal 的使用过程中进行切换数据库等操作，请您自行处理数据库的信息同步。

安全信息存储配置

iPortal 支持将安全信息存储在 KingbaseES 数据库中，iPortal 的管理员登录门户后，在门户首页点击“管理”> "安全"> "安全配置"，选择"安全信息存储"选项卡，进入安全信息存储配置页面。使用 KingbaseES 数据库存储安全信息的配置如下：

存储类型：由于 KingbaseES V8 R6 数据库采用 PostgreSQL 内核，因此该处选择 PostgreSQL 数据库。
服务地址：KingbaseES 的服务地址形式为 {ip}:{port}/{database}。其中，{ip}为 KingbaseES 所在机器的 IP 地址，{port}为 KingbaseES 的服务端口，默认为 54321，{database} 为数据库名。这些参数您可以根据您安装的 KingbaseES 的实际情况来配置。

用户名：具有数据库{database}权限的用户。
密码：该用户的密码。
使用数据库存储的管理员：针对数据库中已经存储了初始化管理员（例如：admin1）的情况，两种选择：默认不勾选，则将使用当前 iPortal 的初始化管理员（admin2），同时覆盖数据库中存储的初始化管理员（数据库中存储的管理员将被改写为 admin2）；如果勾选，将使用数据库中已经存储的初始化管理员（admin1），而不是当前 iPortal 的管理员（例如:admin2）。

点击“切换”按钮后，iPortal 会自动将初始化管理员信息（第一次启动 iPortal 时创建的管理员账户）同步到配置的数据库中，同时使用该数据库存储后续生成的安全信息。

此外，如果您想切换回默认的本地 SQLite 数据库，直接选择存储位置为“SQLite”数据库即可。