SQL Server 只读连接助手

连接 SQL Server 业务库的常见痛点

当需要从 MES、ERP 等 SQL Server 业务库取数时，开发者常遇到连接串属性错误引发的连锁报错，比如把超时属性写成 Timeout=10 导致驱动解析失败，连带出现 18456（登录被拒）或 4060（无法打开库）等迷惑性错误。另外，只读权限配置不当可能带来数据安全风险，而登录名拼写差异、端口与版本号混淆等问题也会拖慢排查进度。

技能核心能力与工作步骤

这个技能聚焦最小权限 + 环境兼容的只读连接方案，核心步骤包括：

• 前置环境自检：验证系统是否安装 ODBC Driver 17 for SQL Server（或旧版 Native Client 11.0），检查 pyodbc 包是否可用，确认本机 TCP 能到达服务器默认端口 1433。
• 分阶段连接测试：通过模板脚本先连 master 库验证登录状态，再连接目标库；若遇 4060 错误，自动列出当前账号可访问的数据库，方便定位映射问题。
• 安全权限配置：指导创建仅含 public 服务器角色和 db_datareader 数据库角色的只读账号，禁止勾选 db_datawriter 或 db_owner，避免赋予写权限。
• 脚本模板支持：提供参数化脚本 connect_template.py，支持自定义查询、列出前 20 张表、导出 CSV，密码通过环境变量 DB_PWD 或交互输入，避免硬编码。

适用边界与注意事项

• 仅适用于 SQL Server 数据库，且优先处理只读查询需求，除非用户明确要求，不涉及写操作。
• 连接串属性必须符合 ODBC 规范，如超时需用 Login Timeout 而非 Timeout，加密属性避免使用 Mandatory。
• 凭据仅用于当前连接，不写入持久化文件；需确保账号在目标库有正确映射，避免因库名拼写或实例错误导致连接失败。