Guida introduttiva: Connettersi con il driver pymssql per Python

In questa guida introduttiva si connette uno script Python a un database creato e caricato con dati di esempio. Usare il pymssql driver per Python per connettersi al database ed eseguire operazioni di base, ad esempio la lettura e la scrittura di dati.

Documentazione pymssql | codice sorgente pymssql | Pacchetto (PyPi)

Prerequisiti

Python 3
- Se Python non è già disponibile, installare la gestione pacchetti Python runtime e Python Package Index (PyPI) da python.org.
- Preferisce non usare il proprio ambiente? Apri come devcontainer usando GitHub Codespaces.
pymssql pacchetto di PyPI.
Database su SQL Server, database SQL su Azure o database SQL in Fabric con lo schema di esempio AdventureWorks2025 e una stringa di connessione valida.

Configurazione

Seguire questa procedura per configurare l'ambiente di sviluppo per sviluppare un'applicazione usando il pymssql driver Python.

Annotazioni

Questo driver usa il protocollo TDS (Tabular Data Stream), che è abilitato per impostazione predefinita in SQL Server, nel database SQL in Fabric e nel database SQL di Azure. Non è necessaria alcuna configurazione aggiuntiva.

Installare il pacchetto pymssql

Ottieni il pymssql pacchetto da PyPI.

Aprire un prompt dei comandi in una directory vuota.
Installare il pacchetto pymssql.
```
pip install pymssql
```

Installare il pacchetto python-dotenv

Ottieni il python-dotenv da PyPI.

Nella stessa directory installare il python-dotenv pacchetto.
```
pip install python-dotenv
```

Controllare i pacchetti installati

È possibile usare lo strumento da riga di comando PyPI per verificare che i pacchetti previsti siano installati.

Controllare l'elenco dei pacchetti installati con pip list.
```
pip list
```

Creare un database SQL

Questa guida introduttiva richiede lo schema AdventureWorks2025 Lightweight, su Microsoft SQL Server, nel database SQL di Fabric o nel database SQL di Azure.

Creare un database SQL in pochi minuti usando il portale di Azure

Creare un nuovo file

Creare un file denominato app.py.

Aggiungere una docstring del modulo.

"""
Connects to a SQL database using pymssql
"""

Importare pacchetti, incluso pymssql.

from os import getenv
from dotenv import load_dotenv
from pymssql import connect

Usare la pymssql.connect funzione per connettersi a un database SQL.

load_dotenv()
conn = connect(getenv("SQL_SERVER"),getenv("SQL_USER"),getenv("SQL_PASSWORD"),getenv("SQL_DATABASE"))

Nella directory corrente creare un nuovo file denominato .env.
All'interno del .env file aggiungere voci per i valori della stringa di connessione denominati SQL_SERVER, SQL_USERSQL_PASSWORD, , SQL_DATABASE. Sostituire i segnaposto qui con i valori effettivi della stringa di connessione.
```
SQL_SERVER="<server_name>"
SQL_USER="<sql_user_name>"
SQL_PASSWORD="<sql_user_password>"
SQL_DATABASE="<sql_database>"
```
Suggerimento

La stringa di connessione usata qui dipende in gran parte dal tipo di database SQL a cui ci si connette. Per altre informazioni sulle stringhe di connessione e sulla relativa sintassi, vedere Attributi di connessione FreeTDS.

Eseguire una query

Usare una stringa di query SQL per eseguire una query e analizzare i risultati.

Creare una variabile per la stringa di query 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;
"""

Utilizzare cursor.execute per recuperare un set di risultati da una query sul database.
```
cursor = conn.cursor(as_dict=True)
cursor.execute(SQL_QUERY)
```
Annotazioni

Questa funzione accetta essenzialmente qualsiasi query e restituisce un set di risultati, che può essere iterato con l'uso di cursor.fetchone().

Usare un foreach ciclo per ottenere tutti i record dal database. Stampare quindi i record.

for r in cursor:
    print(f"{r['CustomerID']}\t{r['OrderCount']}\t{r['CompanyName']}")

Salvare il app.py file.

Aprire un terminale e testare l'applicazione.

python app.py

Ecco l'output previsto.

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

Inserire una riga come transazione

Eseguire un'istruzione INSERT in modo sicuro e passare i parametri. Il passaggio di parametri come valori protegge l'applicazione da attacchi SQL injection .

Aggiungere un'importazione per randrange dalla libreria random all'inizio di app.py.
```
from random import randrange
```
Alla fine di app.py aggiungere codice per generare un numero di prodotto casuale.
```
productNumber = randrange(1000)
```
Suggerimento

La generazione di un numero di prodotto casuale qui garantisce che sia possibile eseguire questo esempio più volte.

Creare una stringa di istruzione SQL.

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

Eseguire l'istruzione usando cursor.execute.

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

Recuperare il singolo risultato usando cursor.fetchone, stampare l'identificatore univoco del risultato e quindi eseguire il commit dell'operazione come transazione usando connection.commit.
```
result = cursor.fetchone()
print(f"Inserted Product ID : {result['ProductID']}")
conn.commit()
```
Suggerimento

Facoltativamente, è possibile usare connection.rollback per eseguire il rollback della transazione.
Chiudere il cursore e la connessione usando cursor.close e connection.close.
```
cursor.close()
conn.close()
```
Salvare il app.py file e testare di nuovo l'applicazione.
```
python app.py
```
Ecco l'output previsto.
```
Inserted Product ID : 1001
```

Passo successivo

Per altri esempi, visitare il pymssql repository GitHub del driver per contribuire a idee o segnalare problemi.

Driver pymssql su GitHub

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2025-07-10