1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | sql-server-table-reconciliation-github-awesome-copilot |
| 作者/维护者 | 社区贡献者 kapilsamant 提交，经 GitHub 官方 github/awesome-copilot 合集仓库维护者审核合并 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/sql-server-table-reconciliation |
| 许可证 | MIT（仓库级，来自 GitHub API） |
| GitHub Stars | 38,783（GitHub API，属整个 awesome-copilot 合集，不代表本技能自身热度） |
| Forks | 4,912（GitHub API，同上，属合集整体） |
| 最新版本 | 无独立版本号，内容最近一次改动为 2026-05-19（PR #1736 合并） |
| 安装方式 | gh skills install github/awesome-copilot sql-server-table-reconciliation，或手动复制 skills/sql-server-table-reconciliation 目录到本地 skills 目录 |
2. 功能介绍与亮点
这是一个跨 SQL Server 实例做表级数据对账的技能，核心用途是数据迁移验证与 ETL 校验：
- 列式高速传输：通过
mssql-python驱动 + Apache Arrow 游标（cursor.arrow()）拉取数据，比传统逐行传输快 10–50 倍，专为跨网络的大表比对设计。 - 哈希预检优化：表行数超过 100 万时，先在数据库端用
HASHBYTES('SHA2_256', ...)对每行算哈希做初筛，只对哈希不一致的行拉取完整数据，大幅减少数据传输量。 - 分层比对策略：按表规模（<10 万行 / 10 万–100 万行 / >100 万行 / 100+ 列宽表）给出不同的比对策略，避免小表用重型方案、大表用轻型方案导致的性能或内存问题。
- 双认证模式：支持 SQL 账号密码与 Azure AD（Entra ID）两种认证方式，适配企业云环境。
- 结构化对账报告：自动检测缺失行、多余行、字段值不一致与 schema 漂移，输出摘要或逐表详情两种粒度的报告。
- 规范化比对规则：小数精度统一、字符串去空格、日期时间统一转 UTC、NULL 视为匹配、按主键关联而非位置顺序比对，避免误报。
配套脚本 scripts/reconcile.py（约 13KB）实现了完整逻辑，SKILL.md 只负责收集参数并调用脚本，指令与执行分离，逻辑可审计。
3. 适用场景
固定分类：数据分析与可视化（核心产出是数据比对与 ETL 校验报告，属数据处理实践）。
适用于数据库迁移项目（如从本地 SQL Server 迁到 Azure SQL）验证迁移完整性、ETL 管道上线前后做生产库与预发库的数据一致性校验，以及日常巡检两个环境的表是否漂移。目标用户是负责数据库迁移或数据管道质量把关的开发者与 DBA。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——标准 Agent Skills 格式（SKILL.md + YAML front matter + 配套脚本），复制到
.claude/skills/目录即可使用。 - Codex：✅ 原生支持——Codex CLI 技能系统同样构建在开放的 Agent Skills 标准之上。
- OpenClaw：未验证。
- Hermes Agent：未验证。
5. 推荐理由
手写脚本做跨实例表比对，容易在大表场景下因逐行传输而超时或占满内存；这个技能把哈希预检 + Arrow 列式传输 + 规模分层策略打包成一套开箱即用的方案，且明确要求凭据走环境变量/交互输入、禁止硬编码与日志打印、SQL 一律用参数化查询，安全实践规范。对需要频繁做数据库迁移验证或 ETL 校验的团队，比现场手写比对脚本更省时间，也更不容易因比对逻辑疏漏（如忽略 NULL 处理或行序）而漏报差异。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 官方组织仓库出品（github/awesome-copilot，经官方仓库维护者审核合并）；本技能自身未查到独立于合集之外的第三方讨论或媒体报道，仅有技能聚合站点对同一份内容的自动化镜像 |
| 可用性 | 8 | SKILL.md 结构完整、参数表与调用示例具体，但需要安装 mssql-python/pyarrow/pandas 三个 Python 包并准备两个 SQL Server 实例的连接信息，非一步到位；内容最近一次改动为 2026-05-19（约 3.7 个月前），在近 6 个月维护窗口内 |
| 安全性 | 8 | 有代码执行（连接真实数据库并跑查询），但权限范围明确、脚本可审计；连接字符串强制 Encrypt=yes，凭据只走环境变量/getpass 交互输入，明文声明不打印凭据到日志；元数据查询使用参数化占位符防注入；无外部网络调用（仅连接用户指定的数据库实例）；MIT 许可证明确 |
| 综合 | 7.67 | 三项均值，≥ 7.0 达标 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
同一合集内的 sql-code-review |
通用 SQL 代码审查，针对已写好的 SQL/PLpgSQL 代码给出问题清单 | 审查静态代码文本，不连接数据库、不做数据层面的比对；与本技能是不同阶段的工具——一个管代码质量，一个管数据一致性 |
| Azure Data Studio 内置 Schema Compare 插件 | 微软官方 IDE 插件，做数据库 schema 结构比对 | 只比对表结构定义（列、索引、约束等 DDL 层面），不比对表内实际数据行；且需要安装完整 IDE，而本技能是纯脚本可在任意 agent 会话中调用 |
8. 用户评价
该技能目前在第三方平台（Reddit、Hacker News、技术博客）尚无具名用户评价；能查到的相关页面均为技能聚合站点（如 mcpservers.org、awesome-copilot.github.com）对同一份 SKILL.md 内容的自动化镜像收录，不构成独立评价。
9. 安装使用方式
- 通过 CLI 安装：
gh skills install github/awesome-copilot sql-server-table-reconciliation（需 GitHub CLI 且已认证）。 - 手动安装：从仓库复制
skills/sql-server-table-reconciliation/目录（含SKILL.md与scripts/reconcile.py）到本地 agent 的 skills 目录。 - 环境准备：
pip install mssql-python pyarrow pandas；凭据通过环境变量MSSQL_USER/MSSQL_PASSWORD（SQL 认证模式）设置，或使用 Azure AD 默认凭据链（Entra 认证模式）。 - 触发方式：对话中提供源库、目标库连接信息与要比对的表名（或
schema.*通配符），请求“帮我对账这些表”即可；无需重启，安装后立即可用。
10. 注意事项
- 需要能同时连接源库与目标库两个 SQL Server 实例的网络权限，纯本地单库场景用不上。
- 依赖
mssql-python驱动，这是微软近期推出的驱动，比传统pyodbc/pymssql新，团队环境若尚未安装需额外配置步骤。 - 大表（超百万行）哈希预检能显著减少传输量，但哈希计算本身会消耗数据库端 CPU，对生产库执行建议避开高峰期。
- 纯对账工具，不会自动修复发现的差异，需要人工介入处理。