大网数据广告活动
数据库与应用安全

设置 SQL Server 上的 R 开发数据科学客户端

· 52CE 我爱测

远程连接到 SQL Server 的开发工作站上安装本地 R 库和工具。

适用对象:yesSQL Server(仅限 Windows)noAzure SQL 数据库 noAzure SQL 数据仓库 no并行数据仓库

R 集成是提供的 SQL Server 2016 或更高版本包括中的 R 语言选项时SQL Server 2016 R Services或SQL Server 2017 机器学习服务 (数据库内)安装。

若要创建和部署 SQL Server 上的 R 解决方案,安装Microsoft R Client若要获取RevoScaleR以及在开发工作站上的其他 R 库。 RevoScaleR 库,也是远程的 SQL Server 实例上,可协调计算这两个系统之间的请求。

在本文中,了解如何配置 R 客户端开发工作站,以便可以连接到远程 SQL Server 启用了机器学习和 R 集成。 完成这篇文章中的步骤后,将具有与 SQL Server 上的同一 R 库。 此外将了解如何将计算从本地 R 会话的远程 R 会话到推送 SQL Server 上。

客户端-服务器组件

可以使用内置RGUI工具在本文中所述或链接库到 RStudio 或任何你通常使用的另一个 IDE。

Tip: 这些练习的视频演示,请参阅运行 R 和 Python 在 Jupyter Notebook 从 SQL Server 中远程。

Note: 使用客户端库安装的替代方法独立服务器为丰富客户端,有些客户更喜欢更深层次的方案中工作。 从 SQL Server 完全分离的独立服务器,但因其具有相同的 R 库,你可以使用它作为客户端的 SQL Server 数据库内分析。 您还可以使用它为非 SQL 相关的工作,包括导入和从其他数据平台的数据建模功能。 如果安装在独立服务器,可以找到 R 可执行文件位于以下位置: C:\Program Files\Microsoft SQL Server\140\R_SERVER。 若要验证你的安装,打开 R 控制台应用运行在该位置使用 R.exe 命令。

常用工具

无论您是熟悉 SQL,R 开发人员或 SQL 开发人员首次使用 R 和数据库内分析,您将需要 R 开发工具和 T-SQL 查询编辑器等SQL Server Management Studio (SSMS)以实现所有数据库内分析功能。

对于简单的 R 开发方案,使用可执行文件,RGUI 捆绑在一起在 MRO 和 SQL Server 基础 R 发行版中。 此文章介绍了如何对本地和远程 R 会话使用 RGUI。 为提高工作效率,您应使用全功能型 IDE 如RStudio 或 Visual Studio。

SSMS 是单独的下载,适用于创建和上 SQL Server,包括那些包含 R 代码运行存储的过程。 在开发环境中编写的几乎任何 R 代码可以嵌入在存储过程。 您可以单步执行其他教程,了解如何SSMS 和嵌入的 R。

1-安装 R 包

Microsoft 的 R 包有多个产品和服务。 在本地工作站上,我们建议安装 Microsoft R 客户端。 R 客户端提供了RevoScaleR, MicrosoftML, SQLRUtils,和其他 R 包。

  1. 下载 Microsoft R 客户端。

  2. 在安装向导中,接受或更改默认安装路径、 接受或更改的组件列表,并接受 Microsoft R Client 许可条款。

完成安装后,一个欢迎屏幕,向您介绍的产品和文档。

在 R 客户端,R 处理上限为两个线程和内存中的数据。 对于使用多个内核和大型数据集的可缩放处理,你可以上移执行 (称为计算上下文) 到数据集和计算能力的远程 SQL Server 实例。 这是客户端集成与生产 SQL Server 实例的推荐的方法。

2-查找可执行文件

找到并列出要确认 R.exe、 RGUI 和其他包安装的安装文件夹的内容。

  1. 在文件资源管理器,打开 C:\Program Files\Microsoft\R Client\R_SERVER\bin 文件夹,以确认 R.exe 的位置。

  2. 打开 x64 子文件夹,用于确认RGUI。

  3. 打开 C:\Program Files\Microsoft\R Client\R_SERVER\library,若要查看使用 R 客户端,包括 RevoScaleR、 MicrosoftML,和其他安装的包的列表。

3-启动 RGUI

