Поделиться через


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

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

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

Путь по умолчанию к двоичным файлам для 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

Пакеты Microsoft R по умолчанию

Приведенные ниже пакеты Microsoft R устанавливаются вместе с SQL Server R Services.

Пакеты Версия Description
RevoScaleR 8.0.3 Используется для удаленных контекстов вычислений, потоковой передачи, параллельного выполнения функций rx для импорта и преобразования, моделирования, визуализации и анализа данных.
sqlrutils 1.0.0 Используется для включения скрипта R в хранимые процедуры.

Пакеты Microsoft R по умолчанию

Приведенные ниже пакеты Microsoft R устанавливаются со Службами машинного обучения SQL Server, если во время установки был выбран компонент R.

Пакеты Версия Description
RevoScaleR 9,2 Используется для удаленных контекстов вычислений, потоковой передачи, параллельного выполнения функций rx для импорта и преобразования, моделирования, визуализации и анализа данных.
sqlrutils 1.0.0 Используется для включения скрипта R в хранимые процедуры.
MicrosoftML 1.4.0 Добавляет алгоритмы машинного обучения в R.
olapR 1.0.0 Используется для написания инструкций многомерных выражений в R.

Пакеты Microsoft R по умолчанию

Приведенные ниже пакеты Microsoft R устанавливаются со Службами машинного обучения SQL Server, если во время установки был выбран компонент R.

Пакеты Версия Description
RevoScaleR 9.4.7 Используется для удаленных контекстов вычислений, потоковой передачи, параллельного выполнения функций rx для импорта и преобразования, моделирования, визуализации и анализа данных.
sqlrutils 1.0.0 Используется для включения скрипта R в хранимые процедуры.
MicrosoftML 9.4.7 Добавляет алгоритмы машинного обучения в R.
olapR 1.0.0 Используется для написания инструкций многомерных выражений в R.

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

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

Кроме того, вы можете добавлять пакеты MicrosoftML и olapR в экземпляр SQL Server с помощью обновления компонента.

Пакеты R с открытым кодом по умолчанию

Поддержка R включает в себя версию с открытым кодом, позволяющую вызывать базовые функции R и устанавливать дополнительные пакеты с открытым кодом и пакеты сторонних производителей. Поддержка языка R включает такие базовые функции, как base, stats, utils и другие. В базовую установку R также входят многочисленные образцы наборов данных и стандартные инструменты R, такие как RGui (упрощенный интерактивный редактор) и RTerm (командная строка R).

Сведения о том, какая версия R устанавливается вместе с той или иной версией SQL Server, приведены в разделе Версии Python и R.

Внимание

Никогда не следует вручную перезаписывать версию R, установленную программой установки SQL Server, более новыми версиями в Интернете. Пакеты Microsoft 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"))
'

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