适用于：
Azure SQL 数据库Azure SQL 托管实例Azure Synapse Analytics
在本快速入门中，你将使用 Python 连接到 Azure SQL 数据库、Azure SQL 托管实例或 Synapse SQL 数据库，并使用 T-SQL 语句来查询数据。
先决条件
要完成此快速入门，您需要：
具有活动订阅的 Azure 帐户。 创建试用版订阅。
运行查询的数据库。
可以根据下述快速入门之一，创建数据库，然后对其进行配置：
行动 SQL 数据库 SQL 托管实例 Azure VM 上的 SQL Server Azure Synapse Analytics 创建 Portal Portal Portal Portal CLI CLI PowerShell PowerShell PowerShell PowerShell 部署模板 部署模板 部署模板 配置 服务器级别 IP 防火墙规则 虚拟机的连接性 连接设置 来自本地的连接 连接到 SQL Server 实例 获取连接信息 Azure SQL Azure SQL SQL VM Synapse SQL Python 3 和相关软件
操作 macOS Linux Windows 安装用于 SQL Server 的 ODBC 驱动程序、sqlcmd 和 Python 驱动程序 配置用于 pyodbc Python 开发的环境 配置用于 pyodbc Python 开发的环境 配置用于 pyodbc Python 开发的环境。 安装 Python 和其他所需的包 请使用 sudo apt-get install python python-pip gcc g++ build-essential。更多信息 macOS 上的 Microsoft ODBC 驱动程序 Linux 上的 Microsoft ODBC 驱动程序 Windows 上的 Microsoft ODBC 驱动程序
若要进一步了解 Python 和 Azure SQL 数据库中的数据库，请参阅适用于 Python 的 Azure SQL 数据库库、pyodbc 存储库和 pyodbc 示例。
创建用于查询数据库的代码
在文本编辑器中，创建新文件 sqltest.py。
添加以下代码。 从先决条件部分获取连接信息，并将 <server>、<database>、<username> 和 <password> 的值替换为自己的值。
import pyodbc server = '<server>.database.chinacloudapi.cn' database = '<database>' username = '<username>' password = '{<password>}' driver= '{ODBC Driver 17 for SQL Server}' with pyodbc.connect('DRIVER='+driver+';SERVER=tcp:'+server+';PORT=1433;DATABASE='+database+';UID='+username+';PWD='+ password) as conn: with conn.cursor() as cursor: cursor.execute("SELECT TOP 3 name, collation_name FROM sys.databases") row = cursor.fetchone() while row: print (str(row[0]) + " " + str(row[1])) row = cursor.fetchone()
运行代码
请在命令提示符处运行以下命令：
python sqltest.py验证数据库及其排序规则是否已返回，然后关闭命令窗口。
如果收到错误信息：
- 验证使用的服务器名称、数据库名称、用户名和密码是否正确。
- 验证安装的 ODBC 驱动程序与上述代码中的
driver变量是否为相同版本。 例如，代码显示 17，但你可能安装了其他版本的驱动程序。 - 如果从本地环境运行代码，请验证尝试访问的 Azure 资源的防火墙是否已配置为允许从你的环境的 IP 地址进行访问。