Szybki start: nawiązywanie połączenia za pomocą sterownika mssql-python dla języka Python

W tym przewodniku połączysz skrypt języka Python z bazą danych, którą utworzyłeś i wypełniłeś danymi przykładowymi. Sterownik mssql-python dla Pythona służy do łączenia się z twoją bazą danych i wykonywania podstawowych operacji, takich jak odczytywanie i zapisywanie danych.

Sterownik mssql-python nie wymaga żadnych zależności zewnętrznych na maszynach z systemem Windows. Sterownik instaluje wszystko, czego potrzebuje w ramach pojedynczej pip instalacji, co pozwala na użycie najnowszej wersji sterownika dla nowych skryptów bez przerywania innych skryptów, których nie masz czasu na uaktualnienie i przetestowanie.

Dokumentacja mssql-pythonkod źródłowy mssql-pythonPakiet (PyPi)Visual Studio Code

Wymagania wstępne

Python 3
- Jeśli nie masz jeszcze języka Python, zainstaluj środowisko uruchomieniowe języka Python i menedżera pakietów python (PyPI) z python.org.
- Wolisz nie używać własnego środowiska? Otwórz jako devcontainer przy użyciu usługi GitHub Codespaces.
(Opcjonalnie) Interfejs wiersza polecenia platformy Azure
Baza danych w programie SQL Server, usłudze Azure SQL Database lub bazie danych SQL w usłudze Fabric z przykładowym AdventureWorks2025 schematem i prawidłowymi parametrami połączenia.

Konfiguracja

Wykonaj następujące kroki, aby skonfigurować środowisko deweloperskie do tworzenia aplikacji przy użyciu mssql-python sterownika języka Python.

Uwaga / Notatka

Ten sterownik używa protokołu Tabular Data Stream (TDS), który jest domyślnie włączony na SQL Server, bazie danych SQL Fabric i usłudze Azure SQL Database. Nie jest wymagana żadna dodatkowa konfiguracja.

Instalowanie pakietu mssql-python

mssql-python Pobierz pakiet z PyPI.

Otwórz wiersz polecenia w pustym katalogu.

Zainstaluj pakiet mssql-python.

pip install mssql-python

apk add libtool krb5-libs krb5-dev
pip install mssql-python

apt-get install -y libltdl7 libkrb5-3 libgssapi-krb5-2
pip install mssql-python

dnf install -y libtool-ltdl krb5-libs
pip install mssql-python

zypper install -y libltdl7 libkrb5-3 libgssapi-krb5-2
pip install mssql-python

zypper install -y libltdl7
pip install mssql-python

brew install openssl
pip install mssql-python

Instalowanie pakietu python-dotenv

Pobierz element python-dotenv z PyPI.

W tym samym katalogu zainstaluj pakiet python-dotenv.
```
pip install python-dotenv
```

Sprawdzanie zainstalowanych pakietów

Możesz użyć narzędzia wiersza polecenia PyPI, aby sprawdzić, czy są zainstalowane zamierzone pakiety.

Sprawdź listę zainstalowanych pakietów za pomocą polecenia pip list.
```
pip list
```

Tworzenie bazy danych SQL

Ten szybki start wymaga schematu AdventureWorks2025 Lightweight w Microsoft SQL Server, bazie danych SQL w Fabric lub Azure SQL Database.

Tworzenie bazy danych SQL w ciągu kilku minut przy użyciu witryny Azure Portal

Tworzenie nowego pliku

Utwórz nowy plik o nazwie app.py.

Dodaj docstring modułu.

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

Importuj pakiety, w tym mssql-python.

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

mssql-python.connect Użyj funkcji , aby nawiązać połączenie z bazą danych SQL.
```
load_dotenv()
conn = connect(getenv("SQL_CONNECTION_STRING"))
```
W bieżącym katalogu utwórz nowy plik o nazwie .env.
W pliku .env dodaj wpis dla łańcucha połączenia o nazwie SQL_CONNECTION_STRING. Zastąp przykład wartością rzeczywistych parametrów połączenia.
```
SQL_CONNECTION_STRING="Server=<server_name>;Database={<database_name>};Encrypt=yes;TrustServerCertificate=no;Authentication=ActiveDirectoryInteractive"
```
Wskazówka

