共用方式為

快速入門：使用 Python 在 Azure SQL 資料庫或 Azure SQL 受控執行個體中查詢資料庫

適用於：Azure SQL 資料庫Azure SQL 受控執行個體Azure Synapse Analytics

在本快速入門中，您將使用 Python 連線至 Azure SQL Database、Azure SQL 受控執行個體或 Synapse SQL 資料庫，並使用 T-SQL 陳述式查詢資料。

mssql-python 文件 | mssql-python 原始程式碼 | 套件 （PyPi）

必要條件

若要完成本快速入門，您需要：

設定

請依照下列步驟設定您的開發環境，以使用 Python 驅動程式開發 mssql-python 應用程式。

備註

此驅動程式會使用 表格式資料流 （TDS） 通訊協定，預設會在 SQL Server、Fabric 中的 SQL 資料庫和 Azure SQL 資料庫中啟用。 不需要額外的配置。

安裝 mssql-python 套件

從 PyPI 取得 mssql-python 套件 。

  1. 在空白目錄中開啟命令提示字元。

  2. 安裝 mssql-python 套件。

    pip install mssql-python

安裝 python-dotenv 套件

從 PyPI 取得python-dotenv。

  1. 在相同的目錄中，安裝 python-dotenv 套件。

    pip install python-dotenv

確認已安裝的套件

您可以使用 PyPI 命令列工具來驗證是否已安裝預期的套件。

  1. 檢查pip list已安裝套件的清單。

    pip list

建立新檔案

  1. 在目前目錄中，建立名為 的新檔案 .env。

  2. 在 .env 檔案中，新增名為 SQL_CONNECTION_STRING 的連接字串項目。 將此處的範例替換為您的實際連接字符串值。

    SQL_CONNECTION_STRING="Server=<server_name>;Database={<database_name>};Encrypt=yes;TrustServerCertificate=no;Authentication=ActiveDirectoryInteractive"

    小提示

    此處使用的連接字串很大程度上取決於您要連線的 SQL 資料庫類型。 如果您要連線到 Azure SQL 資料庫 或 Fabric 中的 SQL 資料庫，請使用 [連接字串] 索引標籤中的 ODBC 連接字串。您可能需要根據您的案例調整驗證類型。 如需連接字串及其語法的詳細資訊，請參閱 DSN 和連接字串關鍵字和屬性。

  3. 在文字編輯器中，建立名為 sqltest.py 的新檔案。

  4. 加入下列程式碼。

    from os import getenv
from dotenv import load_dotenv
from mssql_python import connect

load_dotenv()

with connect(getenv("SQL_CONNECTION_STRING")) as conn:
    with conn.cursor() as cursor:
        cursor.execute("SELECT TOP 3 name, collation_name FROM sys.databases")
        rows = cursor.fetchall()
        for row in rows:
            print(row.name, row.collation_name)

執行程式碼

  1. 在命令提示字元中，執行下列命令：

    python sqltest.py

  2. 確認已傳回資料庫及其定序，然後關閉命令視窗。

    如果您收到錯誤：

    • 確認您使用的伺服器名稱、資料庫名稱、使用者名稱和密碼正確無誤。

    • 如果您是從本機環境執行程式碼，請確認您嘗試存取的 Azure 資源，其防火牆已設定為允許從您環境的 IP 位址存取。

相關內容

  • Last updated on