Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következőkre vonatkozik:Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Ebben a rövid útmutatóban a Python használatával csatlakozhat az Azure SQL Database-hez, az Azure SQL Managed Instance-hez vagy a Synapse SQL-adatbázishoz, és T-SQL-utasítások használatával kérdezheti le az adatokat.
az mssql-python dokumentációja | mssql-python forráskód | Csomag (PyPI)
Előfeltételek
A gyors kezdéshez ezekre lesz szüksége:
Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egy fiókot ingyenesen.
Adatbázis
Az alábbi rövid útmutatók egyikével létrehozhat és konfigurálhat egy adatbázist:
Tevékenység SQL adatbázis SQL Managed Instance SQL Server azure-beli virtuális gépen Azure Synapse Analytics Hozz létre portál portál portál portál CLI CLI PowerShell PowerShell PowerShell PowerShell üzembehelyezési sablon üzembehelyezési sablon üzembehelyezési sablon üzembehelyezési sablon Konfigurálás kiszolgálószintű IP-tűzfalszabály Kapcsolat egy virtuális gépről kapcsolati beállítások Helyszíni kapcsolat Csatlakozás SQL Server-példányhoz Kapcsolati adatok lekérése Azure SQL Azure SQL SQL virtuális gép Synapse SQL Python 3
Ha még nem rendelkezik Pythonnal, telepítse a Python futtatókörnyezetet és a Python-csomagindexet (PyPI) csomagkezelőtpython.org.
Inkább lemondana a saját környezetének használatáról? Nyissa meg devcontainerként a GitHub Codespaces használatával.
Sql Serveren, Azure SQL Database-en vagy SQL Database-adatbázison a Fabricben a
AdventureWorks2025mintasémával és egy érvényes kapcsolati sztringgel.
Előkészítés
Ezeket a lépéseket követve konfigurálhatja a fejlesztési környezetet egy alkalmazás Python-illesztőprogram használatával mssql-python történő fejlesztéséhez.
Megjegyzés:
Ez az illesztőprogram a Tabular Data Stream (TDS) protokollt használja, amely alapértelmezés szerint engedélyezve van az SQL Serverben, az SQL Database-ben a Fabricben és az Azure SQL Database-ben. Nincs szükség további konfigurációra.
Az mssql-python csomag telepítése
Szerezze be a mssql-python csomagot a PyPI-ről.
Nyissa meg a parancssort egy üres könyvtárban.
Telepítse az
mssql-pythoncsomagot.
Python-dotenv-csomag telepítése
Szerezze be a python-dotenv-t a PyPI-ról.
Ugyanabban a könyvtárban telepítse a
python-dotenvcsomagot.pip install python-dotenv
Telepített csomagok ellenőrzése
A PyPI parancssori eszközével ellenőrizheti, hogy a tervezett csomagok telepítve vannak-e.
Ellenőrizze a telepített csomagok listáját a következővel
pip list: .pip list
Új fájlok létrehozása
Az aktuális könyvtárban hozzon létre egy új fájlt.
.envA
.envfájlban adjon hozzá egy bejegyzést a kapcsolati karakterlánchoz, a következő névvel:SQL_CONNECTION_STRING. Cserélje le a<database-server-name>és<database-name>helyőrzőket a saját értékeire.Az mssql-python illesztőprogram beépített támogatást nyújt a Microsoft Entra-hitelesítéshez. A paraméter használatával
Authenticationadja meg a hitelesítési módszert.ActiveDirectoryDefaultautomatikusan felderíti a hitelesítő adatokat több forrásból anélkül, hogy interaktív bejelentkezésre van szükség. Ez a helyi fejlesztés ajánlott módja , és Windows, macOS és Linux rendszeren is működik.A legmegbízhatóbb helyi fejlesztési élmény érdekében először jelentkezzen be az Azure CLI-vel:
az loginEzután használja ezt a kapcsolati sztringformátumot a
.envfájlban:SQL_CONNECTION_STRING="Server=<database-server-name>.database.windows.net;Database=<database-name>;Authentication=ActiveDirectoryDefault;Encrypt=yes;TrustServerCertificate=no"ActiveDirectoryDefaulta hitelesítő adatokat a következő sorrendben értékeli ki:- Környezeti változók (a szolgáltatásnévhez tartozó hitelesítő adatokhoz)
- Kezelt identitás (Azure-ban futtatva)
-
Azure CLI (forrás
az login) - Visual Studio (csak Windows rendszeren)
-
Azure PowerShell (forrás
Connect-AzAccount)
Jótanács
Éles alkalmazások esetén használja az adott hitelesítési módszert a forgatókönyvhöz a hitelesítő adatok felderítésének késésének elkerülése érdekében:
-
Azure App Service/Functions: Használja
ActiveDirectoryMSI(felügyelt identitás) -
Interaktív felhasználói bejelentkezés: Használat
ActiveDirectoryInteractive -
Szolgáltatásnév: Használat
ActiveDirectoryServicePrincipal
Jótanács
Az itt használt kapcsolati sztring nagyban függ attól, hogy milyen TÍPUSÚ SQL-adatbázishoz csatlakozik. A kapcsolati sztringekről és azok szintaxisáról további információt a DSN és a kapcsolati sztring kulcsszavak és attribútumok című témakörben talál.
Szövegszerkesztőben hozzon létre egy sqltest.py nevű új fájlt.
Adja hozzá a következő kódot.
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)
A kód futtatása
Egy parancssorban futtassa a következő parancsot:
python sqltest.pyEllenőrizze, hogy az adatbázisok és azok rendezései vissza lettek-e adva, majd zárja be a parancsablakot.
Ha hibaüzenetet kap:
Ellenőrizze, hogy a kiszolgáló neve, az adatbázis neve, a felhasználónév és a jelszó helyes-e.
Ha helyi környezetből futtatja a kódot, ellenőrizze, hogy a elérni kívánt Azure-erőforrás tűzfala úgy van-e konfigurálva, hogy engedélyezze a hozzáférést a környezet IP-címéről.