Partager via

Installer SQL Server 2019 Machine Learning Services (Python et R) sur Linux

S’applique à : SQL Server 2019 (15.x) sur Linux

Cet article vous guide lors de l’installation de SQL Server Machine Learning Services sur Linux. Les scripts Python et R peuvent être exécutés dans la base de données à l’aide de Machine Learning Services.

Vous pouvez installer Machine Learning Services sur Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES) et Ubuntu. Pour plus d’informations, consultez la section Plateformes prises en charge dans Conseils d’installation pour SQL Server sur Linux.

Important

Ces instructions sont spécifiques à SQL Server 2019 (15.x). Pour SQL Server 2022 (16.x), où les étapes d’installation sont différentes, reportez-vous à Installer SQL Server 2022 Machine Learning Services (Python et R) sur Linux.

Liste de contrôle de préinstallation

  • Guide d'installation de SQL Server sur Linux et vérification de l'installation.

  • Vérifiez la présence des extensions Python et R dans les référentiels Linux SQL Server. Si vous avez déjà configuré des référentiels source pour l’installation du moteur de base de données, vous pouvez exécuter les commandes d’installation du package mssql-mlservices à l’aide de la même inscription de référentiel.

  • (R uniquement) Microsoft R Open (MRO) fournit la distribution R de base pour la fonctionnalité R dans SQL Server et est une condition préalable à l’utilisation de RevoScaleR, de MicrosoftML et d’autres packages R installés avec Machine Learning Services.

    • La version requise est MRO 3.5.2.
    • Inscrivez le packages.microsoft.com dépôt comme décrit plus loin dans cet article pour installer la distribution MRO : microsoft-r-open-mro et microsoft-r-open-mkl.
    • Consultez les sections d’installation plus loin dans cet article pour savoir comment installer MRO.

  • Vous devez disposer d’un outil pour l’exécution des commandes T-SQL.

Liste des packages

Sur un appareil connecté à Internet, les packages sont téléchargés et installés indépendamment du moteur de base de données à l’aide du programme d’installation de package pour chaque système d’exploitation. Le tableau suivant décrit tous les packages disponibles, mais pour R et Python, vous spécifiez des packages qui fournissent soit l’installation complète des fonctionnalités soit l’installation des fonctionnalités minimales.

Packages d’installation disponibles :

Nom du package S’applique à Désignation
mssql-server-extensibility Tout Framework d’extensibilité utilisé pour exécuter Python et R.
microsoft-openmpi Python, R Interface de passage de messages utilisée par les bibliothèques Revo* pour la parallélisation sur Linux.
mssql-mlservices-python Python Distribution open source d’Anaconda et de Python.
mssql-mlservices-mlm-py Python Installation complète. Fournit revoscalepy, microsoftml, modèles préentraînés pour la caractérisation d’image et l’analyse des sentiments de texte.
mssql-mlservices-packages-py Python Installation minimale. Fournit revoscalepy et microsoftml.

Exclut les modèles préentraînés.
microsoft-r-open* R Distribution open source de R, composée de trois packages.
mssql-mlservices-mlm-r R Installation complète. Fournit : RevoScaleR, MicrosoftML, sqlRUtils, olapR, modèles préentraînés pour la caractérisation d’image et l’analyse des sentiments de texte.
mssql-mlservices-packages-r R Installation minimale. Fournit RevoScaleR, sqlRUtils, MicrosoftML et olapr.

Exclut les modèles préentraînés.

Installer sur RHEL

Suivez ces étapes pour installer SQL Server Machine Learning Services sur Red Hat Enterprise Linux (RHEL).

Installer MRO sur RHEL

Les commandes suivantes inscrivent le référentiel fournissant MRO. Après l’inscription, les commandes d’installation d’autres packages R, telles que mssql-mlservices-mml-r, incluent automatiquement MRO en tant que dépendance de package.

# Import the Microsoft repository key

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

# Set the location of the package repo at the "prod" directory
# The following command is for version 8.x
# To get the version for 6.x or 7.x, replace 8 with 6 or 7, respectively.
rpm -Uvh https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm

# Update packages on your system (optional)
yum update

