# 京东StarDB数据库项目化部署方案
# 前言
本文介绍京东StarDB集中式集群数据库的项目化部署方案，本方案没有特别注意的地方，将其当做MySQL8数据库标准部署即可。
StarDB是分布式数据库，部署支持分布式集群和集中式集群两种模式，我们产品不适合分布式，故采用集中式集群部署即可。
京东StarDB数据库标准产品未支持，目前可项目化集成（有项目成功上线案例）。
适配版本：9.0及更高版本，参照本手册集成配置，暂不涉及定制开发代码适配。
项目化支持，意味着可能存在项目化适配成本，并且项目化过程中产生的BUG、以及后续OA版本升级需要额外项目化成本解决
转库注意事项：
如项目需要Oracle、SQLServer、PostgreSQL或其它数据库转MySQL数据库均存在转库风险，MySQL数据库每行数据不能超过65535字节，意味着：
- 如使用utf8字符集（每个字符3字节），则单表字段VARCHAR总和不能超21845；
- 如使用utf8mb4字符集（每个字符4字节），则单表字段VARCHAR总和不能超16383；
- 而Oracle等数据库则无此限制（意味着原库单表字段VARCHAR总和超过21845），此时转MySQL会直接报错
- 此问题常见于表单动态表（formmain_xxx），稍微复杂一点的表单即会遇到
- 此问题是数据库架构决定，应用层面无优化方案，如要解决，就必须人工调整、拆分表单，成本周期较长
# 部署示例
OA版本：A8+ V9.0（非信创）
中间件：安装程序默认带的Tomcat
数据库：StartDB集中式数据库（兼容MySQL8）
# 数据库信息
数据库连接URL格式：jdbc:mysql://ip:3306/v3x?autoReconnection=true&useSSL=false&allowPublicKeyRetrieval=true
数据库驱动类：com.mysql.jdbc.Driver
JDBC DatabaseMetaData.getDatabaseProductName()返回值：MySQL
数据库内核：等同于MySQL8
# 操作步骤
# 1、第三方数据库安装
数据库安装由第三方数据库厂商完成，对数据库厂商提部署要求：MySQL8内核、集中部署、UTF-8编码格式、不区分大小写。
# 2、执行部署
因为StarDB提供的是MySQL8的方案，所以使用标准产品的部署工具选择MySQL进行部署即可。
非信创就基于标准的SeeyonInstall工具做部署即可，数据库连接使用京东StarDB厂商提供的URL，其中useSSL=false&allowPublicKeyRetrieval=true参数厂商可能不会提供，这个需要安装过程中配置数据库URL时加上去：
jdbc:mysql://ip:3306/v3x?autoReconnection=true&useSSL=false&allowPublicKeyRetrieval=true
数据库驱动包使用MySQL8的，非信创部署工具无需配置，信创无法使用部署工具的，自行提取mysql8的驱动jar并放置到中间件下即可。
数据库驱动类名为com.mysql.jdbc.Driver，非信创部署工具无需配置，信创中间件可以配置此驱动类名。
安装部署完成后，非信创环境通过查看base/conf/datasourceCtp.properties文件能看到如下数据库连接信息：
通过SeeyonConfig也能看到连接信息：
以上完成后，正常启动OA系统即可。
