Mssql Tools

MSSQL 工具 Skill

用于操作 SQL Server 数据库的工具集，提供连接测试、表管理和 SQL 执行功能。

快速开始

前置要求

安装 Python 库：

pip install pymssql

平台特定依赖：

• Windows: 无需额外依赖
• macOS: brew install freetds
• Linux (Debian/Ubuntu): sudo apt-get install freetds-dev

平台兼容性

• ✅ Windows
• ✅ macOS
• ✅ Linux

连接参数

所有脚本支持以下参数：

| 参数 | 说明 | 默认值 | |------|------|--------| | --server | 数据库服务器地址 | localhost | | --port | 数据库端口 | 1433 | | --user | 数据库用户名 | sa | | --password | 数据库密码 | 必填 | | --database | 数据库名称 | 必填 |

可用脚本

1. 测试数据库连接

验证数据库连接参数是否正确：

python scripts/mssql_connect.py --server 127.0.0.1 --port 1433 --user sa --password YOUR_PASSWORD --database YOUR_DB

2. 列出所有表

获取数据库中的所有表名：

python scripts/mssql_tables.py --server 127.0.0.1 --user sa --password YOUR_PASSWORD --database YOUR_DB

输出格式：表名列表，包含表类型（TABLE / VIEW）、Schema 和行数

3. 查看表结构

显示指定表的字段信息：

python scripts/mssql_schema.py --server 127.0.0.1 --user sa --password YOUR_PASSWORD --database YOUR_DB --table TABLE_NAME

可选指定 Schema：--schema dbo

输出格式：字段名、类型、是否可空、是否主键、默认值

4. 执行 SQL 查询

运行任意 SQL 语句：

python scripts/mssql_query.py --server 127.0.0.1 --user sa --password YOUR_PASSWORD --database YOUR_DB --query "SELECT TOP 10 * FROM users"

支持 SELECT、INSERT、UPDATE、DELETE 等所有 T-SQL 语句。

5. 查看数据库信息

获取数据库版本、大小等信息：

python scripts/mssql_info.py --server 127.0.0.1 --user sa --password YOUR_PASSWORD --database YOUR_DB

输出格式

所有脚本输出 JSON 格式数据，便于解析：

{
  "success": true,
  "data": [...],
  "message": "操作成功"
}

错误时返回：

{
  "success": false,
  "error": "错误信息",
  "message": "操作失败"
}

常见用例

探索新数据库

1. 测试连接：mssql_connect.py
2. 列出所有表：mssql_tables.py
3. 查看关键表结构：mssql_schema.py --table TABLE_NAME
4. 查询示例数据：mssql_query.py --query "SELECT TOP 5 * FROM TABLE_NAME"

数据分析

1. 获取表记录数：mssql_query.py --query "SELECT COUNT(*) FROM TABLE_NAME"
2. 分析数据分布：mssql_query.py --query "SELECT column, COUNT(*) FROM TABLE_NAME GROUP BY column"

SQL Server 特有注意事项

• 使用 TOP N 替代 MySQL 的 LIMIT N
• 字符串连接使用 + 而非 CONCAT()
• 日期函数与 MySQL 有差异，如 GETDATE() 替代 NOW()

参考更多 T-SQL 示例

查看 references/common_queries.md 获取常用 T-SQL 查询模板。

Source & license

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

• Author: huangzt
• Source: huangzt/my-agent-skills
• License: MIT

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