使用 SQL Server 安装 R,可以获取相同的 R 工具的标准到 R,例如 RGui 和 Rterm,等任何基本安装。 这些工具是轻量,可用于检查包和库的信息、 运行临时命令或脚本,或逐步执行教程。 这些工具可用于获取 R 版本信息,并确认连接。

  1. 打开 C:\Program Files\Microsoft\R Client\R_SERVER\bin\x64,然后双击RGui若要使用 R 命令提示符启动 R 会话。

从 Microsoft 程序文件夹中,多个包,包括 RevoScaleR,启动 R 会话时自动加载。

  1. 输入print(Revo.version)在命令提示符下,返回 RevoScaleR 包版本信息。 对于 RevoScaleR,应具有版本 9.2.1 或 9.3.0。

  2. 输入search () 在 R 提示符有关已安装的包的列表。

    版本信息时加载 R

4-获取 SQL 权限

若要连接到要运行脚本和上传数据的 SQL Server 实例,必须在数据库服务器上具有有效的登录名。 可以使用 SQL 登录凭据或集成 Windows 身份验证信息。 我们通常建议使用 Windows 集成身份验证,但使用 SQL 登录名是在某些情况下,更简单,尤其是在脚本中包含对外部数据连接字符串时。

最小值,用来运行代码的帐户必须具有你正在使用,加上特殊权限执行任意外部脚本从数据库中读取的权限。 大多数开发人员还需要权限才能创建存储的过程,并将数据写入到包含训练数据的表或评分的数据。

询问数据库管理员来配置你的帐户的以下权限,其中使用: 在数据库中

  • EXECUTE ANY EXTERNAL SCRIPT若要在服务器上运行 R 脚本。
  • db_datareader权限才能运行用于定型模型的查询。
  • db_datawriter编写定型数据或评分的数据。
  • db_owner以创建对象的存储过程,如表、 函数。 您还需要db_owner创建示例,并测试数据库。

如果你的代码需要与 SQL Server 的默认情况下不安装的程序包,排列与数据库管理员能够与实例安装的包。 SQL Server 是一个受保护的环境并在其中安装包的限制。 有关详细信息,请参阅SQL Server 上安装新的 R 包。

5-测试连接

作为验证步骤,使用RGUI和 RevoScaleR 以确认连接到远程服务器。 必须启用 SQL Server远程连接并且必须具有的权限,包括用户登录名和要连接到数据库。

下面的步骤假定演示数据库NYCTaxi_Sample,和 Windows 身份验证。

  1. 打开RGUI客户端工作站上。 例如,请转到~\Program Files\Microsoft SQL Server\140\R_SERVER\bin\x64,然后双击RGui.exe来启动它。

  2. RevoScaleR 会自动加载。 确认 RevoScaleR 可以正常运行的通过运行以下命令: print(Revo.version)

  3. 输入远程服务器执行的演示脚本。 必须修改下面的示例脚本,包括远程 SQL Server 实例的有效名称。 此会话开始作为本地会话,但rxSummary函数执行的远程 SQL Server 实例上。

# Define a connection. Replace server with a valid server name.
connStr <- "Driver=SQL Server;Server=<your-server-name>;Database=NYCTaxi_Sample;Trusted_Connection=true"

# Specify the input data in a SQL query.
sampleQuery <-"SELECT DISTINCT TOP(100) tip_amount FROM [dbo].nyctaxi_sample ORDER BY tip_amount DESC;"

# Define a remote compute context based on the remote server.
cc <-RxInSqlServer(connectionString=connStr)

# Execute the function using the remote compute context.
rxSummary(formula = ~ ., data = RxSqlServerData(sqlQuery=sampleQuery, connectionString=connStr), computeContext=cc)

结果:

此脚本连接到远程服务器上的数据库,提供查询、 创建计算上下文cc指令的远程执行代码,然后提供的 RevoScaleR 函数rxSummary返回统计查询结果的摘要。

  Call:
rxSummary(formula = ~., data = RxSqlServerData(sqlQuery = sampleQuery, 
    connectionString = connStr), computeContext = cc)

Summary Statistics Results for: ~.
Data: RxSqlServerData(sqlQuery = sampleQuery, connectionString = connStr) (RxSqlServerData Data Source)
Number of valid observations: 100 

Name       Mean   StdDev   Min Max ValidObs MissingObs
tip_amount 63.245 31.61087 36  180 100      0     
  1. 获取和设置计算上下文。 一旦设置计算上下文,它将保持有效的会话的持续时间。 如果不确定计算是本地还是远程,运行以下命令以找出。指定连接字符串的结果指示远程计算上下文。
