菜单
Nacos 适配虚谷数据库(XuguDB)的完整指南。当用户需要将基于 Nacos 的服务发现与配置管理平台配置或适配到虚谷数据库时使用此技能，包括版本获取、数据源配置、数据库初始化、启动配置、集群配置等。适用于从 MySQL/Oracle 迁移或新建虚谷数据库项目。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Activiti 工作流引擎与虚谷数据库（XuguDB）集成适配指南。当用户需要在 Spring Boot 项目中使用 Activiti 工作流引擎连接 XuguDB 时使用此技能，包括流程引擎配置、数据源设置、BPMN 流程定义、任务管理、历史记录查询等。适用于企业级工作流应用、审批流程、业务流程自动化等场景。
AnyLine 动态数据源框架适配虚谷数据库（XuguDB）的完整指南。当用户需要将基于 AnyLine 的 Java 项目配置或适配到虚谷数据库时使用此技能，包括动态数据源注册、切换、元数据操作、DDL/DML 自动生成等。适用于数据中台、低代码平台、异构数据库迁移等场景。
Azkaban 工作流管理器适配虚谷数据库（XuguDB）的完整指南。当用户需要将基于 Azkaban 的工作流管理器配置或适配到虚谷数据库时使用此技能，包括安装部署、数据库配置、工作流定义、任务调度、监控管理等。适用于大数据作业调度和管理场景。
Camunda BPM 平台适配虚谷数据库（XuguDB）的完整指南。当用户需要将基于 Camunda 的工作流和决策自动化平台配置或适配到虚谷数据库时使用此技能，包括安装部署、数据库配置、BPMN 流程定义、任务管理、REST API、UI 管理界面等。适用于企业级工作流应用、审批流程、业务流程自动化、案例管理等场景。
CloudBeaver 云数据库管理器适配虚谷数据库(XuguDB)的完整指南。当用户需要使用 CloudBeaver 连接和管理虚谷数据库时使用此技能，包括部署安装、驱动配置、连接管理、用户权限等。适用于团队协作、远程数据库管理场景。
DataEase 开源 BI 工具适配虚谷数据库（XuguDB）的完整指南。当用户需要将 DataEase 连接到虚谷数据库进行数据可视化分析时使用此技能，包括驱动配置、数据源连接、数据集创建、仪表板设计等。适用于企业数据可视化、自助分析、报表分享等场景。
| name | nacos-xugudb-adapter |
| description | Nacos 适配虚谷数据库(XuguDB)的完整指南。当用户需要将基于 Nacos 的服务发现与配置管理平台配置或适配到虚谷数据库时使用此技能，包括版本获取、数据源配置、数据库初始化、启动配置、集群配置等。适用于从 MySQL/Oracle 迁移或新建虚谷数据库项目。 |
本技能提供 Nacos 适配虚谷数据库(XuguDB)的完整流程。Nacos 是阿里巴巴开源的动态服务发现、配置管理和服务管理平台，通过适配虚谷数据库，可以实现微服务架构中的服务注册与配置管理。
在开始适配前，按以下顺序检查和修改：
1. 版本获取 → 2. 数据库初始化 → 3. 数据源配置 → 4. 启动配置 → 5. 功能验证 → 6. 集群配置
重要： 必须使用虚谷提供的专用 Nacos Server 压缩包，而非直接使用原生 Nacos 安装包。
1.4.6在配置数据源前，必须先在目标虚谷数据库中执行初始化脚本：
nacos/conf/ 目录下的 xugu-schema.sql-- 连接到虚谷数据库
-- 执行 xugu-schema.sql 脚本
-- 验证表创建成功
SELECT table_name FROM all_tables WHERE schema_id = (SELECT schema_id FROM all_schemas WHERE schema_name = 'NACOS_DATABASE');
数据源配置在文件 nacos/conf/application.properties 中完成。
# 数据库数量
db.num=1
# 数据库平台
spring.sql.init.platform=xugu
# 数据库连接配置
db.url.0=jdbc:xugu://127.0.0.1:5137/SYSTEM?current_schema=nacos_database
db.user.0=SYSDBA
db.password.0=SYSDBA
db.driver-class-name.0=com.xugu.cloudjdbc.Driver
关键配置说明：
spring.sql.init.platform=xugu：指定数据库平台为虚谷current_schema=nacos_database：指定当前模式名db.driver-class-name.0=com.xugu.cloudjdbc.Driver：指定虚谷 JDBC 驱动在 nacos/bin 目录下执行启动命令：
# Windows
startup.cmd -m standalone
# Linux/Mac
sh startup.sh -m standalone
http://localhost:8848/nacos/#/login
nacosnacos重要提示: 从 Nacos 2.2.3 版本开始，需要手动开启鉴权配置才会出现登录界面。
在 application.properties 中添加以下配置开启鉴权：
# 开启鉴权
nacos.core.auth.enabled=true
nacos.core.auth.system.type=nacos
nacos.core.auth.plugin.nacos.token.secret.key=SecretKey012345678901234567890123456789012345678901234567890123456789
nacos.core.auth.server.identity.key=serverIdentity
nacos.core.auth.plugin.nacos.token.expire.seconds=18000
Nacos 集群部署时，多个 Nacos 节点共享同一个虚谷数据库。
nacos/conf/cluster.conf 中配置集群节点信息# 集群节点列表
192.168.1.100:8848
192.168.1.101:8848
192.168.1.102:8848
# 数据库数量
db.num=1
# 数据库平台
spring.sql.init.platform=xugu
# 数据库连接配置
db.url.0=jdbc:xugu://192.168.1.200:5137/SYSTEM?current_schema=nacos_database
db.user.0=SYSDBA
db.password.0=SYSDBA
db.driver-class-name.0=com.xugu.cloudjdbc.Driver
# 集群模式
nacos.core.auth.enabled=true
nacos.core.auth.system.type=nacos
在集群模式下，建议使用 Nginx 或其他负载均衡器进行负载均衡：
upstream nacos-cluster {
server 192.168.1.100:8848;
server 192.168.1.101:8848;
server 192.168.1.102:8848;
}
server {
listen 80;
server_name nacos.example.com;
location / {
proxy_pass http://nacos-cluster;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
现象： 启动时报错 Driver class not found
原因： JDBC 驱动未正确引入
解决： 确保虚谷 JDBC 驱动已正确放置在 nacos/plugins/ 目录下
现象： 连接时报错 Invalid connection URL
原因： URL 参数错误
解决： 确保使用正确的 URL 格式，并包含 current_schema=模式名
现象： 启动时报错 Table 'xxx' doesn't exist
原因： 数据库初始化脚本未执行
解决： 执行 nacos/conf/xugu-schema.sql 初始化脚本
现象： 无法登录或登录后无权限
原因： 鉴权配置不正确
解决：
nacos.core.auth.enabled 是否设置为 truenacos.core.auth.plugin.nacos.token.secret.key 是否配置正确现象： 集群节点之间无法通信
原因： 集群配置不正确
解决：
cluster.conf 文件中的节点列表是否正确现象： 连接超时或连接泄漏
原因： 数据库连接池配置不当
解决：
详细的配置指南和故障排除请参考：