收集数据以对 SQL Server 机器学习服务的 Python 和 R 脚本进行故障排除

项目
05/30/2023

适用于： SQL Server 2016 (13.x) 及更高版本

重要

2022 年 7 月 1 日终止对 Machine Learning Server（以前称为 R Server）的支持。有关详细信息，请参阅 Machine Learning Server 将发生什么情况？

本文介绍了在尝试解决 SQL Server 机器学习服务中的问题时，如何收集所需的数据。无论你是要自行解决解决问题还是在 Microsoft 客户支持的帮助下解决问题，此数据都很有用。

SQL Server 版本

SQL Server 2016 R Services 是第一个包含集成 R 支持的 SQL Server 版本。 SQL Server 2016 Service Pack 1 (SP1) 包括多项重大改进，包括运行外部脚本的能力。如果使用的是 SQL Server 2016，应考虑安装 SP1 或更高版本。

SQL Server 2017 及更高版本具有 Python 语言集成。无法在早期版本中获取 Python 功能集成。

根据使用的 SQL Server 版本，某些机器学习功能可能不可用或受到限制。

R 语言和工具版本

通常，选择 R Services 功能或机器学习服务功能时安装的 Microsoft R 版本由 SQL Server 内部版本号决定。如果升级或修补 SQL Server，则还必须升级或修补其 R 组件。

有关版本和 R 组件下载链接的列表，请参阅在无 Internet 访问的情况下安装机器学习组件。在具有 Internet 访问的计算机上，会自动标识和安装所需的 R 版本。

在一个称为绑定的过程中，可以独立于 SQL Server 数据库引擎来升级 R Server 组件。因此，在 SQL Server 中运行 R 代码时使用的 R 版本可能会有所不同，这取决于安装的 SQL Server 版本以及是否已将服务器迁移到最新的 R 版本。

确定 R 版本

确定 R 版本的最简单方法是通过运行如下语句以获取运行时属性：

EXECUTE sp_execute_external_script
       @language = N'R'
       , @script = N'
# Transform R version properties to data.frame
OutputDataSet <- data.frame(
  property_name = c("R.version", "Revo.version"),
  property_value = c(R.Version()$version.string, Revo.version$version.string),
  stringsAsFactors = FALSE)
# Retrieve properties like R.home, libPath & default packages
OutputDataSet <- rbind(OutputDataSet, data.frame(
  property_name = c("R.home", "libPaths", "defaultPackages"),
  property_value = c(R.home(), .libPaths(), paste(getOption("defaultPackages"), collapse=", ")),
  stringsAsFactors = FALSE)
)
'
WITH RESULT SETS ((PropertyName nvarchar(100), PropertyValue nvarchar(4000)));

提示

如果 R Services 未工作，请尝试只运行 RGui 中的 R 脚本部分。

万不得已的情况下，可打开服务器上的文件以确定安装的版本。为此，请找到 rlauncher.config 文件，获取 R 运行时和当前工作目录的位置。建议创建并打开该文件的副本，以免意外更改任何属性。

SQL Server 2016

C:\Program Files\Microsoft SQL Server\MSSQL13.<instance_name\MSSQL\Binn\rlauncher.config
SQL Server 2017

C:\Program Files\Microsoft SQL Server\MSSQL14.<instance_name>\MSSQL\Binn\rlauncher.config

若要获取 R 版本和 RevoScaleR 版本，请打开 R 命令提示符，或打开与实例关联的 RGui。

SQL Server 2016

C:\Program Files\Microsoft SQL Server\MSSQL13.<instancename>\R_SERVICES\bin\x64\RGui.exe
SQL Server 2017

C:\Program Files\Microsoft SQL Server\MSSQL14.<instance_name>\R_SERVICES\bin\x64\RGui.exe

R 控制台在启动时显示版本信息。例如，以下版本表示 SQL Server 2017 的默认配置：

*Microsoft R Open 3.3.3*

*The enhanced R distribution from Microsoft*

*Microsoft packages Copyright (C) 2017 Microsoft*

*Loading Microsoft R Server packages, version 9.1.0.*

Python 版本

可通过多种方法获取 Python 版本。最简单的方法是从 Management Studio 或任何其他 SQL 查询工具运行此语句：

-- Get Python runtime properties:
exec sp_execute_external_script
       @language = N'Python'
       , @script = N'
import sys
import pkg_resources
OutputDataSet = pandas.DataFrame(
                    {"property_name": ["Python.home", "Python.version", "Revo.version", "libpaths"],
                    "property_value": [sys.executable[:-10], sys.version, pkg_resources.get_distribution("revoscalepy").version, str(sys.path)]}
)
'
with WITH RESULT SETS (SQL keywords) ((PropertyName nvarchar(100), PropertyValue nvarchar(4000)));