Options d’installation pour Python et R :

  • Installez la prise en charge linguistique en fonction de vos besoins (une ou plusieurs langues).
  • L’installation complète fournit toutes les fonctionnalités disponibles, notamment les modèles Machine Learning préentraînés.
  • L’installation minimale exclut les modèles mais offre toutes les fonctionnalités.

Conseil

Si possible, exécutez yum clean all pour actualiser les packages sur le système avant l’installation.

Installation complète

Inclut :

  • Python open source
  • R open source
  • Framework d’extensibilité
  • Microsoft-openmpi
  • Extensions (Python, R)
  • Bibliothèques de Machine Learning
  • Modèles préentraînés pour Python et R
# Install as root or sudo
# Add everything (all R, Python)
# Be sure to include -9.4.7* in mlservices package names
sudo yum install mssql-mlservices-mlm-py-9.4.7*
sudo yum install mssql-mlservices-mlm-r-9.4.7*

Installation minimale

Inclut :

  • Python open source
  • R open source
  • Framework d’extensibilité
  • Microsoft-openmpi
  • Bibliothèques Core Revo*
  • Bibliothèques de Machine Learning
# Install as root or sudo
# Minimum install of R, Python extensions
# Be sure to include -9.4.6* in mlservices package names
sudo yum install mssql-mlservices-packages-py-9.4.7*
sudo yum install mssql-mlservices-packages-r-9.4.7*

Installer sur Ubuntu

Suivez ces étapes pour installer SQL Server Machine Learning Services sur Ubuntu.

Installer MRO sur Ubuntu

Les commandes suivantes inscrivent le référentiel fournissant MRO. Après l’inscription, les commandes d’installation d’autres packages R, telles que mssql-mlservices-mml-r, incluent automatiquement MRO en tant que dépendance de package.

# Install as root
sudo su

# Optionally, if your system does not have the https apt transport option
apt-get install apt-transport-https

# If you are on Ubuntu 20.04, install the following package (MRO 3.5 has a dependency on libtinfo.so.5 in Ubuntu 20.04)
apt-get install libncurses5

# Set the location of the package repo the "prod" directory containing the distribution.
# This example specifies 20.04. Replace with 16.04 or 14.04 if you want those versions.
wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb

# Register the repo
dpkg -i packages-microsoft-prod.deb

# Update packages on your system (required), including MRO installation
sudo apt-get update

Options d’installation pour Python et R :

  • Installez la prise en charge linguistique en fonction de vos besoins (une ou plusieurs langues).
  • L’installation complète fournit toutes les fonctionnalités disponibles, notamment les modèles Machine Learning préentraînés.
  • L’installation minimale exclut les modèles mais offre toutes les fonctionnalités.

Conseil

Si possible, exécutez apt-get update pour actualiser les packages sur le système avant l’installation.

Installation complète

Inclut :

  • Python open source
  • R open source
  • Framework d’extensibilité
  • Microsoft-openmpi
  • Extensions Python
  • Extensions R
  • Bibliothèques de Machine Learning
  • Modèles préentraînés pour Python et R
# Install as root or sudo
# Add everything (all R, Python)
# There is no asterisk in this full install
sudo apt-get install mssql-mlservices-mlm-py
sudo apt-get install mssql-mlservices-mlm-r

Installation minimale

Inclut :

  • Python open source
  • R open source
  • Framework d’extensibilité
  • Microsoft-openmpi
  • Bibliothèques Core Revo*
  • Bibliothèques de Machine Learning
# Install as root or sudo
# Minimum install of R, Python
# No asterisk
sudo apt-get install mssql-mlservices-packages-py
sudo apt-get install mssql-mlservices-packages-r

Installer sur SLES

Suivez ces étapes pour installer SQL Server Machine Learning Services sur SUSE Linux Enterprise Server (SLES).

Installer MRO sur SLES

Les commandes suivantes inscrivent le référentiel fournissant MRO. Après l’inscription, les commandes d’installation d’autres packages R, telles que mssql-mlservices-mml-r, incluent automatiquement MRO en tant que dépendance de package.

# Install as root
sudo su

