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

Применимо к:Applies to: даSQL Server 2016 (13.x);SQL Server 2016 (13.x)yesSQL Server 2016 (13.x);SQL Server 2016 (13.x) и более поздние версии ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed InstanceПрименимо к:Applies to: даSQL Server 2016 (13.x);SQL Server 2016 (13.x)yesSQL Server 2016 (13.x);SQL Server 2016 (13.x) and later ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance

В этой статье описывается, как получить сведения об установленных пакетах R в Службах машинного обучения в SQL Server и Кластерах больших данных.This article describes how to get information about installed R packages on Machine Learning Services on SQL Server and on Big Data Clusters. Примеры сценариев R показывают, как получить сведения о пакете, например путь установки и версия.Example R scripts show you how to list package information such as installation path and version.

В этой статье описывается, как получить сведения об установленных пакетах R в Службах машинного обучения SQL Server.This article describes how to get information about installed R packages on SQL Server Machine Learning Services. Примеры сценариев R показывают, как получить сведения о пакете, например путь установки и версия.Example R scripts show you how to list package information such as installation path and version.

В этой статье описывается, как получить сведения об установленных пакетах R в Службах машинного обучения Управляемого экземпляра SQL Azure.This article describes how to get information about installed R packages on Azure SQL Managed Instance Machine Learning Services. Примеры сценариев R показывают, как получить сведения о пакете, например путь установки и версия.Example R scripts show you how to list package information such as installation path and version.

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

При установке машинного обучения с помощью SQL Server на уровне экземпляра создается отдельная библиотека пакетов для каждого устанавливаемого языка.When you install machine learning with SQL Server, a single package library is created at the instance level for each language that you install. В Windows библиотека экземпляров является защищенной папкой, зарегистрированной в SQL Server.On Windows, the instance library is a secured folder registered with SQL Server.

Все скрипты, выполняемые в базе данных на SQL Server, должны загружать функции из библиотеки экземпляров.All script that runs in-database on SQL Server must load functions from the instance library. SQL Server не может получить доступ к пакетам, установленным в других библиотеках.SQL Server can't access packages installed to other libraries. Это относится и к удаленным клиентам: любой скрипт R, выполняющийся в контексте вычислений сервера, может использовать только пакеты, установленные в библиотеке экземпляров.This applies to remote clients as well: any R script running in the server compute context can only use packages installed in the instance library. Для защиты серверных ресурсов библиотека экземпляров по умолчанию может быть изменена только администратором компьютера.To protect server assets, the default instance library can be modified only by a computer administrator.

Путь по умолчанию к двоичным файлам для R:The default path of the binaries for R is:

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

Предполагается, что экземпляр SQL по умолчанию — MSSQLSERVER.This assumes the default SQL instance, MSSQLSERVER. Если SQL Server устанавливается как определяемый пользователем именованный экземпляр, вместо него используется указанное имя.If SQL Server is installed as a user-defined named instance, the given name is used instead.

Путь по умолчанию к двоичным файлам для R:The default path of the binaries for R is:

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

Предполагается, что экземпляр SQL по умолчанию — MSSQLSERVER.This assumes the default SQL instance, MSSQLSERVER. Если SQL Server устанавливается как определяемый пользователем именованный экземпляр, вместо него используется указанное имя.If SQL Server is installed as a user-defined named instance, the given name is used instead.

Путь по умолчанию к двоичным файлам для R:The default path of the binaries for R is:

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

Предполагается, что экземпляр SQL по умолчанию — MSSQLSERVER.This assumes the default SQL instance, MSSQLSERVER. Если SQL Server устанавливается как определяемый пользователем именованный экземпляр, вместо него используется указанное имя.If SQL Server is installed as a user-defined named instance, the given name is used instead.

Выполните приведенную ниже инструкцию, чтобы проверить библиотеку по умолчанию для текущего экземпляра R:Run the following statement to verify the default R package library for the current instance:

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 по умолчаниюDefault Microsoft R packages

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

ПакетыPackages ВерсияVersion ОписаниеDescription
RevoScaleRRevoScaleR 8.0.38.0.3 Используется для удаленных контекстов вычислений, потоковой передачи, параллельного выполнения функций rx для импорта и преобразования, моделирования, визуализации и анализа данных.Used for remote compute contexts, streaming, parallel execution of rx functions for data import and transformation, modeling, visualization, and analysis.
sqlrutilssqlrutils 1.0.01.0.0 Используется для включения скрипта R в хранимые процедуры.Used for including R script in stored procedures.

Приведенные ниже пакеты Microsoft R устанавливаются со Службами машинного обучения SQL Server, если во время установки был выбран компонент R.The following Microsoft R packages are installed with SQL Server Machine Learning Services when you select the R feature during setup.

ПакетыPackages ВерсияVersion ОписаниеDescription
RevoScaleRRevoScaleR 9.29.2 Используется для удаленных контекстов вычислений, потоковой передачи, параллельного выполнения функций rx для импорта и преобразования, моделирования, визуализации и анализа данных.Used for remote compute contexts, streaming, parallel execution of rx functions for data import and transformation, modeling, visualization, and analysis.
sqlrutilssqlrutils 1.0.01.0.0 Используется для включения скрипта R в хранимые процедуры.Used for including R script in stored procedures.
MicrosoftMLMicrosoftML 1.4.01.4.0 Добавляет алгоритмы машинного обучения в R.Adds machine learning algorithms in R.
olapRolapR 1.0.01.0.0 Используется для написания инструкций многомерных выражений в R.Used for writing MDX statements in R.

