Obtenir des informations sur les packages Python

S’applique à : SQL Server 2017 (14.x) et versions ultérieures Azure SQL Managed Instance

Cet article explique comment obtenir des informations sur les packages Python installés, notamment les versions et les emplacements d’installation, sur Machine Learning Services sur SQL Server et sur Clusters Big Data. Les exemples de scripts Python vous montrent comment répertorier des informations de package telles que le chemin d’installation et la version.

Emplacement par défaut de la bibliothèque Python

Lorsque vous installez Machine Learning avec SQL Server, une seule bibliothèque de packages est créée au niveau de l’instance pour chaque langage que vous installez. La bibliothèque d’instances est un dossier sécurisé enregistré avec SQL Server.

Tous les scripts ou les codes qui s’exécutent dans la base de données sur SQL Server doivent charger les fonctions à partir de la bibliothèque d’instances. SQL Server ne peut pas accéder aux packages installés dans d’autres bibliothèques. Cela s’applique également aux clients distants : tout code Python qui s’exécute dans le contexte de calcul du serveur peut uniquement utiliser des packages installés dans la bibliothèque d’instances. Pour protéger les ressources du serveur, la bibliothèque d’instances par défaut ne peut être modifiée que par un administrateur de l’ordinateur.

Le chemin d’accès par défaut aux éléments binaires pour Python est :

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

Cela nécessite d’utiliser l’instance SQL par défaut, MSSQLSERVER. Si SQL Server est installé en tant qu’instance nommée définie par l’utilisateur, le nom donné est utilisé à la place.

Activez les scripts externes en exécutant les commandes SQL suivantes :

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

Exécutez l’instruction SQL suivante si vous souhaitez vérifier la bibliothèque par défaut de l’instance actuelle. Cet exemple renvoie la liste des dossiers inclus dans la variable sys.path Python. La liste comprend le répertoire actuel et le chemin d’accès de la bibliothèque standard.

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

Pour en savoir plus sur la variable sys.path et sur la façon dont elle est utilisée pour définir le chemin de recherche de l’interpréteur pour les modules, consultez la section Chemin de recherche du module.

Notes

N’essayez pas d’installer directement des packages Python dans la bibliothèque de packages SQL à l’aide de pip ou de méthodes similaires. Utilisez plutôt sqlmlutils pour installer des packages dans une instance SQL. Pour plus d’informations, consultez Installation de packages Python avec sqlmlutils.

Packages Microsoft Python par défaut

Les packages Microsoft Python suivants sont installés avec SQL Server Machine Learning Services lorsque vous sélectionnez la fonctionnalité Python au moment de l’installation.

.	Version	Description
revoscalepy	9.4.7	Utilisé pour les contextes de calcul distants, la diffusion en continu, l’exécution parallèle des fonctions rx pour l’importation et la transformation des données, la modélisation, la visualisation et l’analyse.
microsoftml	9.4.7	Ajoute des algorithmes d’apprentissage automatique dans Python.

Pour plus d’informations sur la version de Python incluse, consultez les Versions de Python et de R.

Mise à niveau des composants

Par défaut, les packages Python sont actualisés grâce aux Service Packs et aux mises à jour cumulatives. Des packages supplémentaires et des mises à niveau de version complètes de composants de base Python sont possibles uniquement par le biais de mises à niveau de produit.

Packages Python open source par défaut

Lorsque vous sélectionnez l’option de langage Python au cours de l’installation, la distribution Anaconda 4.2 (sur Python 3.5) est installée. En plus des bibliothèques de code Python, l’installation standard comprend des exemples de données, des tests unitaires et des exemples de scripts.

Important

Ne remplacez jamais manuellement la version de Python installée par le programme de SQL Server par des versions plus récentes obtenues sur le Web. Les packages Microsoft Python sont basés sur des versions spécifiques d’Anaconda. Vous risquez de les déstabiliser si vous modifiez votre installation.

Répertorier tous les packages Python ayant été installés

L’exemple de script suivant affiche une liste de tous les packages Python installés dans l’instance 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)));

Rechercher un seul package Python

Si vous avez installé un package Python et que vous souhaitez vous assurer qu’il est disponible pour une instance SQL Server donnée, vous pouvez exécuter une procédure stockée pour rechercher le package et renvoyer des messages.

Par exemple, le code suivant recherche le package scikit-learn. Si le package est trouvé, le code imprime la version du package.

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")
'

Résultat :

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

Affichage de la version de Python

L’exemple de code suivant retourne la version de Python installée sur l’instance de SQL Server.

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

Étapes suivantes

• Installer de nouveaux packages Python avec sqlmlutils