# nacos2.5.1-plugins-pgsql

**Repository Path**: paul.lmc/nacos2.5.1-plugins-pgsql

## Basic Information

- **Project Name**: nacos2.5.1-plugins-pgsql
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-10-31
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nacos PostgreSQL 插件

该项目为 [Nacos](https://github.com/alibaba/nacos) 提供 PostgreSQL 数据库支持，允许使用 PostgreSQL 作为 Nacos 的持久化存储。

## 简介

Nacos 是一个动态服务发现、配置管理和服务管理平台，支持多种数据库作为其数据持久化方案。本插件实现了对 PostgreSQL 数据库的支持，通过实现 Nacos 的数据访问接口，使得 Nacos 能够无缝对接 PostgreSQL。

插件主要包含以下功能模块：
- **配置信息管理**：支持从 PostgreSQL 查询、写入、更新配置信息。
- **灰度发布支持**：实现灰度配置信息的存储与查询。
- **Beta 测试支持**：支持 Beta 版本配置信息的管理。
- **标签与分组管理**：支持基于标签和分组的配置信息查询。
- **容量管理**：支持对分组和租户的容量统计与管理。
- **历史配置管理**：支持配置历史记录的存储与查询。
- **租户管理**：支持租户信息的管理。
- **SQL 脚本**：提供 PostgreSQL 数据库初始化脚本。

## 安装与使用

### 前提条件

- 已安装 [Nacos 2.5.1](https://github.com/alibaba/nacos)
- 已安装 PostgreSQL 数据库（版本兼容性请参考 Nacos 官方文档）

### 部署插件

1. **构建插件**  
   确保已安装 Maven，然后执行以下命令进行构建：

   ```bash
   cd nacos-datasource-plugin-ext-master
   mvn clean package
   ```

   构建完成后，插件 JAR 文件将生成在 `target` 目录下。

2. **部署插件**  
   将构建好的插件 JAR 文件复制到 Nacos 的插件目录中（通常为 `plugins` 或 `lib` 目录）。

3. **配置 PostgreSQL 数据源**  
   修改 Nacos 的配置文件 `application.properties`，配置 PostgreSQL 数据源信息：

   ```properties
   spring.sql.init.platform=postgresql
   db.num=1
   db.url.0=jdbc:postgresql://localhost:5432/basdb?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=Asia/Shanghai
   db.user.0=postgres
   db.password.0=123456
   db.pool.config.driver-class-name=org.postgresql.Driver
   ```

4. **初始化数据库**  
   使用项目中提供的 SQL 脚本 `conf/nacos-pg.sql` 初始化 PostgreSQL 数据库。

5. **启动 Nacos**  
   启动 Nacos 服务，插件将自动加载并使用 PostgreSQL 作为数据源。

## 项目结构

- `src/main/java/com/alibaba/nacos/plugin/datasource/impl/pgsql`：PostgreSQL 数据访问实现类。
- `src/main/resources/conf`：数据库初始化脚本。
- `pom.xml`：Maven 项目配置文件。

## 依赖

- `nacos-api`
- `nacos-common`
- `nacos-datasource-plugin`
- PostgreSQL JDBC 驱动（已包含在插件中）

## 开发者信息

该项目由 [wanggang1485](https://gitee.com/wanggang1485) 维护。

## 许可证

本项目使用 [Apache License 2.0](LICENSE) 协议。