如果机器学习服务未运行，则可以通过查看 pythonlauncher.config 文件来确定安装的 Python 版本。建议创建并打开该文件的副本，以免意外更改任何属性。

仅适用 SQL Server 2017：C:\Program Files\Microsoft SQL Server\MSSQL14.<instance_name>\MSSQL\Log\ExtensibilityLog\pythonlauncher.config
获取 PYTHONHOME 的值。
获取当前工作目录的值。

注意

如果已在 SQL Server 2017 中安装了 Python 和 R，则 R 和 Python 语言共享工作目录和工作帐户池。

是否安装了多个 R 或 Python 实例？

检查计算机上是否安装了 R 库的多个副本。如果出现以下情况，则可能会出现此重复：

在安装过程中，选择了 R Services（数据库内）和 R Server（独立）。
除了 SQL Server 之外，还安装了 Microsoft R Client。
使用针对 Visual Studio 的 R 工具、R Studio、Microsoft R Client 或其他 R IDE安装了一组不同的 R 库。
计算机承载 SQL Server 的多个实例，且不止一个实例使用机器学习。

同样的条件也适用于 Python。

如果发现安装了多个库或运行时，请确保只收到与 SQL Server 实例使用的 Python 或 R 运行时相关联的错误。

错误源

尝试运行 R 代码时显示的错误可能来自以下任何源：

SQL Server 数据库引擎，包括存储过程 sp_execute_external_script
SQL Server Trusted Launchpad
扩展性框架的其他组件，包括 R 和 Python 启动器以及附属进程
提供程序，比如 Microsoft 开放式数据库连接 (ODBC)
R 语言

第一次使用该服务时，可能很难判断哪些消息来自哪些服务。建议不仅要捕获准确的消息文本，还要捕获出现消息的上下文。请注意用于运行机器学习代码的客户端软件：

是否使用的是 Management Studio？还是外部应用程序？
是否在远程客户端运行 R 代码？还是直接在存储过程中运行 R 代码？

SQL Server 日志文件

获取最新的 SQL Server 错误日志。一组完整的错误日志包含以下默认日志目录中的文件：

SQL Server 2016

C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\Log\ExtensibilityLog
SQL Server 2017

C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2016\MSSQL\Log\ExtensibilityLog

注意

确切的文件夹名称因实例名称而异。

由 sp_execute_external_script 返回的错误

获取运行 sp_execute_external_script 命令时返回的错误的完整文本（如果有）。

为了不再考虑 R 或 Python 问题，可以运行此脚本，该脚本将启动 R 或 Python 运行时并来回传递数据。

对于 R

exec sp_execute_external_script @language =N'R',  
@script=N'OutputDataSet<-InputDataSet',  
@input_data_1 =N'select 1 as hello'  
with result sets (([hello] int not null));  
go

对于 Python

exec sp_execute_external_script @language =N'Python',  
@script=N'OutputDataSet= InputDataSet',  
@input_data_1 =N'select 1 as hello'  
with result sets (([hello] int not null));  
go

扩展性框架生成的错误

SQL Server 为外部脚本语言运行时生成单独的日志。这些错误不是由 Python 或 R 语言生成的。它们是从 SQL Server 中的扩展性组件（包括特定于语言的启动器及其附属进程）生成的。

可以从以下默认位置获取这些日志：

SQL Server 2016

C:\Program Files\Microsoft SQL Server\MSSQL13.<instance_name>\MSSQL\Log\ExtensibilityLog
SQL Server 2017

C:\Program Files\Microsoft SQL Server\MSSQL14.<instance_name>\MSSQL\Log\ExtensibilityLog

注意

确切的文件夹名称因实例名称而异。根据配置，文件夹可能位于不同的驱动器上。

例如，以下日志消息与扩展性框架相关：

LogonUser 失败 (用户 MSSQLSERVER01)

这可能表示运行外部脚本的工作帐户无法访问实例。
InitializePhysicalUsersPool 失败

此消息可能表示安全设置阻止安装程序创建运行外部脚本所需的工作帐户池。
安全性上下文管理器初始化失败
附属会话管理器初始化失败

系统事件

打开 Windows 事件查看器，并在“系统事件”日志中搜索包含字符串“Launchpad”的消息。
打开 ExtLaunchErrorlog 文件，并查找字符串“ErrorCode” 。查看与 ErrorCode 关联的消息。

例如，以下消息是与 SQL Server 扩展性框架相关的常见系统错误：

由于以下错误，SQL Server Launchpad (MSSQLSERVER) 服务启动失败：<文本>
该服务未及时响应启动请求或控制请求。
在等待 SQL Server Launchpad (MSSQLSERVER) 服务连接时超时 (120000 毫秒) 。

转储文件

如果熟悉调试，则可以使用转储文件来分析 Launchpad 中的失败。

