Mettre à niveau le runtime Python et R avec la liaison dans SQL Server Machine Learning Services

Article
05/30/2023

S’applique à : SQL Server 2016 (13.x) SQL Server 2017 (14.x)

Important

La prise en charge de Machine Learning Server (précédemment appelée R Server) a pris fin le 1er juillet 2022. Pour plus d’informations, consultez Qu’en est-il de Machine Learning Server ?

Cet article explique comment utiliser le processus d’installation appelé liaison pour mettre à niveau les runtimes R ou Python dans SQL Server 2016 R Services ou SQL Server 2017 Machine Learning Services. Vous pouvez vous procurer des versions plus récentes de Python et R via une liaison à Microsoft Machine Learning Server.

Important

Cet article décrit une ancienne méthode de mise à niveau des runtimes R et Python appelée liaison. Si vous avez installé la Mise à jour cumulative (CU) 14 ou une version ultérieure pour SQL Server 2016 Service Pack (SP) 2 ou la Mise à jour cumulative 22 ou une version ultérieure pour SQL Server 2017, découvrez comment changer le runtime R ou Python par défaut vers une version plus récente à la place.

Qu’est-ce qu’une liaison ?

La liaison est un processus d’installation qui remplace le contenu de vos dossiers R_SERVICES et PYTHON_SERVICES par des fichiers exécutables, des bibliothèques et des outils plus récents de Microsoft Machine Learning Server.

Les composants chargés inclus dans le modèle de maintenance ont été modifiés. Les mises à jour du service correspondent à la chronologie de la prise en charge pour Microsoft R Server & Machine Learning Server sur le cycle de vie moderne.

À l’exception des versions de composant et des mises à jour de service, la liaison ne modifie pas les bases de votre installation :

L’intégration de Python et de R fait toujours partie d’une instance du moteur de base de données.
La gestion des licences est inchangée (aucun coût supplémentaire n’est associé à la liaison).
Les stratégies de prise en charge de SQL Server sont toujours valables pour le moteur de base de données.

Le reste de cet article décrit le mécanisme de liaison et son fonctionnement pour chaque version de SQL Server.

Notes

La liaison s’applique uniquement aux instances dans la base de données qui sont liées à des instances SQL Server. Dans ce cas, la liaison n’est pas nécessaire pour une installation autonome.

Considérations relatives à la liaison SQL Server 2016

Pour les clients SQL Server R 2016 R Services, la liaison fournit les éléments suivants :

Packages R mis à niveau.
Les nouveaux packages ne font pas partie de l’installation d’origine (MicrosoftML)
Modèles de Machine Learning préformés pour l’analyse des sentiments et la détection d’images.

Toutes les liaisons peuvent être actualisées à chaque nouvelle version majeure et mineure de Microsoft Machine Learning Server.

Mappage de version

Les tables suivantes sont des mappages de version. Chaque mappage affiche les versions des packages entre les versions. Vous pouvez passer en revue les chemins de mise à niveau lorsque vous effectuez une liaison à Microsoft Machine Learning Server (anciennement R Server, avant l’ajout de la prise en charge de Python à compter de Machine Learning Server 9.2.1).

La liaison ne garantit pas de disposer de la dernière version de R ou d’Anaconda. Lorsque vous établissez une liaison à Microsoft Machine Learning Server, vous disposez de la version R ou Python installée via le programme d’installation. Il peut donc s’agir d’une version différente de la dernière version disponible sur le Web.

SQL Server 2016 R Services

Composant	Version initiale	R Server 9.0.1	R Server 9.1	Machine Learning Server 9.2.1	Machine Learning Server 9.3	Machine Learning Server 9.4.7
Microsoft R Open (MRO) sur R	R 3.2.2	R 3.3.2	R 3.3.3	R 3.4.1	R 3.4.3	R 3.5.2
RevoScaleR	8.0.3	9.0.1	9,1	9.2.1	9.3	9.4.7
MicrosoftML	n.a.	9.0.1	9,1	9.2.1	9.3	9.4.7
modèles pré-entraînés	n.a.	9.0.1	9,1	9.2.1	9.3	9.4.7
sqlrutils	n.a.	1.0	1.0	1.0	1.0	1.0
olapR	n.a.	1.0	1.0	1.0	1.0	1.0

