Rychlý start: Připojení pomocí ovladače mssql-python pro Python

V tomto rychlém startu připojíte skript Pythonu k databázi, kterou jste vytvořili a načetli s ukázkovými daty. Používáte mssql-python ovladač pro Python k připojení k databázi a provádění základních operací, jako je čtení a zápis dat.

Ovladač mssql-python nevyžaduje žádné externí závislosti na počítačích s Windows. Ovladač nainstaluje všechno, co potřebuje, s jednou pip instalací, což vám umožní používat nejnovější verzi ovladače pro nové skripty bez přerušení jiných skriptů, které nemáte čas upgradovat a testovat.

Použijte příklad lokální SQL autentizace v tomto článku pouze pro lokální vývoj proti instanci SQL Server, kterou ovládáte. V případě služby Azure SQL Database, databáze SQL v řešení Fabric, sdílených vývojových prostředí, CI a nasazení do produkce začněte s ověřováním Microsoft Entra nebo jiným bezheslovým postupem.

Dokumentace mssql-python | | |

Požadavky

Python 3.10 nebo novější.
Pokud ještě nemáte Python, nainstalujte Python runtime a správce balíčků pip z python.org.
Nechcete používat vlastní prostředí? Postupujte podle Kontejner a místní vývoj a vytvořte reprodukovatelné vývojové prostředí devcontainer nebo GitHub Codespaces.
(Volitelné) Azure Command-Line Interface (CLI).

Vytvořte nebo se připojte k databázi na SQL Server, Azure SQL Database nebo SQL databázi ve Fabric. Použijte následující kroky k nastavení databáze se vzorovým AdventureWorks2025 schématem a připojovací řetězec si nechte na později.

Vytvoření databáze SQL

Vytvořte nebo se připojte k SQL databázi na jedné z následujících platforem:

Vytvoření databáze SQL v řádu minut pomocí webu Azure Portal

Nastavení

Podle těchto kroků nakonfigurujte vývojové prostředí pro vývoj aplikace pomocí ovladače Pythonu mssql-python .

Poznámka:

Tento ovladač používá protokol Tabular Data Stream (TDS). SQL Server, SQL databáze ve Fabric a Azure SQL Database ve výchozím nastavení povolují TDS, takže není potřeba žádná další konfigurace.

Nainstalujte požadavky operačního systému

Nainstalujte požadavky specifické pro jednorázový operační systém. Uživatelé Windows mohou tento krok přeskočit. Pro úplné podrobnosti o platformě viz Instalace mssql-python.

apk add libtool krb5-libs krb5-dev libstdc++

apt-get install -y libltdl7 libkrb5-3 libgssapi-krb5-2

dnf install -y libtool-ltdl krb5-libs

zypper install -y libltdl7 libkrb5-3 libgssapi-krb5-2

zypper install -y libltdl7

brew install openssl

Instalace balíčku mssql-python

mssql-python Získejte balíček z PyPI.

Otevřete příkazový řádek v prázdném adresáři.
Nainstalujte balíček mssql-python.
```
pip install mssql-python
```

Nainstalovat balíček python-dotenv

Získejte balíček python-dotenv z PyPI.

Ve stejném adresáři nainstalujte python-dotenv balíček.

pip install python-dotenv

Kontrola nainstalovaných balíčků

Použijte pip list k ověření, že máte nainstalované požadované balíčky.

pip list

Vytvoření nového souboru

Vytvořte nový soubor s názvem app.py.

Přidejte dokumentační řetězec modulu.

"""
Connects to a SQL database using mssql-python
"""

Importujte balíčky, včetně mssql-python.

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

mssql-python.connect Pomocí funkce se připojte k databázi SQL.
```
load_dotenv()
conn = connect(getenv("SQL_CONNECTION_STRING"))
```
V aktuálním adresáři vytvořte nový soubor s názvem .env.
.env V souboru přidejte položku pro připojovací řetězec s názvem SQL_CONNECTION_STRING. Použijte jeden z následujících příkladů a nahraďte zástupné hodnoty svými skutečnými hodnotami.

Pro Azure SQL Database nebo SQL databázi ve Fabric začněte s Microsoft Entra authentication:
```
SQL_CONNECTION_STRING="Server=<server>;Database=<database>;Encrypt=yes;TrustServerCertificate=no;Authentication=ActiveDirectoryInteractive"
```
Pro lokální SQL Server během vývoje začněte s SQL autentizací:
```
SQL_CONNECTION_STRING="Server=localhost,1433;Database=<database>;UID=<user_id>;PWD=<password>;Encrypt=yes;TrustServerCertificate=yes"
```
Caution