找到包含 SQL Server 的安装程序启动日志的文件夹。比如，在 SQL Server 2016 中，默认路径是：C:\Program Files\Microsoft SQL Server\130\Setup Bootstrap\Log。
打开特定于扩展性的启动日志子文件夹。
如果需要提交支持请求，请将此文件夹的全部内容添加到压缩文件中。比如：C:\Program Files\Microsoft SQL Server\130\Setup Bootstrap\Log\LOG\ExtensibilityLog。

确切位置在不同系统上可能会有所不同，并且可能位于 C 驱动器以外的驱动器。确保获取安装机器学习的实例的日志。

配置设置

本部分列出了运行 R 或 Python 脚本时可能会导致错误的其他组件或提供程序。

哪些网络协议可用？

机器学习服务需要以下网络协议来实现扩展性组件之间的内部通信，以及与外部 R 或 Python 客户端的通信。

Named pipes
TCP/IP

打开 SQL Server 配置管理器，确定是否安装了协议。如果已安装，则确定是否已启用协议。

安全配置和权限

对于工作帐户：

在控制面板中，打开“用户和组”，并找到用于运行外部脚本作业的组。默认情况下，组是 SQLRUserGroup 。
验证该组是否存在并且是否包含至少一个工作帐户。
在 SQL Server Management Studio 中，选择将运行 R 或 Python 作业的实例，选择“安全性”，然后确定是否存在 SQLRUserGroup 登录。
查看用户组的权限。

对于单独的用户帐户：

确定实例是支持混合模式身份验证、仅 SQL 登录还是仅 Windows 身份验证。此设置会影响 R 或 Python 代码要求。
对于每个需要运行 R 代码的用户，确定每个数据库所需的权限级别。在这些数据库中，将从 R 写入对象、访问数据或创建对象。
若要启用脚本执行，请根据需要创建角色或将用户添加到下列角色：
- 除 db_owner 外的所有角色：需要 EXECUTE ANY EXTERNAL SCRIPT。
- db_datawriter：从 R 或 Python 写入结果。
- db_ddladmin：创建新的对象。
- db_datareader：读取 R 或 Python 代码所用的数据。
请注意在安装 SQL Server 2016 时是否更改了任何默认启动帐户。
如果用户需要安装新的 R 包或使用其他用户安装的 R 包，则可能需要在实例上启用包管理，然后分配其他权限。

哪些文件夹会被防病毒软件锁定？

防病毒软件可以锁定文件夹，这会阻止机器学习功能的设置和脚本的成功执行。确定是否对 SQL Server 树中的任何文件夹进行病毒扫描。

但是，当在一个实例上安装多个服务或功能时，可能很难枚举该实例使用的所有可能的文件夹。例如，添加新功能时，必须标识并排除新的文件夹。

此外，某些功能在运行时动态创建新的文件夹。例如，内存中 OLTP 表、存储过程和函数都在运行时创建新的目录。这些文件夹名称通常包含 GUID，并且无法预测。 SQL Server Trusted Launchpad 为 R 和 Python 脚本作业创建新的工作目录。

因为可能无法排除 SQL Server 进程及其功能所需的所有文件夹，所以我们建议你排除整个 SQL Server 实例目录树。

防火墙是否对 SQL Server 开启？实例是否支持远程连接？

若要确定 SQL Server 是否支持远程连接，请参阅配置远程服务器连接。
确定是否已为 SQL Server 创建防火墙规则。出于安全原因，在默认安装中，远程 R 或 Python 客户端可能无法连接到实例。有关详细信息，请参阅排查连接到 SQL Server 时发生的问题。

另请参阅

SQL Server 中的机器学习故障排除

通过

收集数据以对 SQL Server 机器学习服务的 Python 和 R 脚本进行故障排除

SQL Server 版本

R 语言和工具版本

确定 R 版本

Python 版本

是否安装了多个 R 或 Python 实例？

错误源

SQL Server 日志文件

由 sp_execute_external_script 返回的错误

扩展性框架生成的错误

系统事件

转储文件

配置设置

哪些网络协议可用？

安全配置和权限

哪些文件夹会被防病毒软件锁定？

防火墙是否对 SQL Server 开启？实例是否支持远程连接？

另请参阅

反馈

其他资源

通过

收集数据以对 SQL Server 机器学习服务的 Python 和 R 脚本进行故障排除

SQL Server 版本

R 语言和工具版本

确定 R 版本

Python 版本

是否安装了多个 R 或 Python 实例？

错误源

SQL Server 日志文件

由 sp_execute_external_script 返回的错误

扩展性框架生成的错误

系统事件

转储文件

配置设置

哪些网络协议可用？

安全配置和权限

哪些文件夹会被防病毒软件锁定？

防火墙是否对 SQL Server 开启？ 实例是否支持远程连接？

另请参阅

反馈

其他资源

防火墙是否对 SQL Server 开启？实例是否支持远程连接？