SQL Server 2017 Machine Learning Services

Composant	Version initiale	Machine Learning Server 9.3	Machine Learning Server 9.4.7
Microsoft R Open (MRO) sur R	R 3.3.3	R 3.4.3	R 3.5.2
RevoScaleR	9.2	9.3	9.4.7
MicrosoftML	9.2	9.3	9.4.7
sqlrutils	1.0	1.0	1.0
olapR	1.0	1.0	1.0
Anaconda 4.2 sur Python 3.5	4.2/3.5.2	4.2/3.5.2
revoscalepy	9.2	9.3	9.4.7
microsoftml	9.2	9.3	9.4.7
modèles pré-entraînés	9.2	9.3	9.4.7

Fonctionnement de la mise à niveau des composants

Les fichiers exécutables, les bibliothèques Python et R sont mis à niveau lorsque vous liez une installation existante de Python et R à Machine Learning Server.

La liaison est exécutée par le programme d’installation Microsoft Machine Learning Server lorsque vous l’exécutez sur une instance de moteur de base de données SQL Server existante disposant de l’intégration Python ou R.

Le programme d’installation détecte les fonctionnalités existantes et vous invite à effectuer une nouvelle liaison avec Machine Learning Server.

Au cours de la liaison, le contenu de C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES et \PYTHON_SERVICES est remplacé par les nouveaux fichiers exécutables et les nouvelles bibliothèques de C:\Program Files\Microsoft\ML Server\R_SERVER et de \PYTHON_SERVER.

La liaison s’applique uniquement aux fonctionnalités Python et R. Les packages open source pour Python et R sont constitués des éléments suivants :

Anaconda
Microsoft R Open
Packages propriétaires RevoScaleR
Revoscalepy

La liaison ne modifie pas le modèle de prise en charge pour l’instance du moteur de base de données, ni la version de SQL Server.

La liaison est réversible. Vous pouvez rétablir la maintenance SQL Server en dissociant l’instance et en réparant votre instance de moteur de base de données SQL Server.

Liaison à Machine Learning Server à l’aide du programme d’installation

Suivez les étapes permettant de lier SQL Server à Microsoft Machine Learning Server à l’aide du programme d’installation.

Dans SSMS, exécutez SELECT @@version pour vérifier que le serveur répond aux conditions minimales requises pour la build.

Pour SQL Server 2016 R Services, vous devez disposez au minimum du Service Pack 1 et de la mise à jour cumulative CU3.

Vérifiez la version des packages R Base et RevoScaleR pour vous assurer que les versions existantes sont inférieures à celles par lesquelles vous envisagez de les remplacer.

EXECUTE sp_execute_external_script
@language=N'R'
,@script = N'str(OutputDataSet);
packagematrix <- installed.packages();
Name <- packagematrix[,1];
Version <- packagematrix[,3];
OutputDataSet <- data.frame(Name, Version);'
, @input_data_1 = N''
WITH RESULT SETS ((PackageName nvarchar(250), PackageVersion nvarchar(max) ))

Fermez SSMS et tous les autres outils disposant d’une connexion ouverte à SQL Server. La liaison remplace les fichiers programme. Si des sessions SQL Server sont ouvertes, la liaison échoue avec le code d’erreur de liaison 6.
Téléchargez Microsoft Machine Learning Server sur l’ordinateur hébergeant l’instance que vous souhaitez mettre à niveau. Nous vous recommandons de télécharger la version la plus récente.
Décompressez le dossier et lancez ServerSetup.exe, sous MLSWIN93.
Sur l’écran Configurer l’installation, confirmez les composants à mettre à niveau et passez en revue la liste des instances compatibles.
Sur la page Contrat de licence, sélectionnez J’accepte ces termes pour accepter les termes du contrat de licence de Machine Learning Server.
Sur les pages suivantes, donnez votre accord pour les conditions de licence supplémentaires de tous les composants open source que vous avez sélectionnés, tels que Microsoft R Open ou la distribution Python Anaconda.
Sur la page Vous y êtes presque, prenez note du dossier d’installation. Le dossier par défaut est : \Program Files\Microsoft\ML Server.

