Ottenere informazioni sui pacchetti Python

Si applica a: SQL Server 2017 (14.x) e versioni successive Istanza gestita di SQL di Azure

Questo articolo descrive come ottenere informazioni sui pacchetti Python installati in Machine Learning Services per SQL Server e in cluster Big Data, inclusi i percorsi di installazione e le versioni. Gli script Python di esempio mostrano come elencare le informazioni sui pacchetti, ad esempio il percorso di installazione e la versione.

Percorso della libreria Python predefinita

Quando si installa Machine Learning con SQL Server, viene creata una singola libreria di pacchetti a livello di istanza per ogni linguaggio installato. La libreria dell'istanza è una cartella protetta registrata con SQL Server.

Qualsiasi script o codice eseguito nel database in SQL Server deve caricare le funzioni dalla libreria dell'istanza. SQL Server non può accedere ai pacchetti installati in altre librerie. Questo vale anche per i client remoti. Qualsiasi codice Python in esecuzione nel contesto di calcolo del server può usare solo i pacchetti installati nella libreria dell'istanza. Per assicurare la protezione delle risorse del server, la libreria dell'istanza predefinita può essere modificata solo da un amministratore del computer.

Il percorso predefinito dei file binari per Python è il seguente:

C:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\PYTHON_SERVICES

In questo esempio si presuppone che venga usata l'istanza di SQL predefinita, ovvero MSSQLSERVER. Se SQL Server è installato come istanza definita dall'utente, in alternativa viene usato il nome specificato.

Abilitare gli script esterni eseguendo i comandi SQL seguenti:

sp_configure 'external scripts enabled', 1;
RECONFIGURE WITH override;

Eseguire l'istruzione SQL seguente per verificare la libreria predefinita per l'istanza corrente. Questo esempio restituisce l'elenco delle cartelle incluse nella variabile sys.path di Python. L'elenco include la directory corrente e il percorso della libreria standard.

EXECUTE sp_execute_external_script
  @language =N'Python',
  @script=N'import sys; print("\n".join(sys.path))'

Per altre informazioni sulla variabile sys.path e su come viene usata per impostare il percorso di ricerca dell'interprete per i moduli, vedere The Module Search Path (Percorso di ricerca dei moduli).

Nota

Non provare a installare i pacchetti Python direttamente nella libreria di pacchetti SQL usando pip o metodi simili. Usare invece sqlmlutils per installare i pacchetti in un'istanza di SQL. Per altre informazioni, vedere Installare pacchetti Python con sqlmlutils.

Pacchetti Microsoft Python predefiniti

Quando si seleziona la funzionalità Python durante l'installazione di Machine Learning Services per SQL Server, vengono installati i pacchetti Microsoft Python seguenti.

Pacchetti	Versione	Descrizione
revoscalepy	9.4.7	Usato per contesti di calcolo remoti, streaming, esecuzione parallela di funzioni rx per l'importazione e la trasformazione dei dati, modellazione, visualizzazione e analisi.
microsoftml	9.4.7	Aggiunge algoritmi di Machine Learning in Python.

Per informazioni sulla versione di Python inclusa, vedere Versioni di Python e R.

Aggiornamenti dei componenti

Per impostazione predefinita, i pacchetti Python vengono aggiornati tramite i Service Pack e gli aggiornamenti cumulativi. Pacchetti aggiuntivi e aggiornamenti della versione completa dei componenti Python principali sono possibili solo tramite aggiornamenti del prodotto.

Pacchetti Python open source predefiniti

Quando si seleziona l'opzione relativa al linguaggio Python durante l'installazione, viene installata la distribuzione Anaconda 4.2 (su Python 3.5). Oltre alle librerie di codice Python, l'installazione standard include dati di esempio, unit test e script di esempio.

Importante

Non si dovrebbe mai sovrascrivere manualmente la versione di Python installata dal programma di installazione di SQL Server con le versioni più recenti sul Web. I pacchetti Microsoft per Python sono basati su versioni specifiche di Anaconda. La modifica dell'installazione può rendere instabile questa distribuzione.

Elenco di tutti i pacchetti Python installati

Lo script di esempio seguente visualizza un elenco di tutti i pacchetti Python installati nell'istanza di SQL Server.

EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
import pkg_resources
import pandas
OutputDataSet = pandas.DataFrame(sorted([(i.key, i.version) for i in pkg_resources.working_set]))'
WITH result sets((Package NVARCHAR(128), Version NVARCHAR(128)));

Trovare un singolo pacchetto Python

Se è stato installato un pacchetto Python e si vuole verificare che il pacchetto sia disponibile per una determinata istanza di SQL Server, è possibile eseguire una stored procedure per cercare il pacchetto e restituire messaggi.

Il codice seguente, ad esempio, esegue la ricerca del pacchetto scikit-learn. Se il pacchetto viene trovato, il codice stampa la versione del pacchetto.

EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
import pkg_resources
pkg_name = "scikit-learn"
try:
    version = pkg_resources.get_distribution(pkg_name).version
    print("Package " + pkg_name + " is version " + version)
except:
    print("Package " + pkg_name + " not found")
'

Risultato:

STDOUT message(s) from external script: Package scikit-learn is version 0.20.2

Visualizzare la versione di Python

Il codice di esempio seguente restituisce la versione di Python installata nell'istanza di SQL Server.

EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
import sys
print(sys.version)
'

Passaggi successivi

• Installare nuovi pacchetti Python con sqlmlutils