使用pyodbc连接SQL Server查询数据库在线/离线状态求助

关于sysdatabases表的说明 #

你提到的sysdatabases是SQL Server的旧兼容视图，官方现在推荐使用**sys.databases系统视图**——它提供了更清晰的状态字段，避免了旧视图中数值解码的麻烦。如果一定要用sysdatabases，它的状态列是status（数值型），但需要对照官方文档解码含义，远不如sys.databases的state_desc直观。

核心查询语句 #

使用sys.databases的参数化查询（推荐）：

SELECT state_desc, state 
FROM sys.databases 
WHERE name = ?

• state_desc：文本描述状态（如ONLINE、OFFLINE、RESTORING等）
• state：对应状态的数值编码
• ?：参数占位符，用于传入目标数据库名称，避免SQL注入

PyODBC实现代码 #

下面是完整的Python代码，通过PyODBC连接SQL Server并查询指定数据库的状态：

import pyodbc

def get_database_status(target_db):
    # 配置连接字符串，根据你的环境调整以下参数
    connection_string = (
        r'DRIVER={ODBC Driver 17 for SQL Server};'
        r'SERVER=你的服务器名称;'
        r'DATABASE=master;'  # 必须连接到master库才能访问sys.databases
        r'UID=你的用户名;'
        r'PWD=你的密码;'
        # 如果用Windows认证，替换UID和PWD为：r'Trusted_Connection=yes;'
    )
    
    try:
        # 使用上下文管理器自动管理连接和游标
        with pyodbc.connect(connection_string) as conn:
            with conn.cursor() as cursor:
                # 执行参数化查询
                cursor.execute("SELECT state_desc FROM sys.databases WHERE name = ?", (target_db,))
                result = cursor.fetchone()
                
                if result:
                    return result[0]
                else:
                    return "目标数据库不存在"
    except pyodbc.Error as e:
        return f"查询失败: {str(e)}"

# 使用示例
target_database = "你的数据库名称"
status = get_database_status(target_database)
print(f"数据库 [{target_database}] 的状态: {status}")

关键注意事项 #

• 必须连接到master数据库：sys.databases是系统级视图，仅在master库中可访问
• 优先使用参数化查询：绝对不要直接拼接数据库名称到SQL语句中，防止SQL注入风险
• 驱动版本匹配：确保安装了对应SQL Server版本的ODBC驱动（如ODBC Driver 17/18 for SQL Server）
• 权限要求：执行查询的账号需要有访问sys.databases的权限（通常普通账号即可）

内容的提问来源于stack exchange，提问作者afotografia