Uzyskiwanie informacji o pakiecie R

Dotyczy: SQL Server 2016 (13.x) i nowsze wersje usługi Azure SQL Managed Instance

W tym artykule opisano sposób uzyskiwania informacji o zainstalowanych pakietach języka R w usługach Machine Learning Services w programie SQL Server i w klastrach danych big data programu SQL Server 2019. Przykładowe skrypty języka R pokazują, jak wyświetlić listę informacji o pakiecie, takich jak ścieżka instalacji i wersja.

Uwaga / Notatka

Możliwości funkcji i opcje instalacji różnią się w zależności od wersji programu SQL Server. Użyj listy rozwijanej selektora wersji, aby wybrać odpowiednią wersję programu SQL Server.

Domyślna lokalizacja biblioteki języka R

Podczas instalowania uczenia maszynowego za pomocą programu SQL Server zostanie utworzona pojedyncza biblioteka pakietów na poziomie wystąpienia dla każdego zainstalowanego języka. W systemie Windows biblioteka wystąpień jest zabezpieczonym folderem zarejestrowanym w programie SQL Server.

Wszystkie skrypty uruchamiane w bazie danych w programie SQL Server muszą ładować funkcje z biblioteki wystąpień. Program SQL Server nie może uzyskać dostępu do pakietów zainstalowanych w innych bibliotekach. Dotyczy to również klientów zdalnych: każdy skrypt R uruchamiany w kontekście obliczeniowym serwera może używać tylko pakietów zainstalowanych w bibliotece instancji. Aby chronić zasoby serwera, domyślna biblioteka wystąpień może być modyfikowana tylko przez administratora komputera.

Domyślna ścieżka plików binarnych języka R to:

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

Przyjęto założenie, że domyślne wystąpienie SQL to MSSQLSERVER. Jeśli program SQL Server jest zainstalowany jako wystąpienie nazwane zdefiniowane przez użytkownika, zamiast tego zostanie użyta dana nazwa.

Uruchom następującą instrukcję, aby zweryfikować domyślną bibliotekę pakietów języka R dla bieżącego wystąpienia:

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

Uaktualnienia składników

Domyślnie pakiety języka R są odświeżane za pomocą dodatków Service Pack i aktualizacji zbiorczych. Dodatkowe pakiety i pełne uaktualnienia wersji podstawowych składników języka R są możliwe tylko za pośrednictwem uaktualnień produktów.

Wyświetl listę wszystkich zainstalowanych pakietów języka R

W poniższym przykładzie użyto funkcji installed.packages() języka R w procedurze składowanej Transact-SQL, aby wyświetlić listę pakietów języka R zainstalowanych w bibliotece R_SERVICES dla bieżącego wystąpienia SQL. Ten skrypt zwraca pola nazwy pakietu i wersji w pliku 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) ))

Aby uzyskać więcej informacji na temat pól opcjonalnych i domyślnych dla pola OPIS pakietu języka R, zobacz https://cran.r-project.org.

Znajdowanie pojedynczego pakietu języka R

Jeśli zainstalowano pakiet języka R i chcesz upewnić się, że jest on dostępny dla określonego wystąpienia programu SQL Server, możesz wykonać procedurę składowaną w celu załadowania pakietu i zwracanych komunikatów.

Na przykład poniższa instrukcja wyszukuje i ładuje pakiet kleju , jeśli jest dostępny. Jeśli nie można znaleźć lub załadować pakietu, zostanie wyświetlony błąd.

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

Aby wyświetlić więcej informacji o pakiecie, wyświetl element packageDescription. Poniższa instrukcja zwraca informacje dotyczące pakietu MicrosoftML .

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

Dalsze kroki

• Instalowanie nowych pakietów języka R za pomocą narzędzia sqlmlutils