当前位置：首页 > news >正文

Nacos-3.0.3 适配PostgreSQL数据库

news 2025/8/31 5:14:26

🧑 博主简介：CSDN博客专家，历代文学网（PC端可以访问：https://literature.sinhy.com/#/?__c=1000，移动端可微信小程序搜索“历代文学”）总架构师，15年工作经验，精通Java编程，高并发设计，Springboot和微服务，熟悉Linux，ESXI虚拟化以及云原生Docker和K8s，热衷于探索科技的边界，并将理论知识转化为实际应用。保持对新技术的好奇心，乐于分享所学，希望通过我的实践经历和见解，启发他人的创新思维。在这里，我希望能与志同道合的朋友交流探讨，共同进步，一起在技术的世界里不断学习成长。
技术合作请加本人wx（注明来自csdn）：foreast_sea

在这里插入图片描述

Nacos-3.0.3 适配PostgreSQL数据库

在这里插入图片描述

引言

本文重点介绍基于Nacos-3.0.3最新版本如何用PostgreSQL数据库来存储，也就是如何打造或直接获取能适配Nacos-3.0.3的PostgreSQL数据库插件。

Nacos-3.0.3版本最直接最快集成PostgreSQL数据源的方法就是引入依赖，这也是本文重点，也就是核心部分，我把它放这里：

<dependency><groupId>com.sinhy</groupId><artifactId>nacos-postgresql-datasource-plugin-ext</artifactId><version>3.0.3</version>
</dependency>

我已将pg数据源插件打成了jar包，传到maven中央仓库，大家只需下载该jar，然后放入nacos的home目录下的plugins插件目录，再配置pg数据源信息，即可使用！

直接下载该jar：https://repo1.maven.org/maven2/com/sinhy/nacos-postgresql-datasource-plugin-ext/3.0.3/nacos-postgresql-datasource-plugin-ext-3.0.3.jar

一、`PostgreSQL`数据库源码地址

为了方便后续及时更新Nacos每个版本对应的PostgreSQL数据库插件，我们特意基于官方提供的Nacos插件工程进行了二开，然后打算后续自己维护这部分功能，因此给大家分享：
Nacos-3.0.3的PostgreSQL数据库插件源码地址
https://github.com/lilinhai/nacos-datasource-plugin-ext

注意：目前该工程中，只有PostgreSQL插件可以正常使用，其余数据库暂未做相关深入适配和测试！

二、灰度配置适配

增加了一个抽象类，用于适配其他数据库多灰度配置表的支持：

public abstract class BaseConfigInfoGrayMapper extends AbstractDataSourceMapper implements ConfigInfoGrayMapper
{/*** <pre>构造方法</pre>* @since 2025-04-27 10:03* @param databaseDialect*/protected BaseConfigInfoGrayMapper(DatabaseDialect databaseDialect){super(databaseDialect);}@Overridepublic String getTableName(){return TableConstant.CONFIG_INFO_GRAY;}@Overridepublic MapperResult findAllConfigInfoGrayForDumpAllFetchRows(MapperContext context){String sql = " SELECT id,data_id,group_id,tenant_id,gray_name,gray_rule,app_name,content,md5,gmt_modified " + " FROM  config_info_gray  ORDER BY id ";sql = databaseDialect.getLimitPageSqlWithOffset(sql, context.getStartRow(), context.getPageSize());return new MapperResult(sql, Collections.emptyList());}
}

三、源码打包构建

源码下载本地后，也可以手动打包构建，输出pg插件，如下图：
在这里插入图片描述
执行maven构建命令：

clean package

将输出jar到target目录下：
在这里插入图片描述

将jar拷贝到nacos的plugins目录下即可

四、nacos3.0 基于pg启动

启动需要输入安全密钥：
在这里插入图片描述输入后回车、即可访问8080（管理端口）端口：

五、插件概述

5.1、简介

从Nacos2.2版本开始，Nacos提供了数据源扩展插件，以便让需要进行其他数据库适配的用户自己编写插件来保存数据。当前项目插件目前已简单适配Postgresql。

当前插件项目地址：
https://github.com/lilinhai/nacos-datasource-plugin-ext

当前项目是基于Nacos3.0.1版本的扩展插件口进行开发，同时也是基于以下项目的一个分支进行的而开：
https://github.com/nacos-group/nacos-plugin/tree/develop/nacos-datasource-plugin-ext

很感谢阿里nacos团队的贡献，你们一如既往的迭代nacos版本，给你们说声辛苦了，但是却忘记了nacos的其他数据源适配，比如postgresql。

5.2、插件工程结构说明

nacos-datasource-plugin-ext-base工程为数据库插件操作的适配抽象定义。
nacos-postgresql-datasource-plugin-ext工程可打包适配Postgresql的数据库插件

六、下载和使用

6.1、插件引入

方式一：将nacos的postgresql插件下载下来，将依赖手动拷贝到nacos的home目录下的plugins目录下（nacos-3.0.1/plugins）即可。

以下nacos的postgresql插件版本仅支持nacos3.0.1，采用jdk17编译级：

<dependency><groupId>com.sinhy</groupId><artifactId>nacos-postgresql-datasource-plugin-ext</artifactId><version>3.0.2</version>
</dependency>

方式二：下载当前插件项目源码，打包为jar包，将该文件的路径配置到startup.sh文件中，使用Nacos的loader.path机制指定该插件的路径，可修改startup.sh中的loader.path参数的位置进行指定。

6.2、修改数据库配置文件

在application.properties文件中声明postgresql的配置信息：

spring.sql.init.platform=postgresql#spring.datasource.platform=postgresql### Count of DB:
db.num=1### Connect URL of DB:
db.url.0=jdbc:postgresql://127.0.0.1:5432/nacos?currentSchema=public&useUnicode=true&tcpKeepAlive=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&reWriteBatchedInserts=true&ApplicationName=nacos_java
db.user.0=nacos
db.password.0=nacos
db.pool.config.connectionTimeout=30000
db.pool.config.validationTimeout=10000
db.pool.config.maximumPoolSize=20
db.pool.config.minimumIdle=2
db.pool.config.driverClassName=org.postgresql.Driver# 如果是 oracle 则需要改为 SELECT * FROM dual 
# db.pool.config.connectionTestQuery=SELECT 1