如何在pyodbc中通过代理配置连接Azure SQL DW服务器

Hey there, let's tackle how to add proxy configuration to your pyodbc connection for Azure SQL DW. Since you're using Python 3.6, pyodbc 4.x, and the Microsoft ODBC Driver 13 for SQL Server, here are a few reliable approaches based on your setup:

1. 系统级代理配置（全局生效，无需修改代码） #

这种方式适合需要全局代理的场景，pyodbc会自动继承系统的代理设置：

• Windows系统：
  打开「ODBC数据源管理器」，找到你配置的DW_dsn，进入修改界面。在连接设置区域找到代理配置项，填入你的代理地址（例如http://proxy.example.com:8080），如果代理需要认证，补充用户名和密码即可。保存后，原有的pyodbc连接代码不需要任何改动。
• Linux/macOS系统：
  在运行Python脚本前，先设置环境变量：

  # 基础代理设置
  export HTTP_PROXY=http://proxy.example.com:8080
  export HTTPS_PROXY=http://proxy.example.com:8080
  
  # 如果代理需要用户名密码认证
  export HTTP_PROXY=http://proxy_user:proxy_pass@proxy.example.com:8080
  export HTTPS_PROXY=http://proxy_user:proxy_pass@proxy.example.com:8080
  

  执行完上述命令后再运行你的Python脚本，ODBC驱动会自动读取这些代理环境变量。

2. 直接在连接字符串中指定代理（灵活可控） #

如果你不想修改DSN或系统设置，可以直接在pyodbc的连接字符串中添加代理参数。Microsoft ODBC Driver 13支持ProxyServer、ProxyUID、ProxyPWD这些参数：

# 构建带代理的连接字符串
connection_string = (
    f"DSN={DW_dsn};"
    f"UID={DW_db_usr};"
    f"PWD={DW_db_pwd};"
    "ProxyServer=http://proxy.example.com:8080;"  # 替换为你的代理地址
    # 若代理需要认证，取消下面两行注释并填入信息
    # "ProxyUID=proxy_username;"
    # "ProxyPWD=proxy_password;"
    "autocommit=True"
)

# 建立连接
conn = pyodbc.connect(connection_string)

特殊情况：SOCKS代理 #

如果你的代理是SOCKS类型（而非HTTP/HTTPS），ODBC Driver 13不直接支持这种协议。此时可以用第三方库socksipy-branch来代理整个Python进程的网络请求：

1. 先安装库：

   pip install socksipy-branch
   

2. 在脚本开头添加代理配置：

   import socks
   import socket
   
   # 配置SOCKS5代理（根据实际代理类型调整，比如SOCKS4）
   socks.set_default_proxy(socks.SOCKS5, "proxy.example.com", 1080)
   # 替换默认socket为socks代理socket
   socket.socket = socks.socksocket
   

3. 然后正常执行原有的pyodbc连接代码即可。

3. 修改ODBC配置文件（多环境共享配置） #

你可以通过修改ODBC的配置文件来为指定DSN添加代理，适合多脚本共享代理设置的场景：

• Windows：配置文件路径通常为C:\Windows\System32\odbc.ini或C:\Users\<你的用户名>\AppData\Roaming\ODBC\odbc.ini
• Linux/macOS：配置文件路径为~/.odbc.ini

找到你的DW_dsn对应的条目，添加代理相关参数：

[DW_dsn]
Driver=Microsoft ODBC Driver 13 for SQL Server
Server=tcp:your-sql-dw.database.windows.net,1433
Database=your_database_name
ProxyServer=http://proxy.example.com:8080
ProxyUID=proxy_username
ProxyPWD=proxy_password

保存后，原有的pyodbc连接代码无需改动，直接使用DSN连接即可。

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