메뉴
CloudBeaver 云数据库管理器适配虚谷数据库(XuguDB)的完整指南。当用户需要使用 CloudBeaver 连接和管理虚谷数据库时使用此技能，包括部署安装、驱动配置、连接管理、用户权限等。适用于团队协作、远程数据库管理场景。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | cloudbeaver-xugudb-adapter |
| description | CloudBeaver 云数据库管理器适配虚谷数据库(XuguDB)的完整指南。当用户需要使用 CloudBeaver 连接和管理虚谷数据库时使用此技能，包括部署安装、驱动配置、连接管理、用户权限等。适用于团队协作、远程数据库管理场景。 |
本技能提供 CloudBeaver 云数据库管理器适配虚谷数据库(XuguDB)的完整流程。CloudBeaver 是一款开源的云数据库管理工具，通过配置虚谷 JDBC 驱动，可以通过 Web 界面统一管理虚谷数据库，包括 SQL 编辑、数据管理、用户权限管理等功能。
在开始适配前，按以下顺序检查和修改：
1. 部署安装 → 2. 驱动配置 → 3. 连接配置 → 4. 用户权限 → 5. 功能验证 → 6. 生产部署
系统要求：
环境验证：
java -version
docker --version
docker-compose --version
创建 docker-compose.yml 文件：
version: '3.8'
services:
cloudbeaver:
image: dbeaver/cloudbeaver:latest
container_name: cloudbeaver
ports:
- "8978:8978"
volumes:
- "./logs:/opt/cloudbeaver/logs"
- "./workspace:/opt/cloudbeaver/workspace"
- "./drivers:/opt/cloudbeaver/drivers"
environment:
- JAVA_OPTS=-Xmx2g -Xms1g
restart: unless-stopped
启动服务：
docker-compose up -d
检查端口：
netstat -tulpn | grep 8978
查看日志：
tail -f logs/cloudbeaver.log
Web 访问：
xugu-jdbc-12.3.4.jardrivers 目录com.xugu.cloudjdbc.Driverjdbc:xugu://{host}:{port}/{database}jdbc:xugu://127.0.0.1:5138/SYSTEM?current_schema=RY&CHAR_SET=UTF8&COMPATIBLE_MODE=MYSQL
参数说明：
current_schema=RY: 指定当前模式名CHAR_SET=UTF8: 字符集配置COMPATIBLE_MODE=MYSQL: MySQL兼容模式-- 查询表结构
SELECT table_name, comments
FROM all_tables
WHERE schema_id = (SELECT schema_id FROM all_schemas WHERE schema_name = 'RY');
-- 查询列信息
SELECT col_name, type_name, comments
FROM ALL_COLUMNS
WHERE table_id = (SELECT table_id FROM all_tables WHERE table_name = 'USERS');
-- 创建表
CREATE TABLE users (
id BIGINT PRIMARY KEY,
username VARCHAR(50) NOT NULL,
email VARCHAR(100),
created_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
Ctrl+Space 触发代码补全Ctrl+S 快捷键启用 HTTPS：
{
"server": {
"forceHttps": true
}
}
访问控制：
{
"security": {
"allowedIPs": ["192.168.1.0/24"],
"blockedIPs": ["10.0.0.1"]
}
}
连接池配置：
{
"database": {
"minIdleConnections": 4,
"maxConnections": 100
}
}
JVM 参数：
JAVA_OPTS="-Xmx4g -Xms2g -XX:+UseG1GC"
现象： 连接时报错 Driver class not found
原因： JDBC 驱动未正确配置
解决：
现象： 连接时报错 Invalid connection URL
原因： URL 参数错误
解决： 确保使用正确的 URL 格式
jdbc:xugu://127.0.0.1:5138/SYSTEM?current_schema=RY&CHAR_SET=UTF8&COMPATIBLE_MODE=MYSQL
现象： 连接时报错 Authentication failed
原因： 用户名或密码错误
解决：
现象： 查询时报错 Table not found
原因： 模式名未正确设置
解决：
current_schema=RYSET CURRENT_SCHEMA = RY现象： 数据显示乱码
原因： 字符编码不匹配
解决：
CHAR_SET=UTF8现象： 操作时报错 Permission denied
原因： 用户权限不足
解决：
现象： 查询响应缓慢
原因： 查询优化不足
解决：
现象： 启动失败，报端口被占用
原因： 端口 8978 被其他服务占用
解决：
serverPort详细的配置和使用说明请参考：
Activiti 工作流引擎与虚谷数据库（XuguDB）集成适配指南。当用户需要在 Spring Boot 项目中使用 Activiti 工作流引擎连接 XuguDB 时使用此技能，包括流程引擎配置、数据源设置、BPMN 流程定义、任务管理、历史记录查询等。适用于企业级工作流应用、审批流程、业务流程自动化等场景。
AnyLine 动态数据源框架适配虚谷数据库（XuguDB）的完整指南。当用户需要将基于 AnyLine 的 Java 项目配置或适配到虚谷数据库时使用此技能，包括动态数据源注册、切换、元数据操作、DDL/DML 自动生成等。适用于数据中台、低代码平台、异构数据库迁移等场景。
Azkaban 工作流管理器适配虚谷数据库（XuguDB）的完整指南。当用户需要将基于 Azkaban 的工作流管理器配置或适配到虚谷数据库时使用此技能，包括安装部署、数据库配置、工作流定义、任务调度、监控管理等。适用于大数据作业调度和管理场景。
Camunda BPM 平台适配虚谷数据库（XuguDB）的完整指南。当用户需要将基于 Camunda 的工作流和决策自动化平台配置或适配到虚谷数据库时使用此技能，包括安装部署、数据库配置、BPMN 流程定义、任务管理、REST API、UI 管理界面等。适用于企业级工作流应用、审批流程、业务流程自动化、案例管理等场景。
DataEase 开源 BI 工具适配虚谷数据库（XuguDB）的完整指南。当用户需要将 DataEase 连接到虚谷数据库进行数据可视化分析时使用此技能，包括驱动配置、数据源连接、数据集创建、仪表板设计等。适用于企业数据可视化、自助分析、报表分享等场景。
阿里巴巴 DataX 数据同步工具适配虚谷数据库（XuguDB）的完整指南。当用户需要将基于 DataX 的数据同步工具配置或适配到虚谷数据库时使用此技能，包括安装部署、插件配置、任务配置、性能优化等。适用于数据同步、数据迁移、数据集成等场景。