# Return the current compute context.
rxGetComputeContext()

# Revert to a local compute context.
rxSetComputeContext("local")
rxGetComputeContext()

# Switch back to remote.
connStr <- "Driver=SQL Server;Server=<your-server-name>;Database=NYCTaxi_Sample;Trusted_Connection=true"
cc <-RxInSqlServer(connectionString=connStr)
rxSetComputeContext(cc)
rxGetComputeContext()
  1. 数据源,包括名称和类型中返回变量的信息。
rxGetVarInfo(data = inDataSource)

结果包含 23 变量。

  1. 生成散点图以了解是否有两个变量之间的依赖项。
# Set the connection string. Substitute a valid server name for the placeholder.
connStr <- "Driver=SQL Server;Server=<your database name>;Database=NYCTaxi_Sample;Trusted_Connection=true"

# Specify a query on the nyctaxi_sample table.
# For variables on each axis, remove nulls. Use a WHERE clause and <> to do this.
sampleQuery <-"SELECT DISTINCT TOP 100 * from [dbo].[nyctaxi_sample] WHERE fare_amount <> '' AND  tip_amount <> ''"
cc <-RxInSqlServer(connectionString=connStr)

# Generate a scatter plot.
rxLinePlot(fare_amount ~ tip_amount, data = RxSqlServerData(sqlQuery=sampleQuery, connectionString=connStr, computeContext=cc), type="p")

下面的屏幕截图显示了输入和散点图输出。

散点图中 RGUI

6-链接到 R.exe 工具

对于持续和严重开发项目,则应安装集成的开发环境 (IDE)。 SQL Server 工具和内置的 R 工具未配备繁重的 R 开发中。 工作代码后,可以将其部署为 SQL Server 上执行的存储过程。

你的 IDE 指向本地 R 库: 基本 R、 RevoScaleR,等等。 远程 SQL 服务器上运行的工作负荷执行脚本期间发生,当您的脚本调用访问数据和操作该服务器上的 SQL 服务器上的远程计算上下文。

RStudio

使用时RStudio,可以配置要使用的 R 库和对应于远程 SQL 服务器上的可执行文件的环境。

  1. 检查 SQL Server 上安装 R 包版本。 有关详细信息,请参阅获取 R 包信息。

  2. 安装 Microsoft R 客户端或独立服务器选项,以添加 RevoScaleR 和其他 R 包,包括 SQL Server 实例使用的基础 R 发行版之一。 选择在同一版本级别或更低 (包是向后兼容) 的服务器上提供相同的包版本。 有关版本信息,请参阅这篇文章中映射的版本:升级 R 和 Python 组件。

  3. 在 RStudio 中,更新 R 路径以指向提供 RevoScaleR、 Microsoft R Open,以及其他 Microsoft 包的 R 环境。

  • 对于 R 客户端安装,查找 C:\Program Files\Microsoft\R Client\R_SERVER\bin\x64
  • 对于独立服务器,查找 C:\Program Files\Microsoft SQL Server\140\R_SERVER\Library 或 C:\Program Files\Microsoft SQL Server\130\R_SERVER\Library
  1. 关闭,然后打开 RStudio。

当你重新打开 RStudio 时,R 可执行文件从 R 客户端 (或独立服务器) 是默认 R 引擎。

R Tools for Visual Studio (RTVS)

如果你还没有首选的 IDE 适用于 R,我们建议针对 Visual Studio 的 R 工具。

从 RTVS 连接到 SQL Server

此示例使用 Visual Studio 2017 Community Edition 已安装数据科学工作负载。

  1. 从文件菜单中,选择新建,然后选择项目。

  2. 在左侧窗格列出了预安装的模板。 单击R,然后选择R 项目。 在中名称框中,键入dbtest然后单击确定。

Visual Studio 将创建一个新的项目文件夹和默认脚本文件, Script.R。

  1. 类型.libPaths()脚本的第一行上文件,,然后按 CTRL + ENTER。

当前的 R 库路径应显示在R 交互窗口。

  1. 单击的 R 工具菜单,然后选择Windows若要查看其他特定于 R 的窗口都可以在你的工作区中显示的列表。
  • 通过按 CTRL + 3 查看当前存储库中的包上的帮助。
  • 请参阅中的 R 变量变量资源管理器,通过按 CTRL + 8。

后续步骤

两个不同教程包括练习,以便您可以练习切换到远程 SQL Server 实例从本地计算上下文。

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 HeidiSteen)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 11/12/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。