Получение сведений о пакете R

Область применения: SQL Server 2016 (13.x) и более поздних версий Управляемый экземпляр SQL Azure

В этой статье описывается, как получить сведения об установленных пакетах R в службах машинного обучения в SQL Server и кластерах больших данных SQL Server 2019. Примеры сценариев R показывают, как получить сведения о пакете, например путь установки и версия.

Примечание.

Возможности компонентов и параметры установки зависят от версии SQL Server. Используйте селектор, чтобы выбрать соответствующую версию SQL Server.

Расположение библиотеки R по умолчанию

При установке машинного обучения с помощью SQL Server на уровне экземпляра создается отдельная библиотека пакетов для каждого устанавливаемого языка. В Windows библиотека экземпляров является защищенной папкой, зарегистрированной в SQL Server.

Все скрипты, выполняемые в базе данных на SQL Server, должны загружать функции из библиотеки экземпляров. SQL Server не может получить доступ к пакетам, установленным в других библиотеках. Это относится и к удаленным клиентам: любой скрипт R, выполняющийся в контексте вычислений сервера, может использовать только пакеты, установленные в библиотеке экземпляров. Для защиты серверных ресурсов библиотека экземпляров по умолчанию может быть изменена только администратором компьютера.

Путь по умолчанию к двоичным файлам для R:

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

Предполагается, что экземпляр SQL по умолчанию — MSSQLSERVER. Если SQL Server устанавливается как определяемый пользователем именованный экземпляр, вместо него используется указанное имя.

Выполните приведенную ниже инструкцию, чтобы проверить библиотеку по умолчанию для текущего экземпляра R:

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

Обновление компонентов

По умолчанию пакеты R обновляются с помощью пакетов обновления и накопительных пакетов обновления. Дополнительные пакеты и обновления полных версий основных компонентов R возможны только при обновлении продукта.

Просмотр всех установленных пакетов R

В приведенном ниже примере используется функция R installed.packages() в хранимой процедуре Transact-SQL, чтобы вывести список пакетов R, которые были установлены в библиотеке R_SERVICES для текущего экземпляра SQL. Этот скрипт возвращает поля имени и версии пакета в файле описания.

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

Дополнительные сведения о необязательных полях и полях по умолчанию для поля с описанием пакета R см. в разделе https://cran.r-project.org.

Поиск одного пакета R

Если вы установили пакет R и хотите убедиться, что он доступен для конкретного экземпляра SQL Server, можно выполнить хранимую процедуру для загрузки пакета и возврата сообщений.

Например, следующая инструкция ищет и загружает пакет glue, если он доступен. Если пакет не удается найти или загрузить, возникает ошибка.

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

Дополнительные сведения о пакете см. в разделе packageDescription. Приведенная ниже инструкция возвращает сведения о пакете MicrosoftML.

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

Следующие шаги

• Установка новых пакетов R с помощью sqlmlutils