Parametry połączenia używane w tym miejscu w dużej mierze zależą od typu bazy danych SQL, z którą nawiązujesz połączenie. Jeśli nawiązujesz połączenie z usługą Azure SQL Database lub bazą danych SQL w sieci szkieletowej, użyj parametrów połączenia ODBC z karty parametry połączenia. W zależności od scenariusza może być konieczne dostosowanie typu uwierzytelniania. Aby uzyskać więcej informacji na temat parametrów połączenia i ich składni, zobacz dokumentację składni parametrów połączenia.

Wykonywanie zapytania

Użyj ciągu zapytania SQL, aby wykonać zapytanie i przeanalizować wyniki.

Utwórz zmienną dla ciągu zapytania 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;
"""

Użyj cursor.execute polecenia , aby pobrać zestaw wyników z zapytania względem bazy danych.
```
cursor = conn.cursor()
cursor.execute(SQL_QUERY)
```
Uwaga / Notatka

Ta funkcja zasadniczo akceptuje dowolne zapytanie i zwraca zestaw wyników, który można iterować za pomocą funkcji cursor.fetchone().
Użyj cursor.fetchall z pętlą foreach, aby pobrać wszystkie rekordy z bazy danych. Następnie wydrukuj rekordy.
```
records = cursor.fetchall()
for r in records:
  print(f"{r.CustomerID}\t{r.OrderCount}\t{r.CompanyName}")
```
app.py plik.

Wskazówka

Aby korzystać z uwierzytelniania Entra firmy Microsoft w systemie macOS, musisz się zalogować, uruchamiając polecenie az login za pośrednictwem interfejsu azure Command-Line (CLI).

Otwórz terminal i przetestuj aplikację.

python app.py

Oto oczekiwane dane wyjściowe.

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

Wstaw wiersz jako transakcję

Bezpiecznie wykonaj instrukcję INSERT i przekaż parametry. Przekazywanie parametrów jako wartości chroni aplikację przed atakami polegającymi na wstrzyknięciu kodu SQL .

Dodaj import randrange z biblioteki random na początku app.py.
```
from random import randrange
```
Na końcu app.py dodaj kod w celu wygenerowania losowego numeru produktu.
```
productNumber = randrange(1000)
```
Wskazówka

Generowanie losowego numeru produktu w tym miejscu gwarantuje, że można uruchomić ten przykład wiele razy.

Utwórz ciąg instrukcji SQL.

SQL_STATEMENT = """
INSERT SalesLT.Product (
Name,
ProductNumber,
StandardCost,
ListPrice,
SellStartDate
) OUTPUT INSERTED.ProductID
VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP)
"""

Wykonaj instrukcję przy użyciu polecenia cursor.execute.

cursor.execute(
   SQL_STATEMENT,
   (
      f'Example Product {productNumber}',
      f'EXAMPLE-{productNumber}',
      100,
      200
   )
)

Pobierz pojedynczy wynik przy użyciu metody cursor.fetchone, wyświetl unikatowy identyfikator wyniku, a następnie zatwierdź operację jako transakcję przy użyciu polecenia connection.commit.
```
result = cursor.fetchone()
print(f"Inserted Product ID : {result['ProductID']}")
conn.commit()
```
Wskazówka

Opcjonalnie możesz użyć connection.rollback polecenia , aby wycofać transakcję.
Zamknij kursor i połączenie za pomocą polecenia cursor.close i connection.close.
```
cursor.close()
conn.close()
```
app.py plik i ponownie przetestuj aplikację.
```
python app.py
```
Oto oczekiwane dane wyjściowe.
```
Inserted Product ID : 1001
```

Następny krok

Odwiedź repozytorium GitHub sterowników mssql-python, aby uzyskać więcej przykładów, wnieść pomysły lub zgłaszać problemy.

sterownik mssql-python w witrynie GitHub

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-11-18