获取 R 包信息

适用于： SQL Server 2016 (13.x) 及更高版本 Azure SQL 托管实例

本文介绍如何获取在 SQL Server 机器学习服务和 SQL Server 2019 大数据群集上安装的 R 包的相关信息。 示例 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 包

以下示例在 Transact-SQL 存储过程中使用 R 函数 installed.packages() 来显示已安装在当前 SQL 实例的 R_SERVICES 库中的 R 包的列表。 该脚本在 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) ))

若要详细了解 R 包 DESCRIPTION 字段的可选字段和默认字段，请参阅 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"))
'

后续步骤

• 使用 sqlmlutils 安装新的 R 包