# Set the location of the package repo at the "prod" directory containing the distribution
# This example is for SLES12
zypper ar -f https://packages.microsoft.com/sles/12/prod packages-microsoft-com

# Update packages on your system (optional)
zypper update

Options d’installation pour Python et R :

  • Installez la prise en charge linguistique en fonction de vos besoins (une ou plusieurs langues).
  • L’installation complète fournit toutes les fonctionnalités disponibles, notamment les modèles Machine Learning préentraînés.
  • L’installation minimale exclut les modèles mais offre toutes les fonctionnalités.

Installation complète

Inclut :

  • Python open source
  • R open source
  • Framework d’extensibilité
  • Microsoft-openmpi
  • Extensions pour Python et R
  • Bibliothèques de Machine Learning
  • Modèles préentraînés pour Python et R
# Install as root or sudo
# Add everything (all R, Python)
sudo zypper install mssql-mlservices-mlm-py
sudo zypper install mssql-mlservices-mlm-r

Installation minimale

Inclut :

  • Python open source
  • R open source
  • Framework d’extensibilité
  • Microsoft-openmpi
  • Bibliothèques Core Revo*
  • Bibliothèques de Machine Learning
# Install as root or sudo
# Minimum install of R, Python extensions
sudo zypper install mssql-mlservices-packages-py
sudo zypper install mssql-mlservices-packages-r

Configuration après installation (obligatoire)

La configuration supplémentaire s’effectue principalement avec l’outil mssql-conf.

  1. Une fois l'installation du package terminée, exécutez mssql-conf setup et suivez les instructions pour définir le mot de passe sa et choisir votre édition. Effectuez cette étape uniquement si SQL Server sur Linux n’est pas encore configuré.

    sudo /opt/mssql/bin/mssql-conf setup

  2. Acceptez les contrats de licence pour les extensions Python et R open source. Utilisez la commande suivante :

    # Run as SUDO or root
# Use set + EULA
sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y

    Le programme d’installation détecte les packages mssql-mlservices et demande l’acceptation du CLUF (s’il n’a pas encore été accepté) lors de l’exécution de mssql-conf setup. Pour plus d’informations sur les paramètres de CLUF, consultez Configurer SQL Server avec l’outil mssql-conf.

  3. Activez l’accès réseau sortant. L’accès réseau sortant est désactivé par défaut. Pour activer les requêtes sortantes, définissez la propriété booléenne « outboundnetworkaccess » à l’aide de l’outil mssql-conf. Pour plus d’informations, consultez Configurer SQL Server sur Linux avec mssql-conf.

    # Run as SUDO or root
# Enable outbound requests over the network
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1

  4. Pour l'intégration des fonctionnalités R uniquement, définissez la variable d'environnement MKL_CBWR pour garantir une sortie cohérente des calculs de la bibliothèque Intel Math Kernel Library (MKL).

    • Modifiez ou créez un fichier .bash_profile dans le répertoire racine de votre utilisateur en ajoutant la ligne export MKL_CBWR="AUTO" au fichier.

    • Exécutez ce fichier en saisissant source .bash_profile à l’invite de commandes bash.

  5. Redémarrez le service SQL Server Launchpad et l’instance du moteur de base de données pour lire les valeurs mises à jour à partir du fichier INI. Un message de notification s’affiche quand un paramètre relatif à l’extensibilité est modifié.

    systemctl restart mssql-launchpadd

systemctl restart mssql-server.service

  6. Activez l’exécution de script externe. Vous pouvez vous connecter à une instance de SQL Server à l’aide de n’importe quel outil client SQL Server familier, tel que sqlcmd, SQL Server Management Studio (SSMS) ou l’extension MSSQL pour Visual Studio Code.

    EXECUTE sp_configure 'external scripts enabled', 1;

RECONFIGURE WITH OVERRIDE;

  7. Redémarrez le service Launchpad.

Vérifier l'installation

Les bibliothèques R (MicrosoftML, RevoScaleR et autres) sont disponibles sur /opt/mssql/mlservices/libraries/RServer.

Les bibliothèques Python (microsoftml et revoscalepy) sont disponibles sur /opt/mssql/mlservices/libraries/PythonServer.