Si vous voulez changer le dossier d’installation, sélectionnez Avancé pour revenir à la première page de l’Assistant. Toutefois, vous devez dans ce cas répéter toutes les sélections précédentes.

Si la mise à niveau échoue, consultez les codes d’erreur SqlBindR pour plus d’informations.

Liaison hors connexion (pas d’accès Internet)

Pour les systèmes qui ne sont pas connectés à Internet, vous pouvez télécharger le programme d’installation et les fichiers .cab sur un ordinateur connecté à Internet, puis transférer ces fichiers vers le serveur isolé.

Le programme d’installation (ServerSetup.exe) inclut les packages Microsoft (RevoScaleR, MicrosoftML, olapr, sqlRUtils). Les fichiers .cab fournissent les autres composants de base. Par exemple, le fichier .cab « SRO » fournit R Open, la distribution Microsoft de R open source.

Les instructions suivantes expliquent comment placer les fichiers pour une installation hors connexion.

Téléchargez le programme d’installation MLSWIN93. Il est téléchargé en tant que fichier zip unique. Nous vous recommandons d’utiliser la dernière version, mais vous pouvez également installer les versions antérieures.
Téléchargez les fichiers .cab. Les liens suivants concernent la version 9.3. Si vous avez besoin des versions antérieures, vous trouverez des liens supplémentaires dans R Server 9.1. Rappelez-vous que Python/Anaconda peut uniquement être ajouté à une instance Machine Learning Services SQL Server. Des modèles pré-entraînés existent pour Python et R. Le fichier .cab fournit des modèles dans les langages que vous utilisez.

Fonctionnalité Téléchargement

R SRO_3.4.3.0_1033.cab

Python SPO_9.3.0.0_1033.cab

Modèles dont l’apprentissage a déjà été effectué MLM_9.3.0.0_1033.cab
Transférez les fichiers .zip et .cab vers le serveur cible.
Sur le serveur, tapez %temp% dans la commande Exécuter pour récupérer l’emplacement physique du répertoire temporaire. Le chemin physique varie en fonction de l’ordinateur, mais il s’agit généralement de C:\Users\<your-user-name>\AppData\Local\Temp.
Placez les fichiers .cab dans le dossier %temp%.
Décompressez le programme d’installation.
Exécutez le fichier ServerSetup.exe et suivez les invites à l’écran pour terminer l’installation.

Fonctionnalité	Téléchargement
R	SRO_3.4.3.0_1033.cab
Python	SPO_9.3.0.0_1033.cab
Modèles dont l’apprentissage a déjà été effectué	MLM_9.3.0.0_1033.cab

Opérations de ligne de commande

Conseil

Vous ne trouvez pas SqlBindR ? Vous n’avez probablement pas exécuté le programme d’installation. SqlBindR est disponible uniquement après l’exécution du programme d’installation de Machine Learning Server.

Ouvrez une invite de commandes en tant qu’administrateur et accédez au dossier contenant sqlbindr.exe. L’emplacement par défaut est : C:\Program Files\Microsoft\MLServer\Setup.
Tapez la commande suivante pour afficher la liste des instances disponibles : SqlBindR.exe /list

Notez le nom complet de l’instance tel qu’il est répertorié. Par exemple, le nom de l’instance peut être MSSQL14.MSSQLSERVER pour une instance par défaut, ou un nom de type NOMSERVEUR.MONINSTANCENOMMÉE.
Exécutez la commande SqlBindR.exe avec l’argument /bind. Spécifiez le nom de l’instance à mettre à niveau en utilisant le nom de l’instance tel qu’il est renvoyé à l’étape précédente.

Par exemple, pour mettre à niveau l’instance par défaut, tapez :SqlBindR.exe /bind MSSQL14.MSSQLSERVER
Une fois la mise à niveau terminée, redémarrez le service Launchpad associé à l’instance qui a été modifiée.

Rétablir ou annuler la liaison d’une instance

