服务器配置与管理-O2OA开发平台平台数据库配置信息样例

一、先决条件：

1、下载O2OA安装部署程序包（下载地址：https://www.o2oa.net/download.html）或者获取源代码编译成为安装部署程序包（服务器编译请参考：《源码编译-O2Server服务器源码编译教程》）

2、拥有通过文件系统修改 o2server 目录中的文件的权限，我们将会修改O2OA的配置文件。

3、指定的外部数据库已经安装，并且在部署O2OA的服务器可以正常通过客户端访问与操作数据库（非常重要，请保证网络与端口的通畅）。

4、第三方数据配置请参考《外部第三方数据库配置示例》

二、数据库连接信息说明

1、H2

H2为内置数据库，不需要进行配置。

在node_127.0.0.1.json配置的data中进行配置。  

"data": {
    "enable": true,
    "tcpPort": 20050.0,
    "webPort": 20051.0,
    "includes": [],
    "excludes": [],
    "jmxEnable": false,
    "cacheSize": 512.0,
    "logLevel": "WARN"
  }

参数说明：

• enable：是否启用，如果没有可用的externalDataSources.json文件，那么默认会在节点中启用本地的H2数据库作为默认的数据库。

• tcpPort：H2数据库jdbc连接端口,登录的用户名：sa，密码为xadmin的密码。数据库文件路径为：/o2server/local/repository/data/X.mv.db，一旦数据库文件被创建，那么该数据库的密码将被创建。

• webPort：H2数据库web客户端端口。H2提供一个web端的client，此端口为web端client的访问端口。用户名sa，密码为xadmin用户的密码。

• includes：设置此数据库存储的类。默认情况下存储所有实体类生成的数据表，如果需要对每个实体类进行单独的控制以提高系统运行性能，可以将不同的类存储到不同的节点上。此配置可以使用通配符。

• excludes：在此节点上不存储（排除）的实体类数据表，和includes配置一起产生作用。此配置可以使用通配符。

• jmxEnable：是否启动jmx。如果启用，可以通过本地的jmx客户端进行访问，不支持远程jmx客户端.。

• cacheSize：H2数据库缓存大小。设置H2用于作为缓存的内存大小，以MB作为单位，此配置默认为512MB。

• logLevel：默认日志级别。可选值：DEBUG、INFO、WARN、ERROR

2、Mysql

支持MySQL5.7以上版本,建议使用MySQL8，使用MYSQL数据库时请注意以下两点：

1、数据库字符集请使用：utf8mb4

2、修改参数max_allowed_packet

set global max_allowed_packet = 1024*1024*1000

数据库连接字符串信息：

[
  {
    "url":"jdbc:mysql://127.0.0.1:3306/X?autoReconnect=true&useSSL=false&useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8",      
    "username" : "root",
    "password" :"password",
    "includes": [],
    "excludes": [],
    "enable" : true
  }
]

3、Oracle

O2OA仅支持Oracle12c R2以上版本，不支持Oracle12.2以下版本(表名要支持30个以上的字符长度)。数据库连接字符串信息如下：

[
  {
    "url":"jdbc:oracle:thin:@//127.0.0.1:1521/orcl",
    "username" : "X",
    "password" :"password",
    "includes": [],
    "excludes": [],
    "enable" : true
  }
]

4、DB2

O2OA支持DB2v10以上版本。数据库连接字符串信息如下：

[
  {
    "url" : "jdbc:db2://127.0.0.1:50000/X",
    "username" : "db2admin",
    "password" :"password",
    "schema":"o2oa",
    "includes": [],
    "excludes": [],
    "enable" : true
  }
]

请注意：DB2默认对查询长度有限制，查询的长度不能超过字段长度。由于数据会引起一下错误:

Caused by: org.apache.openjpa.lib.jdbc.ReportingSQLException: DB2 SQL Error: SQLCODE=-302, SQLSTATE=22001

在这样的情况下可以通过设置以下参数解决：

DB2_DEFERRED_PREPARE_SEMANTICS=YES

schema以自身数据库实际配置的为准

5、SQLServer

O2OA支持SQL Server 2017 以上版本。数据库连接字符串信息如下：