Pour valider l’installation

  • Exécutez un script T-SQL qui exécute une procédure stockée système appelant Python ou R à l’aide d’un outil de requête.

  • Exécutez la commande T-SQL suivante pour tester l’exécution de R dans SQL Server. Des erreurs ? Essayez un redémarrage du service, sudo systemctl restart mssql-server.service.

    EXECUTE sp_execute_external_script
    @language = N'R',
    @script = N'
        OutputDataSet <- InputDataSet', @input_data_1 = N'SELECT 1 AS hello'
    WITH RESULT SETS
(
        ([hello] INT NOT NULL)
);
GO

  • Exécutez la commande T-SQL suivante pour tester l’exécution de Python dans SQL Server.

    EXECUTE sp_execute_external_script
    @language = N'Python',
    @script = N'
        OutputDataSet = InputDataSet;', @input_data_1 = N'SELECT 1 AS hello'
    WITH RESULT SETS
(
        ([hello] INT NOT NULL)
);
GO

Installation sans assistance

À l'aide de l’installation sans assistance du moteur de base de données, ajoutez les packages pour mssql-mlservices et les CLUF.

Utilisez l’un des paramètres de CLUF propres à mlservices pour les distributions R et Python open source :

sudo /opt/mssql/bin/mssql-conf setup accept-eula-ml

Le CLUF complet est documenté dans Configurer SQL Server sur Linux avec l’outil mssql-conf.

Installation hors connexion

Suivez les instructions d'installation hors connexion pour connaître les étapes d’installation des packages. Recherchez votre site de téléchargement, puis téléchargez des packages spécifiques à l’aide de la liste des packages qui suit.

Conseil

Plusieurs outils de gestion des packages fournissent des commandes qui peuvent vous aider à déterminer les dépendances du package. Pour yum, utilisez sudo yum deplist [package]. Pour Ubuntu, utilisez sudo apt-get install --reinstall --download-only [package name], suivi de dpkg -I [package name].deb.

Site de téléchargement

Téléchargez des packages à partir de https://packages.microsoft.com/. Tous les mlservices paquets pour Python et R sont colocalisés avec le paquet du moteur de base de données. La version de base des mlservices packages est 9.4.6. Souvenez-vous que les packages microsoft-r-open se trouvent dans un autre référentiel.

Chemins RHEL/8

Package Emplacement de téléchargement
mssql / mlservices Paquets https://packages.microsoft.com/rhel/8/mssql-server-2019/
microsoft-r-open Paquets https://packages.microsoft.com/rhel/8/prod/

Chemins Ubuntu/20.04

Package Emplacement de téléchargement
mssql / mlservices Paquets https://packages.microsoft.com/ubuntu/20.04/mssql-server-2019/pool/main/m/
microsoft-r-open Paquets https://packages.microsoft.com/ubuntu/20.04/prod/pool/main/m/

Chemins d’accès SLES/12

Package Emplacement de téléchargement
mssql / mlservices Paquets https://packages.microsoft.com/sles/12/mssql-server-2019/
microsoft-r-open Paquets https://packages.microsoft.com/sles/12/prod/

Sélectionnez les extensions que vous souhaitez utiliser et téléchargez les packages nécessaires pour un langage spécifique. Les noms de fichiers incluent des informations sur la plateforme dans le suffixe.

Liste des packages

Selon les extensions que vous souhaitez utiliser, téléchargez les packages nécessaires pour un langage spécifique. Les noms de fichiers exacts incluent des informations de plateforme dans le suffixe, mais les noms de fichiers suivants doivent être suffisamment proches pour vous permettre de déterminer les fichiers à obtenir.

# Core packages
mssql-server-15.0.1000
mssql-server-extensibility-15.0.1000

# R
microsoft-openmpi-3.0.0
microsoft-r-open-mkl-3.5.2
microsoft-r-open-mro-3.5.2
mssql-mlservices-packages-r-9.4.7.64
mssql-mlservices-mlm-r-9.4.7.64

# Python
microsoft-openmpi-3.0.0
mssql-mlservices-python-9.4.7.64
mssql-mlservices-packages-py-9.4.7.64
mssql-mlservices-mlm-py-9.4.7.64

Contenu connexe

  • Last updated on