Obtención de información de paquetes de R

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores Azure SQL Managed Instance

En este artículo se describe cómo obtener información sobre los paquetes de R instalados en Machine Learning Services en SQL Server y en Clústeres de macrodatos de SQL Server 2019. Los scripts de R de ejemplo muestran cómo mostrar información de paquetes, como la ruta de instalación y la versión.

En este artículo se describe cómo obtener información sobre los paquetes de R instalados en SQL Server Machine Learning Services. Los scripts de R de ejemplo muestran cómo mostrar información de paquetes, como la ruta de instalación y la versión.

En este artículo se describe cómo obtener información sobre los paquetes de R instalados en Machine Learning Services en Azure SQL Managed Instance. Los scripts de R de ejemplo muestran cómo mostrar información de paquetes, como la ruta de instalación y la versión.

Nota:

Las funcionalidades de características y las opciones de instalación varían entre las versiones de SQL Server. Use la lista desplegable del selector de versiones para elegir la versión adecuada de SQL Server.

Ubicación predeterminada de las bibliotecas de R

Al instalar Machine Learning con SQL Server, se crea una biblioteca de paquetes en el nivel de instancia para cada idioma que se instale. En Windows, la biblioteca de instancias es una carpeta protegida que está registrada en SQL Server.

Todo el script que se ejecuta en la base de datos en SQL Server debe cargar funciones desde la biblioteca de instancias. SQL Server no puede obtener acceso a los paquetes instalados en otras bibliotecas. También se aplica a los clientes remotos: cualquier script de R que se ejecute en el contexto del proceso del servidor solo puede usar paquetes instalados en la biblioteca de instancias. Para proteger los recursos del servidor, la biblioteca de instancias predeterminadas solo la puede modificar un administrador del equipo.

La ruta de acceso predeterminada de los archivos binarios de R es:

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

Se da por sentado que la instancia predeterminada de SQL es MSSQLSERVER. Si se instala SQL Server como instancia con nombre definida por el usuario, se usará el nombre especificado.

La ruta de acceso predeterminada de los archivos binarios de R es:

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

Se da por sentado que la instancia predeterminada de SQL es MSSQLSERVER. Si se instala SQL Server como instancia con nombre definida por el usuario, se usará el nombre especificado.

La ruta de acceso predeterminada de los archivos binarios de R es:

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

Se da por sentado que la instancia predeterminada de SQL es MSSQLSERVER. Si se instala SQL Server como instancia con nombre definida por el usuario, se usará el nombre especificado.

Ejecute la siguiente instrucción para comprobar la biblioteca de paquetes de R predeterminada de la instancia actual:

EXECUTE sp_execute_external_script  
  @language = N'R',
  @script = N'OutputDataSet <- data.frame(.libPaths());'
WITH RESULT SETS (([DefaultLibraryName] VARCHAR(MAX) NOT NULL));
GO

Paquetes predeterminados de R en Microsoft

Los siguientes paquetes de R de Microsoft se instalan con SQL Server R Services.

Paquetes Versión Descripción
RevoScaleR 8.0.3 Se usa para los contextos de procesos remotos, streaming, ejecución en paralelo de funciones rx para la importación y transformación de datos, modelado, visualización y análisis.
sqlrutils 1.0.0 Se usa para incluir scripts de R en procedimientos almacenados.

Paquetes predeterminados de R en Microsoft

Los siguientes paquetes de R de Microsoft se instalan con SQL Server Machine Learning Services al seleccionar la característica de R durante la instalación.

Paquetes Versión Descripción
RevoScaleR 9.2 Se usa para los contextos de procesos remotos, streaming, ejecución en paralelo de funciones rx para la importación y transformación de datos, modelado, visualización y análisis.
sqlrutils 1.0.0 Se usa para incluir scripts de R en procedimientos almacenados.
MicrosoftML 1.4.0 Agrega algoritmos de aprendizaje automático en R.
olapR 1.0.0 Se utiliza para escribir instrucciones MDX en R.

Paquetes predeterminados de R en Microsoft

Los siguientes paquetes de R de Microsoft se instalan con SQL Server Machine Learning Services al seleccionar la característica de R durante la instalación.

Paquetes Versión Descripción
RevoScaleR 9.4.7 Se usa para los contextos de procesos remotos, streaming, ejecución en paralelo de funciones rx para la importación y transformación de datos, modelado, visualización y análisis.
sqlrutils 1.0.0 Se usa para incluir scripts de R en procedimientos almacenados.
MicrosoftML 9.4.7 Agrega algoritmos de aprendizaje automático en R.
olapR 1.0.0 Se utiliza para escribir instrucciones MDX en R.

Actualizaciones de componentes

De forma predeterminada, los paquetes de R se actualizan mediante Service Packs y actualizaciones acumulativas. Los paquetes adicionales y las actualizaciones de versión completa de los componentes principales de R solo se pueden conseguir mediante actualizaciones de productos.

Además, puede agregar paquetes de MicrosoftML y olapR a una instancia de SQL Server a través de una actualización de componente.

Paquetes de código abierto predeterminados de R

La compatibilidad con R incluye R de código abierto para que pueda llamar a las funciones base de R e instalar paquetes de código abierto y de terceros adicionales. La compatibilidad con el lenguaje de R incluye funcionalidades básicas, como base, stats, utils, entre otras. Una instalación base de R también incluye numerosos conjuntos de datos de ejemplo y herramientas de R estándar, como RGui (un editor interactivo ligero) y RTerm (un símbolo del sistema de R).

Para obtener información sobre la versión de R que se incluye con cada versión de SQL Server, consulte Versiones de Python y R.

Importante

Nunca debe sobrescribir manualmente la versión de R instalada por el programa de instalación de SQL Server por versiones más recientes en la web. Los paquetes de Microsoft R se basan en versiones específicas de R. La modificación de la instalación podría desestabilizarla.

Visualización de todos los paquetes de R instalados

En el ejemplo siguiente se usa la función de R installed.packages() en un procedimiento almacenado de Transact-SQL para mostrar una lista de paquetes de R que se han instalado en la biblioteca R_SERVICES para la instancia actual de SQL. Este script devuelve los campos de nombre y versión del paquete en el archivo 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) ))

Para obtener más información sobre los campos opcionales y predeterminados del archivo DESCRIPTION del paquete de R, consulte https://cran.r-project.org.

Búsqueda de un paquete de R

Si ha instalado un paquete de R y quiere asegurarse de que está disponible para una instancia de SQL Server determinada, puede ejecutar un procedimiento almacenado para cargar el paquete y devolver los mensajes.

Por ejemplo, la siguiente instrucción busca y carga el paquete glue, si está disponible. Si no se puede encontrar o cargar el paquete, obtendrá un error.

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

Para ver más información sobre el paquete, consulte packageDescription. La siguiente instrucción devuelve información del paquete MicrosoftML.

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

Pasos siguientes