# 虚谷数据库系统配置参考

> |

- **Type:** Skill
- **Install:** `agentstack add skill-kourou25-xugudb-dev-skills-xugudb-config`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kourou25](https://agentstack.voostack.com/s/kourou25)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [kourou25](https://github.com/kourou25)
- **Source:** https://github.com/kourou25/xugudb-dev-skills/tree/master/skills/xugudb-config

## Install

```sh
agentstack add skill-kourou25-xugudb-dev-skills-xugudb-config
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 虚谷数据库系统配置参考

虚谷数据库系统配置参数集中放置在数据库根路径下的 SETUP 目录里，用于控制存储文件、集群通信、类型映射、黑白名单和其他系统运行时行为。

## 配置文件概览

| 配置文件 | 说明 |
|----------|------|
| xugu.ini | 主配置文件，包含网络监听、系统调度和并行、缓冲、SQL 引擎、存储系统参数、备份同步、系统日志、审计、自动分析等 |
| cluster.ini | 集群配置，包含规模、通信、角色、算力、存储权重等 |
| datafile.ini | 数据文件配置，指定数据/临时/回滚表空间文件的存储位置和个数 |
| mount.ini | 路径挂载配置，数据库逻辑目录到操作系统物理路径的映射 |
| trust.ini | 黑白名单配置，客户端 IP 的受信认证策略 |
| types.ini | 数据类型映射配置，外部类型名到内置基础数据类型的映射 |

## 参数修改方式

虚谷数据库的参数修改分为以下几种方式：

- **在线修改，立即生效** -- 通过 `SET 参数名 TO 值` 修改，无需重启
- **离线修改，重启生效** -- 编辑 xugu.ini 文件后重启数据库服务
- **离线修改，首次启动服务生效** -- 仅在数据库首次初始化启动时读取
- **不可修改** -- 系统内部固定值，只读

查看参数值：`SHOW 参数名`
查看所有参数：`SHOW SYS_VARS`

## xugu.ini 主配置参数

xugu.ini 是虚谷数据库最核心的配置文件，按功能分为以下类别：

| 类别 | 参数数量 | 说明 |
|------|----------|------|
| SQL 引擎参数 | 42 | 并行执行、优化器、游标、预编译、字典匹配、流导入等 |
| 事务子系统参数 | 11 | 隔离级别、自动提交、检查点、死锁检测、WAL 重放等 |
| 存储子系统参数 | 25 | 表空间文件、数据片、数据版本、存储迁移等 |
| 存储子系统附属参数 | 11 | 写回策略、AIO、持久化模式、缓存写穿等 |
| 安全审计参数 | 2 | 审计开关、安全等级 |
| 系统安全参数 | 7 | 口令复杂度策略（长度/大小写/数字/特殊字符/弱口令字典） |
| 系统并行度参数 | 9 | 线程数、CPU 绑定、Hash 表/分区/锁管理器规模 |
| 系统缓冲区参数 | 11 | 数据缓冲区、SGA 内存、排序内存、Hash 内存、交换缓冲区 |
| 网络侦听参数 | 13 | 端口、连接数、超时、字符集、时区、监听模型 |
| 系统运行(跟踪)日志参数 | 9 | 错误日志、命令日志、慢 SQL、Core Dump 等 |
| 数据备份与同步复制参数 | 8 | 归档模式、变更日志、回收站等 |
| 系统分析参数 | 8 | 自动分析、直方图、监控等 |
| 兼容性参数 | 4 | Oracle/MySQL/PostgreSQL 兼容模式、GROUP BY 模式、自增列模式 |

> 详细参考：[xugu-ini](skills/xugudb-config/references/xugu-ini.md)

## 辅助配置文件

cluster.ini、datafile.ini、mount.ini、trust.ini、types.ini 等辅助配置文件，用于集群部署、数据文件管理、路径映射、黑白名单和类型兼容。

> 详细参考：[cluster-config](skills/xugudb-config/references/cluster-config.md)

## 内置全局变量

内置全局变量是在编译和安装时确定的预设参数，通过 `SHOW 变量名` 查看，大部分不可修改。包含版本信息、构建参数、系统表查询类功能等 29 个变量。

> 详细参考：[global-variables](skills/xugudb-config/references/global-variables.md)

## 连接会话参数

连接级参数设置，作用范围为当前连接会话。通过 `SET 参数名 TO 值` 修改，包含字符集、兼容模式、事务隔离级别、优化器模式等 30 个参数。

> 详细参考：[session-parameters](skills/xugudb-config/references/session-parameters.md)

## 常用配置场景

### 性能调优
- **数据缓冲区**：`data_buff_mem` 建议配置为物理内存的 60%
- **并行度**：`max_parallel` 设为 CPU 核数，`auto_use_eje` 开启自动并行
- **Hash 内存**：`system_sga_mem` 和 `max_hash_mem` 根据排序/聚合负载调整
- **连接数**：`use_std_nio = false` 使用 POLL 模型突破 1024 限制

### 安全加固
- **口令策略**：`pass_mode = 4` 启用强口令，配合 `min_pass_len`、`min_pass_mixed_case` 等
- **黑白名单**：编辑 trust.ini 限制客户端 IP
- **审计**：`enable_audit = true` 开启审计功能
- **连接失败锁定**：`conn_fail_cnt` 控制失败次数阈值

### 兼容性
- **Oracle 兼容**：`SET def_compatible_mode TO ORACLE`
- **MySQL 兼容**：`SET def_compatible_mode TO MYSQL`
- **PostgreSQL 兼容**：`SET def_compatible_mode TO POSTGRESQL`

## 参考文档

- [xugu.ini 主配置参数](skills/xugudb-config/references/xugu-ini.md) -- SQL 引擎/事务/存储/安全/缓冲区/并行度/网络/日志/备份/兼容性
- [辅助配置文件](skills/xugudb-config/references/cluster-config.md) -- 集群、数据文件、路径挂载、黑白名单、数据类型映射
- [内置全局变量](skills/xugudb-config/references/global-variables.md) -- 版本、构建时间、集群信息、内存状态、线程状态等
- [连接会话参数](skills/xugudb-config/references/session-parameters.md) -- 字符集、兼容模式、隔离级别、优化器模式、游标等

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kourou25](https://github.com/kourou25)
- **Source:** [kourou25/xugudb-dev-skills](https://github.com/kourou25/xugudb-dev-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kourou25-xugudb-dev-skills-xugudb-config
- Seller: https://agentstack.voostack.com/s/kourou25
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.