Avvio rapido: usare Python per eseguire query su un database nel database SQL di Azure o nell'istanza gestita di SQL di Azure

Si applica a:Database SQL di AzureIstanza gestita di SQL di AzureAzure Synapse Analytics

In questa guida di avvio rapido viene usato Python per connettersi a un database SQL di Azure, a un'istanza gestita di SQL di Azure o a un database di Synapse SQL e vengono usate le istruzioni T-SQL per eseguire query sui dati.

Prerequisiti

Per completare questo quickstart, sono necessari i seguenti elementi:

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.

• Un database in cui verrà eseguita una query.

  Per creare, quindi configurare un database è possibile usare una di queste guide di avvio rapido:

  Azione	Database SQL	Istanza gestita di SQL	SQL Server in una macchina virtuale Azure	Azure Synapse Analytics
  Creazione	Portale	Portale	Portale	Portale
  	CLI			CLI
  	PowerShell	PowerShell	PowerShell	PowerShell
  	Modello di distribuzione	Modello di distribuzione	Modello di distribuzione	Modello di distribuzione
  Configurare	Regola del firewall IP a livello di server	Connettività da una VM		Impostazioni della connettività
  		Connettività dall'ambiente locale	Connettersi a un'istanza di SQL Server
  Ottenere informazioni di connessione	Azure SQL	Azure SQL	VM SQL	Synapse SQL

• Python 3 e software correlato

  Azione	macOS	Linux	Windows
  Installare il driver ODBC, sqlcmd e il driver Python per SQL Server	Configurare l'ambiente per lo sviluppo Python con pyodbc	Configurare l'ambiente per lo sviluppo Python con pyodbc	Configurare l'ambiente per lo sviluppo Python con pyodbc.
  Installare Python e altri pacchetti necessari		Usa sudo apt-get install python python-pip gcc g++ build-essential.
  Ulteriori informazioni	Driver Microsoft ODBC su macOS	Driver ODBC Microsoft su Linux	Driver ODBC Microsoft su Windows

Per esplorare ulteriormente Python e il database nel database SQL di Azure, vedere Librerie del database SQL di Azure per Python, il repository di modelli pyodbc e un esempio di modelli pyodbc.

Creare il codice per eseguire query sul database

1. Nell'editor di testo, creare un nuovo file chiamato sqltest.py.

2. Aggiungi il seguente codice. Ottenere le informazioni sulla connessione dalla sezione dei prerequisiti e sostituire i valori con quelli corretti per <server>, <database>, <nome utente> e <password>.

   import pyodbc
   server = '<server>.database.windows.net'
   database = '<database>'
   username = '<username>'
   password = '{<password>}'
   driver= '{ODBC Driver 17 for SQL Server}'
   
   with pyodbc.connect('DRIVER='+driver+';SERVER=tcp:'+server+';PORT=1433;DATABASE='+database+';UID='+username+';PWD='+ password) as conn:
       with conn.cursor() as cursor:
           cursor.execute("SELECT TOP 3 name, collation_name FROM sys.databases")
           row = cursor.fetchone()
           while row:
               print (str(row[0]) + " " + str(row[1]))
               row = cursor.fetchone()
   

Eseguire il codice

1. Al prompt dei comandi, eseguire il seguente comando:

   python sqltest.py
   

2. Verificare che vengano restituiti i database e le relative regole di confronto, quindi chiudere la finestra di comando.

   Se si riceve un errore:

   • Controllare che il nome del server, il nome del database, il nome utente e la password in uso siano corretti.
   • Verificare che il driver ODBC installato appartenga alla stessa versione della variabile driver nel codice precedente. Per esempio, il codice mostra 17, ma potrebbe essere stata installata una versione diversa.
   • Se si esegue il codice da un ambiente locale, verificare che il firewall della risorsa di Azure a cui si sta tentando di accedere sia configurato per consentire l'accesso dall'indirizzo IP di ambiente.

Passaggi successivi

• Progettare il primo database nel database SQL di Azure
• Driver di Microsoft Python per SQL Server
• Centro per sviluppatori Python