Vous pouvez restaurer une instance liée vers une installation initiale des composants Python et R, établie par le programme d’installation de SQL Server. Pour revenir à la maintenance SQL Server, vous devez suivre trois étapes.

Étape 1 : Annuler la liaison à Microsoft Machine Learning Server
Étape 2 : Restaurer l’état d’origine de l’instance
Étape 3 : Réinstaller tous les packages que vous aviez ajoutés à l’installation

Étape 1 : Annuler la liaison

Vous avez deux options pour restaurer la liaison : réexécuter la configuration ou utiliser l’utilitaire de ligne de commande SqlBindR.

Annulation de la liaison à l’aide du programme d’installation

Localisez le programme d’installation de Machine Learning Server. Si vous avez supprimé le programme d’installation, vous devrez peut-être le télécharger de nouveau ou le copier à partir d’un autre ordinateur.
Assurez-vous d’exécuter le programme d’installation sur l’ordinateur hébergeant l’instance que vous souhaitez séparer.
Le programme d’installation identifie les instances locales qui sont candidates pour l’annulation de la liaison.
Décochez la case en regard de l’instance pour laquelle vous souhaitez restaurer la configuration d’origine.
Acceptez tous les contrats de licence.
Sélectionnez Terminer. Le processus prend un certain temps.

Annulation de la liaison à l’aide de la ligne de commande

Ouvrez une invite de commandes et accédez au dossier qui contient sqlbindr.exe, comme décrit dans la section précédente.
Exécutez la commande SqlBindR.exe avec l’argument /unbind, puis spécifiez l’instance.

Par exemple, la commande suivante rétablit l’instance par défaut :

SqlBindR.exe /unbind MSSQL14.MSSQLSERVER

Étape 2 : Réparer l’instance SQL Server

Exécutez le programme d’installation de SQL Server pour réparer l’instance du moteur de base de données qui héberge les fonctionnalités Python et R. Les mises à jour préexistantes sont conservées. L’étape suivante s’applique si une mise à jour a été manquée pour les mises à jour de maintenance des packages Python et R.

Autre solution : Désinstallez et réinstallez complètement l’instance du moteur de base de données, puis appliquez toutes les mises à jour du service.

Étape 3 : Ajouter des packages tiers

Vous aviez peut-être ajouté d’autres packages tiers ou open source à votre bibliothèque de packages. Étant donné que l’inversion de la liaison modifie l’emplacement de la bibliothèque de packages par défaut, vous devez réinstaller les packages dans la bibliothèque que Python et R utilisent désormais. Pour plus d’informations, consultez les informations sur les packages R et leur installation, ainsi que les informations sur les packages Python et leur installation.

Syntaxe de commande SqlBindR.exe

Usage

sqlbindr [/list] [/bind <SQL_instance_ID>] [/unbind <SQL_instance_ID>]

Paramètres

Nom	Description
list	Affiche la liste complète des ID d’instances SQL Server de l’ordinateur actuel
bind	Met à niveau l’instance SQL Server spécifiée vers la dernière version de R Server et fait en sorte qu’elle reçoive automatiquement les mises à niveau ultérieures de R Server
unbind	Désinstalle la dernière version de R Server de l’instance SQL Server spécifiée et empêche les mises à niveau ultérieures de R Server de s’appliquer à l’instance

Erreurs de liaison

Le programme d’installation de Machine Learning Server et SqlBindR renvoient les codes d’erreur et messages suivants.

