Ottenere informazioni sui pacchetti R

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

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

Nota

Le funzionalità e le opzioni di installazione variano a seconda della versione di SQL Server. Usare l'elenco a discesa del selettore di versione per scegliere la versione appropriata di SQL Server.

Percorso della libreria R predefinita

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

Qualsiasi script 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 script R 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 R è il seguente:

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

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.

Eseguire l'istruzione seguente per verificare la libreria di pacchetti R predefinita per l'istanza corrente:

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

Aggiornamenti dei componenti

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

Elenco di tutti i pacchetti R installati

Nell'esempio seguente viene utilizzata la funzione R installed.packages() in una stored procedure Transact-SQL per visualizzare un elenco di pacchetti R installati nella libreria R_SERVICES per l'istanza SQL corrente. Questo script restituisce i campi relativi al nome e alla versione del pacchetto nel file 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) ))

Per altre informazioni sui campi facoltativi e predefiniti per il file DESCRIPTION del pacchetto R, vedere https://cran.r-project.org.

Trovare un singolo pacchetto R

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

L'istruzione seguente, ad esempio, esegue la ricerca del pacchetto glue e lo carica, se disponibile. Se il pacchetto non viene trovato o non può essere caricato, viene restituito un errore.

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

Per altre informazioni sul pacchetto, vedere la funzione packageDescription. L'istruzione seguente restituisce informazioni per il pacchetto MicrosoftML.

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

Passaggi successivi

• Installare nuovi pacchetti R con sqlmlutils