dylan-tao/nacos-plus

Nacos support the database type: OpenGauss、GaussDB、DM、MariaDB、PostgreSQL、Oracle、SQLServer

NacosPlus，为信创国产数据库爱心发电。

Star⭐一下(右上角)，持续版本维护的动力😊

Watch一下，遇到问题提Issues可实时接收问题进展

Fork一下，完善和特殊场景适配后，记得Pull Request为信创添砖加瓦

Support the database type:

✅ supported ⌛ planning ❌ not planned

Database Type	Database Version	Database Client Version	Supported	NacosPlus Version
Mysql/MariaDB	5.7.36	8.0.33	✅	2.2.0.1+
PostgreSQL	90204	42.5.1	✅	2.2.0.1+
OpenGauss	3.0.0	2.0.0	✅	2.2.0.2+
GaussDB	2.1.0	2.0.0	✅	2.2.0.2+
Oracle	11.2.0.1	11.2.0.4	✅	2.3.2.1+
DM DBMS	8.1.3.100	8.1.3.140	✅	2.3.2.2+
Sql Server	2019	12.4.2.jre8	✅	2.3.2.3+
OceanBase	-	-	⌛	2.3.2.7+

Manufactured Product

nacos-2.x.x\distribution\target\nacos-server-2.x.x.tar
nacos-2.x.x\distribution\target\nacos-server-2.x.x.zip

SQL Schema

{db}-schema.sql is in the config directory of the manufactured product

nacos-2.x.x\distribution\target\nacos-server-2.x.x.tar\conf\{db}-schema.sql
nacos-2.x.x\distribution\target\nacos-server-2.x.x.zip\conf\{db}-schema.sql

DB Connection Configuration

### If use MySQL or MariaDB as datasource:
#spring.datasource.platform=mysql
#db.pool.config.driver-class-name=com.mysql.cj.jdbc.Driver
#db.url.0=jdbc:mysql://127.0.0.1:3306/nacos_server?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
#db.user.0=nacos
#db.password.0=123456

##### If use PostgreSQL or OpenGauss or GaussDB as datasource:
#spring.sql.init.platform=postgresql
#db.pool.config.driver-class-name=org.postgresql.Driver
#db.url.0=jdbc:postgresql://127.0.0.1:5432/nacos_server
#db.user.0=nacos
#db.password.0=123456

##### If use Oracle as datasource:
#spring.sql.init.platform=oracle
#db.pool.config.driver-class-name=oracle.jdbc.OracleDriver
#db.url.0=jdbc:oracle:thin:@//127.0.0.1:1521/nacos_server
#db.user.0=nacos
#db.password.0=123456
#db.testQuery=select 1 from dual

##### If use DM as datasource:
### WARNING: db.user.0 must be NACOS_SERVER, create this account
#spring.sql.init.platform=dm
#db.pool.config.driver-class-name=dm.jdbc.driver.DmDriver
#db.url.0=jdbc:dm://127.0.0.1:5236/nacos_server?keyWords=type,usage,role,action,password&useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=GMT%2B8
#db.user.0=NACOS_SERVER
#db.password.0=123456
#db.testQuery=select 1

##### If use SqlServer as datasource:
#spring.sql.init.platform=sqlserver
#db.pool.config.driver-class-name=com.microsoft.sqlserver.jdbc.SQLServerDriver
#db.url.0=jdbc:sqlserver://127.0.0.1:1433;DatabaseName=nacos_server;trustServerCertificate=true
#db.user.0=nacos
#db.password.0=123456
#db.testQuery=select 1

Start by the provided startup package

Step 1: Download the binary package

You can download the package from the latest stable release.

Take release nacos-server-2.x.x.zip for example:

unzip nacos-server-2.x.x.zip
cd nacos/bin 

Step 2: Start Server

On the Linux/Unix/Mac platform, run the following command to start server with cluster mode:

sh startup.sh -m cluster

On the Windows platform, run the following command to start server with cluster mode. Alternatively, you can also double-click the startup.cmd to run standalone NacosServer.

startup.cmd -m cluster

Package ReBuild

mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U

FAQ

Get 【FAQ-x】 list from issues, Click me !!!

Emergency Support

The author's WeChat QR code only provides emergency support. You must submit ISSUE before seeking help, otherwise the answer will not be supported.

nacos-plus's Issues

当前版本无法启动