Považujte to .env za místní rozvojovou pohodlnost, ne za mechanismus nasazení. Nikdy ho necommitujte, nikdy nepoužívejte tento SQL autentizační vzorek ve sdílených nebo produkčních prostředích a udržujte validaci certifikátů zapnutou mimo lokální vývoj.

Použijte řetězce spojení k úpravě vzorku pro pojmenované instance, kontejnery nebo pokročilá nastavení. Pokud se připojujete k Azure SQL Database nebo SQL databázi ve Fabric, použijte Microsoft Entra autentizaci pro možnosti přihlášení bez hesla a interaktivní přihlášení. Pro širší pokyny ohledně tajemství a certifikátů viz nejlepší bezpečnostní postupy.

Návod

V systému macOS funguje ověřování pomocí Microsoft Entra jak s ActiveDirectoryInteractive, tak s ActiveDirectoryDefault. ActiveDirectoryInteractive vás vyzve k přihlášení při každém spuštění skriptu. Aby se zabránilo opakovaným výzvám k přihlášení, přihlaste se jednou pomocí příkazu Azure CLIaz login az login a použijte ActiveDirectoryDefault. ActiveDirectoryDefault znovu použije uložené přihlašovací údaje.

Provedení dotazu

Použijte dotazovací řetězec Transact-SQL (T-SQL) k provedení dotazu a analýze výsledků.

Vytvořte proměnnou pro dotazovací řetězec T-SQL.

SQL_QUERY = """
SELECT TOP 5
    c.CustomerID,
    c.CompanyName,
    COUNT(soh.SalesOrderID) AS OrderCount
FROM SalesLT.Customer AS c
LEFT OUTER JOIN SalesLT.SalesOrderHeader AS soh
    ON c.CustomerID = soh.CustomerID
GROUP BY
    c.CustomerID,
    c.CompanyName
ORDER BY OrderCount DESC;
"""

Slouží cursor.execute k načtení sady výsledků z dotazu na databázi.
```
cursor = conn.cursor()
cursor.execute(SQL_QUERY)
```
Poznámka:

Tato funkce přijímá jakýkoli dotaz a vrací množinu výsledků. Pro iteraci přes výslednou množinu použijte kurzor.fetchone().

Použijte cursor.fetchall se smyčkou for k získání všech záznamů z databáze. Pak si vytiskněte záznamy.

records = cursor.fetchall()
for r in records:
    print(f"{r.CustomerID}\t{r.OrderCount}\t{r.CompanyName}")

app.py soubor.

Otevřete terminál a otestujte aplikaci.

python app.py

Tady je očekávaný výstup.

29485   1       Professional Sales and Service
29531   1       Remarkable Bike Store
29546   1       Bulk Discount Store
29568   1       Coalition Bike Company
29584   1       Futuristic Bikes

Vložte řádek jako transakci

Bezpečně spusťte INSERT příkaz a předejte parametry. Předávání parametrů jako hodnot chrání vaši aplikaci před útoky prostřednictvím injektáže SQL .

Přidejte import randrange z knihovny random do horní části souboru app.py.
```
from random import randrange
```
Na konci app.py přidejte kód pro vygenerování náhodného čísla výrobku.
```
productNumber = randrange(1000)
```
Návod

Náhodné číslo produktu snižuje pravděpodobnost chyby duplicitního klíče, pokud tento vzorek spustíte vícekrát.

Vytvořte příkazový řetězec T-SQL.

SQL_STATEMENT = """
INSERT SalesLT.Product (
    Name,
    ProductNumber,
    StandardCost,
    ListPrice,
    SellStartDate
)
OUTPUT INSERTED.ProductID
VALUES (%(name)s, %(product_number)s, %(standard_cost)s, %(list_price)s, CURRENT_TIMESTAMP)
"""

Proveďte příkaz pomocí cursor.execute.

cursor.execute(
    SQL_STATEMENT,
    {
        'name': f'Example Product {productNumber}',
        'product_number': f'EXAMPLE-{productNumber}',
        'standard_cost': 100,
        'list_price': 200
    }
)

Načtěte jeden výsledek pomocí cursor.fetchone, vytiskněte jedinečný identifikátor výsledku a pak potvrďte operaci jako transakci pomocí connection.commit.
```
result = cursor.fetchone()
print(f"Inserted Product ID : {result.ProductID}")
conn.commit()
```
Návod

Volitelně můžete použít connection.rollback k vrácení transakce zpět.
Zavřete kurzor a připojení pomocí cursor.close a connection.close.
```
cursor.close()
conn.close()
```
app.py soubor a aplikaci znovu otestujte.
```
python app.py
```
Tady je očekávaný výstup.
```
Inserted Product ID : 1001
```

Váš názor

Byla tato stránka užitečná?

Poslední aktualizace v 2026-10-19