Obtenir des informations sur les packages R

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

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

Notes

Les fonctionnalités des caractéristiques et les options d’installation varient entre les versions de SQL Server. Utilisez la liste déroulante du sélecteur de version pour choisir la version appropriée de SQL Server.

Emplacement par défaut de la bibliothèque R

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. Sur Windows, la bibliothèque d’instances est un dossier sécurisé enregistré avec SQL Server.

Tout script qui s’exécute dans la base de données sur SQL Server doit 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 script R 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 R est le suivant :

C:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\R_SERVICES\library

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.

Exécutez l’instruction suivante pour déterminer la bibliothèque de packages R par défaut pour l’instance actuelle :

EXECUTE sp_execute_external_script  
  @language = N'R',
  @script = N'OutputDataSet <- data.frame(.libPaths());'
WITH RESULT SETS (([DefaultLibraryName] VARCHAR(MAX) NOT NULL));
GO

Mise à niveau des composants

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

Répertorier tous les packages R installés

L’exemple suivant utilise la fonction R installed.packages() dans une procédure stockée Transact-SQL pour afficher une liste des packages R qui ont été installés dans la bibliothèque R_SERVICES de l’instance SQL actuelle. Ce script renvoie les champs de nom et de version du package dans le fichier DESCRIPTION.

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

Pour plus d’informations sur les champs facultatifs et par défaut du champ DESCRIPTION du package R, consultez https://cran.r-project.org.

Rechercher un package R unique

Si vous avez installé un package R 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 charger le package et renvoyer des messages.

Par exemple, l’instruction suivante recherche et charge le packageglue, s’il est disponible. Si le package est introuvable ou ne peut pas être chargé, vous obtenez une erreur.

EXECUTE sp_execute_external_script  
  @language =N'R',
  @script=N'
require("glue")
'

Pour plus d’informations sur le package, voir packageDescription. L’instruction suivante renvoie des informations sur le package MicrosoftML.

EXECUTE sp_execute_external_script
  @language = N'R',
  @script = N'
print(packageDescription("MicrosoftML"))
'

Étapes suivantes

• Installer de nouveaux packages R avec sqlmlutils