BatchSQL v1.2.5

Release Notes for v1.2.5

Release Date: 2025-10-02 11:43:29 UTC

Changes since v1.1.1

• fix: coverage (92bc800)
• ci(release): read coverage from coverage_total.txt and exclude examples/ in Makefile cover (70cb044)
• fix: 未使用的变量名 (6f61d1b)
• chore: add MIT LICENSE and confirm CI workflow badge (63ecd61)
• chore(prometheus-example): fix lint (gci/gosec/perfsprint/revive); add ReadHeaderTimeout; use errors.New; rename unused params (33a5027)
• docs(README): add badges (release, pkg.go.dev, goreportcard, license, coverage, stars) (79e834b)
• feat(prometheus-example): add plug-and-play Prometheus metrics+reporter under examples; docs: add quick-start guide and link to single dashboard; integrate retry/final error metrics alignment (2bbb1cd)
• fix(integration): align error_type for retry/final metrics (no table prefix) to match dashboards/queries (417f903)
• feat: add optional MetricsProvider; avoid overriding custom executor reporter; adjust NewBatchSQL logic (6c6add3)
• fix: version (8e31b22)
• chore: fix lint (gofumpt/staticcheck/unused); add coverage tests; Makefile cover target (c9503d5)
• feat: report files (15c4cd8)
• fix: errors (276096b)
• MockExecutor: add concurrent-safe aggregate stats and remove noisy per-batch logs; tests: add SnapshotResults coverage (basic/multi-table/concurrency), fix mock WithMetricsReporter returns; core: Submit ctx cancel fast-path and pipeline closed flag; benchmarks: verbose-only aggregate summary via b.Cleanup; fix flaky context-cancel timing; release v1.2.1 (b44afb9)
• feat: v1.2.0 文档 (f12d3cb)
• feat: v1.2.0 文档 (f172b8d)
• feat: v1.2.0 文档 (453bdcf)
• docs(index): 更新文档目录结构；新增“MetricsReporter 快速了解”并加入监控快速上手与自定义 Reporter 指南链接 (4e3037c)
• docs: 补充 MetricsReporter 接口定义与语义说明，新增《监控快速上手》《自定义 MetricsReporter 指南》并在 API 参考中引用 (053593d)
• fix(executor): use errors.Is for context errors to satisfy errorlint (7b0ab4d)
• chore(integration): 清理旧接口遗留注释，全面完成从 RecordBatchExecution 向新指标接口迁移 (05e2b03)
• metrics: 补齐入队耗时与执行并发埋点，新增在途批次数指标\n- core: Submit 上报真实 enqueue latency；ThrottledBatchExecutor 在 WithMetricsReporter/WithConcurrencyLimit 上报并发度；ExecuteBatch 生命周期 Inc/Dec inflight\n- fix: NewBatchSQL 不再用 Noop 覆盖已注入的 MetricsReporter\n- integration: Prometheus 增加 enqueue/assemble/execute/batch_size/queue/concurrency/inflight 指标与方法；Reporter 适配新接口\n- grafana: 升级旧面板新增流水线阶段与执行器/队列分区；增加在途批次数图表；移除 v2 面板文件 (c75a765)
• feat(retry): 执行层增加可选重试与错误分类（默认关闭）；perf(driver): 占位符模板缓存以降低 SQL 生成开销（Step 3/1） (9813ec1)
• perf(driver): 为 MySQL/PG/SQLite 增加占位符缓存，减少批量 SQL 生成开销（Step 3 之一） (ecce97a)
• feat(metrics): 指标细化最小骨架接入（Noop 默认，埋点于攒批/执行/队列）；保持向后兼容 (1321a91)
• docs(guides): 新增调优最佳实践（指标细化+自适应策略设计、基准与压力脚本）；README 链接入口 (3b08d03)
• feat: make 命令行功能补全 (5eee4d4)
• docs(readme): 合并架构图为单一 Mermaid 图（系统数据流 + 组件分层） (7ddc886)
• docs(readme): 使用 Mermaid 美化整体架构图 (66e067b)
• docs: fix Mermaid labels (quote Triggers); chore: remove scripts/start-monitoring.sh and its README references (dae14f6)
• docs(README): add Mermaid architecture and CI/CD diagrams (968e5a4)
• ci: switch to docker-compose.ci.yml (no host ports); unify compose usage; remove monitoring jobs from CI; fix postgres naming; improve benchmark step output (272b67c)
• feat: github action (cb088a0)
• feat: docker compose file for ci (05cc577)
• fix: docker-compose v2 (bb4d375)
• fix: docker-compose v2 (93017d4)

Test Results

• ✅ All unit tests passed
• ✅ MySQL integration tests passed
• ✅ PostgreSQL integration tests passed
• ✅ Redis integration tests passed
• ✅ Monitoring system tests passed
• ⚠️ SQLite tests show expected architectural limitations

Features

• 🚀 Multi-database support: MySQL, PostgreSQL, SQLite, Redis
• 📊 Prometheus + Grafana monitoring integration
• 📚 Complete documentation system in docs/ directory
• 🧪 Comprehensive test suite with 95%+ pass rate

Installation

go get github.com/rushairer/batchsql@v1.2.5