[
  {
    "url" : "jdbc:sqlserver://127.0.0.1:1433;DatabaseName=X;selectMethod=cursor;sendStringParametersAsUnicode=false",
    "username" : "sa",
    "password" :"password",
    "includes": [],
    "excludes": [],
    "enable" : true
  }
]

6、PostgreSQL

数据库连接字符串信息如下：

[
  {
    "url" : "jdbc:postgresql://localhost:5432/X",
    "username" : "postgres",
    "password" :"password",
    "schema":"o2oa",
    "includes": [],
    "excludes": [],
    "enable" : true
  }
]

schema以自身数据库实际配置的为准

7、Informix

数据库连接字符串信息如下：

[
  {
    "url" : "jdbc:sqlserver://127.0.0.1:1433;DatabaseName=X;selectMethod=cursor;sendStringParametersAsUnicode=false",
    "username" : "sa",
    "password" :"password",
    "includes": [],
    "excludes": [],
    "enable" : true
  }
]

8、国产达梦数据库

O2OA支持DM7/DM8数据库。数据库连接字符串信息如下：

[
  {
    "url" : "jdbc:dm://127.0.0.1/X",
    "username" : "admin",
    "password" :"password",
    "includes": [],
    "excludes": [],
    "enable" : true,
    "statEnable" : false,
    "statFilter" : false
  }
]

9、国产人大金仓数据库

O2OA支持人大金仓数据库支持V7、V8，但两个版本的jdbc驱动不同。数据库连接字符串信息如下：

人大金仓 V7：

[
  {
    "url" : "jdbc:kingbase://127.0.0.1:54321/X",
    "username" : "system",
    "password" :"krms",
    "schema":"o2oa",
    "includes": [],
    "excludes": [],
    "enable" : true
  }
]

人大金仓 V8：

[
  {
    "url": "jdbc:kingbase8://127.0.0.1:54321/X",
    "username": "system",
    "password": "krms",
    "schema":"o2oa",
    "includes": [],
    "excludes": [],
    "enable": true,
    "statEnable": false,
    "statFilter": false,
    "dictionary":"com.x.base.core.openjpa.jdbc.sql.Kingbase8Dictionary"
  }
]

人大金仓 V8R6：

V8R6版本跟之前的V8版本有差异，所以配置文件内容也有区分。数据库连接字符串信息如下：

[
  {
    "url": "jdbc:kingbase8://127.0.0.1:54321/X",
    "username": "system",
    "password": "krms",
    "schema":"o2oa",
    "includes": [],
    "excludes": [],
    "enable": true,
    "statEnable": false,
    "statFilter": false,
    "dictionary":"com.x.base.core.openjpa.jdbc.sql.Kingbase8R6Dictionary"
  }
]

schema以自身数据库实际配置的为准

10、南大通用数据库

O2OA支持南大通用数据库的通用和华库安全两个版本，两个版本的JDBC驱动不同。数据库连接字符串信息如下：

GBase 8s  V8

[
  {
    "url": "jdbc:gbasedbt-sqli://127.0.0.1:9089/gbasedb:GBASEDBTSERVER=gbaseserver",
    "username": "gbasedbt",
    "password": "password",
    "driverClassName": "",
    "includes": [],
    "excludes": [],
    "maxTotal": 200,
    "enable": true,
    "testConnectionOnCheckin": false,
    "testConnectionOnCheckout": false,
    "statEnable" :false
  }
]

华库安全数据库管理系统软件V8.8

[
  {
    "url":"jdbc:gbase://127.0.0.1:5258/X?allowPublicKeyRetrieval=true&useSSL=false&autoReconnect=true&useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8",      
    "username" : "sysdba",
    "password" :"123456",
    "includes": [],
    "excludes": [],
    "maxTotal":200,
    "enable" : true,
    "testConnectionOnCheckin":false,
    "testConnectionOnCheckout":false,
    "autoCommit" : false,
    "statEnable" :false
  }
]

以上内容是O2OA开发平台主流数据库国产数据库连接配置信息样例的相关说明，希望这些内容对您有帮助。以下内容您可能会感兴趣：

《外部第三方数据库配置示例》

《O2OA使用openGauss(华为高斯数据库)配置》

《如何访问和操作H2内置数据库》

《修改数据库驱动jar包操作说明》