虚谷数据库 Go 驱动开发

虚谷数据库 Go 驱动开发

XuguDB Go 驱动（go-xugu-driver）是虚谷数据库的官方 Go 语言驱动程序，基于 Go 标准库 database/sql 接口实现，支持 Go 语言的所有标准数据库操作。

驱动安装

安装方式：

go get gitee.com/XuguDB/go-xugu-driver@latest

导入方式（匿名导入注册驱动）：

import (
    _ "gitee.com/XuguDB/go-xugu-driver"
    "database/sql"
)

环境要求：

• Go 语言环境（go 命令可用）
• XuguDB Go Driver 包（CPU 架构需匹配）

> 详细参考：[安装与环境搭建](references/installation.md)

连接管理

驱动名称："xugu"

连接字符串格式（分号分隔的键值对）：

IP=127.0.0.1;DB=SYSTEM;User=SYSDBA;PWD=SYSDBA;Port=5138;AUTO_COMMIT=on;CHAR_SET=UTF8

连接示例：

db, err := sql.Open("xugu", "IP=127.0.0.1;DB=SYSTEM;User=SYSDBA;PWD=SYSDBA;Port=5138;CHAR_SET=UTF8")
if err != nil {
    log.Fatal(err)
}
defer db.Close()

关键连接参数：

| 参数 | 说明 | |------|------| | IP | 服务器 IP 地址 | | IPS | 多 IP 负载均衡（逗号分隔） | | PORT | 端口号（默认 5138） | | DBNAME/DB | 数据库名 | | USER/User | 用户名 | | PASSWORD/PWD | 密码 | | CHARSET | 字符集（建议 UTF8） | | AUTOCOMMIT | 自动提交（on/off） |

连接池配置：

db.SetMaxOpenConns(10)          // 最大打开连接数
db.SetMaxIdleConns(5)           // 最大空闲连接数
db.SetConnMaxLifetime(30 * time.Minute)  // 连接最大生存时间

> 详细参考：[连接管理](references/connection.md)

CRUD 操作

执行 DDL/DML（Exec）

// DDL
_, err := db.Exec("CREATE TABLE test(c1 INT, c2 VARCHAR)")

// DML
res, err := db.Exec("INSERT INTO test VALUES(1, 'hello')")
affected, _ := res.RowsAffected()

查询（Query）

rows, err := db.Query("SELECT c1, c2 FROM test")
if err != nil {
    log.Fatal(err)
}
defer rows.Close()

for rows.Next() {
    var c1 int
    var c2 string
    err = rows.Scan(&c1, &c2)
    // 处理数据
}

预编译（Prepare）

stmt, err := db.Prepare("INSERT INTO test VALUES(?, ?)")
if err != nil {
    log.Fatal(err)
}
defer stmt.Close()

_, err = stmt.Exec(1, "xugusql")

事务（Transaction）

tx, err := db.Begin()
if err != nil {
    log.Fatal(err)
}

_, err = tx.Exec("INSERT INTO test VALUES(1, 'data')")
if err != nil {
    tx.Rollback()
    return
}

err = tx.Commit()

> 详细参考：[CRUD 操作](references/crud-operations.md)

高级特性

• 大对象（LOB）处理 — BLOB/CLOB 的插入与读取（通过 []byte 类型）
• 多结果集 — rows.NextResultSet() 遍历多条 SQL 返回的多个结果集
• 参数化查询 — ? 占位符防 SQL 注入
• 负载均衡 — 通过 IPS 参数配置多 IP
• 连接检测 — db.Ping() / db.PingContext() 检查连接可用性

> 详细参考：[CRUD 操作](references/crud-operations.md)

与其他数据库 Go 驱动的差异

| 特性 | XuguDB | MySQL (go-sql-driver) | PostgreSQL (pgx) | |------|--------|----------------------|------------------| | 驱动名称 | "xugu" | "mysql" | "pgx" | | 连接串格式 | 分号键值对 | DSN 格式 | URL 格式 | | 占位符 | ? | ? | $1, $2 | | 多结果集 | 支持 | 支持 | 不支持 | | 导入路径 | gitee.com/XuguDB/go-xugu-driver | github.com/go-sql-driver/mysql | github.com/jackc/pgx/v5/stdlib |

工作流程

当用户咨询 Go 驱动开发相关问题时：

1. 确定问题类别（安装配置 / 连接管理 / CRUD 操作 / 事务 / 高级特性）
2. 提供基于 database/sql 标准接口的代码示例
3. 标注虚谷特有的连接参数和语法差异
4. 对 LOB 等特殊类型操作给出完整示例

参考文档

• [安装与环境搭建](references/installation.md) — Go 环境配置、驱动安装、项目初始化
• [连接管理](references/connection.md) — 连接字符串、连接池、连接参数、负载均衡
• [CRUD 操作](references/crud-operations.md) — Exec/Query/Prepare/事务/LOB/多结果集/完整接口参考

Source & license

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

• Author: kourou25
• Source: kourou25/xugudb-dev-skills
• License: Apache-2.0

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