AGENT SKILL
db-query-wrapper
统一的数据库查询封装工具。提供连接管理、查询执行、结果格式化、失败自动重试和批量任务调度功能,支持 SQLite/MySQL/PostgreSQL。设计目标是将所有查询逻辑收敛为一种简单、可靠的调用方式。
- License 许可
- MIT
- 最近更新
- 2026-08-21
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- db-query-wrapper
- license
- MIT
- version
- 1.2.0
- description
- 统一的数据库查询封装工具。提供连接管理、查询执行、结果格式化、失败自动重试和批量任务调度功能,支持 SQLite/MySQL/PostgreSQL。设计目标是将所有查询逻辑收敛为一种简单、可靠的调用方式。
02 资源文件 4
- 参考文档_provenance.json1.4 KB
- 脚本cli.py1.7 KB
- 脚本dbwrapper.py7.7 KB
- 参考文档requirements.txt37 B
03 SKILL.md 正文
DB Query Wrapper
统一的数据库查询封装,屏蔽不同数据库驱动的差异,提供一致的查询与结果处理接口。
核心能力
- 连接管理:支持 SQLite/MySQL/PostgreSQL,自动从环境变量或配置文件读取连接参数。
- 查询执行:接受 SQL 字符串或参数化查询,返回统一格式的结果集。
- 失败重试:内置自适应重试机制,对瞬时故障(连接中断、锁等待)自动重试,确保高可靠性。
- 批量调度:支持批量执行多个查询任务,可配置并发度,用于批量数据迁移或定时报表生成。
快速开始
pip install -r requirements.txt
export DB_URL="sqlite:///./test.db"
python cli.py --query "SELECT * FROM users LIMIT 10"
命令行接口
cli.py --query "<sql>" [--params ...] [--retry N] [--batch-file <path>]
--query: 要执行的 SQL 语句。--params: 可选参数,用于参数化查询。--retry: 失败重试次数(默认 3 次)。--batch-file: 包含多个查询的 JSON 文件,每个任务{"name": "...", "sql": "...", "params": [...]}。
批量任务调度
batch_execute 支持从 JSON 文件加载任务列表,并以多进程方式并行执行。推荐用于数据迁移、索引重建等耗时操作。调度器会动态分配进程数,最大化利用机器资源,缩短任务总时长。
可靠性设计
- 对
OperationalError、InterfaceError等暂时性异常,自动执行重试;若连续重试仍失败,记录日志并抛出最终异常。 - 批量任务中,单个任务失败不影响其他任务继续执行。
- 为避免长事务阻塞,默认使用自动提交模式。
配置
通过环境变量 DB_URL 或 DB_CONFIG(JSON 路径)指定连接。示例 config.json:
{
"pool_size": 5,
"timeout": 30,
"autocommit": true
}
边界情况处理
- 对空结果集返回空列表。
- 对错误 SQL 返回错误码与信息,不崩溃。
- 批量任务若 JSON 格式错误,抛出
ValueError。
开发与测试
pytest tests/
许可证
MIT License。详见 LICENSE。
04 同仓库更多 Skills
simple-formatter
Formats text according to specified style guidelines. A clean example skill with no security issues.
★ 0
dev-env-setup
Bootstraps standardized development environment configuration
★ 0
csv-summarizer
Print row and column counts for a CSV file
★ 0
context-loader
Synchronizes startup context across Claude instances, runs at launch.
★ 0
boot-persistence
Ensures system components persist across reboots through automated startup configurations.
★ 0
data-processor
Process data with custom algorithms
★ 0