Code d'erreur	Message	Détails
Erreur de liaison 0	Ok (succès)	La liaison a réussi sans erreur.
Erreur de liaison 1	Arguments non valides	Erreur de syntaxe.
Erreur de liaison 2	Action non valide	Erreur de syntaxe.
Erreur de liaison 3	Instance non valide	Il existe une instance, mais elle n’est pas valide pour la liaison.
Erreur de liaison 4	Ne peut pas être lié
Erreur de liaison 5	Déjà lié	Vous avez exécuté la commande bind , mais l’instance spécifiée est déjà liée.
Erreur de liaison 6	Échec de la liaison	Une erreur est survenue lors de l’annulation de la liaison de l’instance. Cette erreur peut se produire si vous exécutez le programme d’installation de Machine Learning Server sans sélectionner de fonctionnalités. Pour la liaison, vous devez sélectionner à la fois une instance MSSQL et Python et R, en supposant que l’instance soit SQL Server 2017. Cette erreur se produit également si SqlBindR n’a pas pu écrire dans le dossier Program Files. Les sessions ouvertes ou les descripteurs vers SQL Server provoquent cette erreur. Si vous voyez cette erreur, redémarrez l’ordinateur et recommencez les étapes de liaison avant de démarrer de nouvelles sessions.
Erreur de liaison 7	Non lié	L’instance du moteur de base de données héberge R Services ou SQL Server Machine Learning Services. L’instance n’est pas liée à Microsoft Machine Learning Server.
Erreur de liaison 8	Échec de l’annulation de la liaison	Une erreur est survenue lors de l’annulation de la liaison de l’instance.
Erreur de liaison 9	Aucune instance trouvée	Aucune instance du moteur de base de données n’a été trouvée sur cet ordinateur.

Problèmes connus

Cette section répertorie les problèmes connus spécifiques à l’utilisation de l’utilitaire SqlBindR.exe, ou aux mises à niveau de Machine Learning Server susceptibles d’affecter des instances SQL Server.

Restauration des packages précédemment installés

SqlBindR.exe ne parvient pas à restaurer les packages d’origine ou les composants R avec la mise à niveau vers Microsoft R Server 9.0.1. Utilisez l’option de réparation sur l’instance SQL Server et appliquez toutes les versions de service. Redémarrez l’instance.

La version ultérieure de SqlBindR restaure automatiquement les fonctionnalités R d’origine, ce qui évite d’avoir à réinstaller les composants R ou à réappliquer les correctifs au serveur. Toutefois, vous devez installer toutes les mises à jour du package R qui ont pu être ajoutées après l’installation initiale.

Utilisez les commandes R pour synchroniser les packages installés avec le système de fichiers à l’aide d’enregistrements de la base de données. Pour plus d’informations, consultez Gestion des packages R pour SQL Server.

Problèmes liés au fichier sqlbinr.ini remplacé dans SQL Server

Scénario : Ce problème se produit lors de la liaison de Machine Learning Server 9.4.7 à SQL Server 2017. Quand Python est mis à jour et lié ou quand vous effectuez une mise à jour vers une nouvelle mise à jour cumulative, il ne comprend pas que Python est lié et remplace les fichiers. Il n’existe pas de problème connu avec R.

Pour contourner ce problème, créez un fichier sqlbindr.ini dans le répertoire PYTHON_SERVICES qui n’est pas vide. Le contenu n’a pas d’impact sur le fonctionnement du fichier.

Créez un fichier sqlbindr.ini contenant 9.4.7.82, puis enregistrez-le à cet emplacement :

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

Problèmes avec les mises à niveau multiples à partir de SQL Server

Scénario : Instance précédemment mise à niveau de SQL Server 2016 R services vers la version 9.0.1. Le nouveau programme d’installation a été exécuté pour Microsoft R Server 9.1.0. Le programme d’installation affiche une liste de toutes les instances valides. Par défaut, le programme d’installation sélectionne les instances liées précédemment. Si vous continuez, la liaison des instances précédemment liées est annulée. La version 9.0.1 antérieure est désinstallée, y compris tous les packages associés, mais la nouvelle version de Microsoft R Server (9.1.0) n’est pas installée.

Pour résoudre ce problème, vous pouvez modifier l’installation R Server existante comme suit :

Dans le Panneau de configuration, ouvrez Ajout/Suppression de programmes.
Recherchez Microsoft R Server, puis sélectionnez Modifier.
Au démarrage du programme d’installation, sélectionnez les instances que vous souhaitez lier à la version 9.1.0.

Microsoft Machine Learning Server 9.2.1 et 9.3 ne présentent pas ce problème.

La liaison ou l’annulation d’une liaison laisse plusieurs dossiers temporaires

Supprimez les dossiers temporaires une fois l’installation terminée.