容器化MSSQL数据库连接字符串获取及Python连接故障排查

问题场景 #

Mac（i5）环境通过Docker部署本地MSSQL数据库，Azure Data Studio可正常查询，但使用Python+SQLAlchemy连接时失败，不确定连接字符串格式，需从Docker Desktop或Azure Data Studio获取正确连接信息。

现有代码 #

def generate_engine(path_to_yml):
    # Load credentials from the .yml file
    credentials_file_path = path_to_yml
    credentials = load_credentials(credentials_file_path)

    if credentials:
        server = credentials['server']
        port = credentials['port']
        database = credentials['database']
        username = credentials['username']
        password = credentials['password']

        # Construct the connection string
        connection_string = f'mssql+pyodbc://{username}:{password}@{server}:{port}/{database}?driver=ODBC+Driver+17+for+SQL+Server'

        # Create the engine
        engine = create_engine(connection_string)  # Set echo=True for debugging

        # Test the connection
        try:
            connection = engine.connect()
            print("Connection successful!")
            connection.close()
        except Exception as e:
            print("Connection error:", e)

报错信息 #

Connection error: (pyodbc.ProgrammingError) ('42000', '[42000] [Microsoft][ODBC Driver 17 for SQL Server][SQL Server]Cannot open database "mcr.microsoft.com/mssql/server:2019-latest" requested by the login. The login failed. (4060) (SQLDriverConnect)')

当前YAML配置 #

server: localhost
port: 1433
database: mcr.microsoft.com/mssql/server:2019-latest
username: sa
password: #mypassword

问题根源 #

YAML配置中database字段错误填写为MSSQL镜像名称（mcr.microsoft.com/mssql/server:2019-latest），而非实际存在的数据库名称（如默认的master，或自行创建的数据库）。此外，密码字段若包含#，YAML会将其视为注释起始，导致密码读取不完整。

获取正确连接信息的方法 #

从Azure Data Studio查看 #

• 连接目标MSSQL实例后，右键点击左侧连接面板中的实例，选择属性
• 在属性窗口中可查看数据库名称（默认是master）、服务器地址、端口等核心信息
• 也可右键实例选择复制连接字符串，直接获取ODBC格式的连接字符串，再转换为SQLAlchemy兼容格式

从Docker Desktop查看 #

• 找到目标MSSQL容器，点击查看详情
• 切换到环境变量标签：查看SA_PASSWORD确认密码，若启动容器时指定了MSSQL_DATABASE，该值即为默认数据库名
• 切换到端口标签：确认本地映射端口为1433（与YAML配置一致）

修复步骤 #

1. 修正YAML配置
   将database改为实际数据库名（如master），若密码包含#，需用双引号包裹避免被当作注释：

   server: localhost
   port: 1433
   database: master
   username: sa
   password: "#mypassword"
   

2. 确认ODBC驱动安装
   确保Mac已安装ODBC Driver 17 for SQL Server，未安装可通过Homebrew安装：

   brew install msodbcsql17 mssql-tools
   

3. 调试连接
   可在create_engine中添加echo=True参数，输出详细SQL日志辅助排查：

   engine = create_engine(connection_string, echo=True)
   

验证 #

修改完成后重新运行代码，若输出Connection successful!则连接正常。

内容的提问来源于stack exchange，提问作者דרור דה-הרטוך