发布的2.2.0版本，默认application.properties启动会报错：Caused by: java.lang.IllegalArgumentException: db.num is null
配置文件，解除该行注释后，再次启动会报错：
Caused by: java.lang.IllegalStateException: No DataSource set

能更新到最新版吗？

作者能更新下最新版吗？
另外，如果能提供一个封装好的docker镜像就好了。

Oracle脚本执行异常

oracle sql 脚本存在存储过程，需要在存储过程结束后面，加一个 "/" , 然后整个SQL执行就没问题了

【FAQ-1】org.postgresql.util.PsQLException: Invalid or unsupported by client SCRAM mechanisms

password_encryption_type未兼容postgreSQL的访问, 当password_encryption_type=1时，需要使用opengauss-jdbc的驱动jar，否则会报错。
2.2.0.2版本已修复GaussDB的此问题，如果服务端是原生postgreSQL的话，用2.2.0.1版本或最新版本即可。

🙋 问题简述 | 集群的配置中心读取不到配置文件

在版本2.3.2.4，集群cluster配置，Oracle数据库，nacos登录、配置文件都能成功

启动服务加载配置中心文件，找不到文件
后面试了standalone是可以读取到文件的

查看nacos的access日志，发现configs交易出现异常，通过postman进行测试，交易报config data not exist

通过postman测试standalone版本时，数据可以正常返回。
想问下是什么问题，或者配置有什么要注意的地方

Unsatisfied dependency expressed through field namespacePersistService

🙋 问题简述 | if you have the docker image that support postgresql database

您使用的版本？例如：2.3.2.4 | Your usage version? PS：2.3.2.4

您做了什么操作？| What did you do?

预期行为 | Expected behavior

实际行为 | Actual behavior

问题重现步骤 | Steps to reproduce the problem

【FAQ-3】Caused by: java.lang.IllegalStateException: No DataSource set

一般是数据库服务端不兼容问题，可以看下\nacos\logs\config-server.log或naming-server.log内的详细错误，解决不了提Issues即可。

• 已知Case1：db.url.0配置错误，解决思路：检查url拼接问题，Oracle SID和ServiceName模式概念不理解会出现此问题；

• 已知Case2：默认nacos内的sql语句，不会包含列双引号标记（"列名"）或表名拼接模式名（库名.表名），个别数据库引擎默认要求，解决思路：修改数据库引擎支持不用双引号标记列和不用表名拼接模式名， 如DM数据默认创建库名、表及列名为大写来避免列必须双引号标记问题，用库名账号访问库实例避免必须拼接模式名问题；

nacos-server-2.3.2.zip 修改nacos上配置文件不生效

修改配置之后读取的配置还是创建配置时的值，重启nacos原先配置文件读取为空 Ignore the empty nacos configuration and get it based on dataId，启动命令为：sh startup.sh -m standalone

【FAQ-2】opengauss-jdbc-2.0.0在Maven公共仓库不能找到

此版本为银行内部提供的商业稳定版本，如果本地需要重新编译打包请将根目录lib下的jar包deploy到自己公司的maven仓库即（2.2.0.2版本开始使用此jar包）

<dependency>
    <groupId>org.opengauss</groupId>
    <artifactId>opengauss-jdbc</artifactId>
    <version>2.0.0</version>
</dependency>

🙋 问题简述 使用dm数据库连接，进入nacos之后有两个接口会报500| [Question] Brief description of the problem

您使用的版本？例如：2.3.2.4 | Your usage version? PS：2.3.2.4

ps:2.3.2.4

您做了什么操作？| What did you do?

win11

预期行为 | Expected behavior

实际行为 | Actual behavior

问题重现步骤 | Steps to reproduce the problem

🙋 问题简述 | [Question] Handler dispatch failed

您使用的版本？例如：2.3.2.4 | Your usage version? PS：2.3.2.4

最新版

您做了什么操作？| What did you do?

none

预期行为 | Expected behavior

runing

实际行为 | Actual behavior

问题重现步骤 | Steps to reproduce the problem

【FAQ-4】Too many files with unapproved license: 3 See RAT report in: workspace/nacos-plus/xxx/target/rat.txt

本地编译打包时，从nacos-2.3.2.x切换到分支2.2.0.x，由于代码模块变动导致的rat maven插件扫描不通过，解决思路：找到生成的rat.txt报告里被拦截的模块文件直接删除即可