Приведенные ниже пакеты Microsoft R устанавливаются со Службами машинного обучения SQL Server, если во время установки был выбран компонент R.The following Microsoft R packages are installed with SQL Server Machine Learning Services when you select the R feature during setup.

ПакетыPackages ВерсияVersion ОписаниеDescription
RevoScaleRRevoScaleR 9.4.79.4.7 Используется для удаленных контекстов вычислений, потоковой передачи, параллельного выполнения функций rx для импорта и преобразования, моделирования, визуализации и анализа данных.Used for remote compute contexts, streaming, parallel execution of rx functions for data import and transformation, modeling, visualization, and analysis.
sqlrutilssqlrutils 1.0.01.0.0 Используется для включения скрипта R в хранимые процедуры.Used for including R script in stored procedures.
MicrosoftMLMicrosoftML 9.4.79.4.7 Добавляет алгоритмы машинного обучения в R.Adds machine learning algorithms in R.
olapRolapR 1.0.01.0.0 Используется для написания инструкций многомерных выражений в R.Used for writing MDX statements in R.

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

По умолчанию пакеты R обновляются с помощью пакетов обновления и накопительных пакетов обновления.By default, R packages are refreshed through service packs and cumulative updates. Дополнительные пакеты и обновление полных версий компонентов R можно применять только путем обновления продукта или привязки поддержки R к Microsoft Machine Learning Server.Additional packages and full version upgrades of core R components are possible only through product upgrades or by binding R support to Microsoft Machine Learning Server.

Кроме того, вы можете добавлять пакеты MicrosoftML и olapR в экземпляр SQL Server с помощью обновления компонента.In addition, you can add MicrosoftML and olapR packages to a SQL Server instance through a component upgrade.

Дополнительные сведения см. в разделе Обновление компонентов R и Python в SQL Server.For more information, see Upgrade R and Python components in SQL Server.

Пакеты R с открытым кодом по умолчаниюDefault open-source R packages

Поддержка R включает в себя версию с открытым кодом, позволяющую вызывать базовые функции R и устанавливать дополнительные пакеты с открытым кодом и пакеты сторонних производителей.R support includes open-source R so that you can call base R functions and install additional open-source and third-party packages. Поддержка языка R включает такие базовые функции, как base, stats, utils и другие.R language support includes core functionality such as base, stats, utils, and others. В базовую установку R также входят многочисленные образцы наборов данных и стандартные инструменты R, такие как RGui (упрощенный интерактивный редактор) и RTerm (командная строка R).A base installation of R also includes numerous sample datasets and standard R tools such as RGui (a lightweight interactive editor) and RTerm (an R command prompt).

Дистрибутив R с открытым исходным кодом, включенный в установку, — Microsoft R Open (MRO).The distribution of open-source R included in your installation is Microsoft R Open (MRO). MRO расширяет возможности базового R, включая дополнительные пакеты с открытым кодом, такие как Intel Math Kernel Library.MRO adds value to base R by including additional open-source packages such as the Intel Math Kernel Library.

Сведения о том, какая версия R устанавливается вместе с той или иной версией SQL Server, приведены в разделе Версии Python и R.For information on which version of R is included with each SQL Server version, see Python and R versions.

Важно!

Никогда не следует вручную перезаписывать версию R, установленную программой установки SQL Server, более новыми версиями в Интернете.You should never manually overwrite the version of R installed by SQL Server Setup with newer versions on the web. Пакеты Microsoft R основаны на конкретных версиях R. Изменение установки может привести к дестабилизации.Microsoft R packages are based on specific versions of R. Modifying your installation could destabilize it.

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

В приведенном ниже примере используется функция R installed.packages() в хранимой процедуре Transact-SQLTransact-SQL, чтобы вывести список пакетов, которые были установлены в библиотеке R_SERVICES для текущего экземпляра.The following example uses the R function installed.packages() in a Transact-SQLTransact-SQL stored procedure to display a list of R packages that have been installed in the R_SERVICES library for the current SQL instance. Этот скрипт возвращает поля имени и версии пакета в файле описания.This script returns package name and version fields in the DESCRIPTION file.

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.For more information about the optional and default fields for the R package DESCRIPTION field, see https://cran.r-project.org.

Поиск одного пакета RFind a single R package

Если вы установили пакет R и хотите убедиться, что он доступен для конкретного экземпляра SQL Server, можно выполнить хранимую процедуру для загрузки пакета и возврата сообщений.If you've installed an R package and want to make sure that it's available to a particular SQL Server instance, you can execute a stored procedure to load the package and return messages.

Например, следующая инструкция ищет и загружает пакет glue, если он доступен.For example, the following statement looks for and loads the glue package, if available. Если пакет не удается найти или загрузить, возникает ошибка.If the package cannot be located or loaded, you get an error.

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

Дополнительные сведения о пакете см. в разделе packageDescription.To see more information about the package, view the packageDescription. Приведенная ниже инструкция возвращает сведения о пакете MicrosoftML.The following statement returns information for the MicrosoftML package.

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

Дальнейшие действияNext steps