Compartir a través de

Sincronización de un paquete de R para SQL Server

  • Artículo

Se aplica a: SQL Server 2017 (14.x) solo

La versión de RevoScaleR que se incluye en SQL Server 2017 incluye la funcionalidad de sincronizar las colecciones de paquetes de R entre el sistema de archivos y la instancia y la base de datos donde se usan los paquetes.

Esta característica se ha proporcionado para facilitar la copia de seguridad de colecciones de paquetes de R asociadas a bases de datos de SQL Server. Con esta característica, un administrador puede restaurar no solo la base de datos, sino también los paquetes de R utilizados por los científicos de datos que trabajan en esa base de datos.

En este artículo se describe la característica de sincronización de paquetes y cómo usar la función rxSyncPackages para realizar las siguientes tareas:

  • Sincronizar una lista de paquetes para una base de datos de SQL Server completa

  • Sincronizar paquetes usados por un usuario individual o por un grupo de usuarios

  • Si un usuario se traslada a otro servidor de SQL Server, puede realizar una copia de seguridad de la base de datos de trabajo del usuario y restaurarla en el nuevo servidor, y los paquetes del usuario se instalarán en el sistema de archivos del nuevo servidor, tal y como requiere R.

Por ejemplo, puede usar la sincronización de paquetes en estos escenarios:

  • El DBA restauró una instancia de SQL Server a una nueva máquina y pide a los usuarios que se conecten desde sus clientes de R y ejecuten rxSyncPackages para actualizar y restaurar sus paquetes.

  • Cree que un paquete de R en el sistema de archivos está dañado, por lo que ejecuta rxSyncPackages en el servidor SQL Server.

Requisitos

Para poder usar la sincronización de paquetes, debe tener la versión adecuada de Microsoft R. Esta característica se proporciona en la versión 9.1.0 o posteriores de Microsoft R.

También debe habilitar la característica de administración de paquetes en el servidor.

Determinación de si el servidor es compatible con la administración de paquetes

Esta característica está disponible en SQL Server 2017 CTP 2 o posterior.

Habilitación de la característica de administración de paquetes

El uso de la sincronización de paquetes requiere que la nueva característica de administración de paquetes esté habilitada en la instancia de SQL Server y en las bases de datos individuales. Para más información, vea Habilitación o deshabilitación de la administración de paquetes para SQL Server.

  1. El administrador del servidor habilita la característica para la instancia de SQL Server.
  2. Para cada base de datos, el administrador concede a los usuarios individuales la capacidad de instalar o compartir paquetes de R mediante roles de base de datos.

Una vez hecho esto, puede usar las funciones de RevoScaleR, como rxInstallPackages, para instalar paquetes en una base de datos. La información sobre los usuarios y los paquetes que pueden usar se almacena en la instancia de SQL Server.

Siempre que se agrega un nuevo paquete mediante las funciones de administración de paquetes, se actualizan los registros de SQL Server y del sistema de archivos. Esta información se puede usar para restaurar información de paquetes para toda la base de datos.

Permisos

  • La persona que ejecuta la función de sincronización de paquetes debe ser una entidad de seguridad en la instancia de SQL Server y en la base de datos que contiene los paquetes.

  • El autor de la llamada de la función debe ser miembro de uno de estos roles de administración de paquetes: rpkgs-shared o rpkgs-private.

  • Para sincronizar los paquetes marcados como compartidos, la persona que ejecuta la función debe ser miembro del rol rpkgs-shared y los paquetes que se van a migrar deben haberse instalado en una biblioteca de ámbito compartido.

  • Para sincronizar los paquetes marcados como privados, el propietario del paquete o el administrador deben ejecutar la función y los paquetes deben ser privados.

  • Para sincronizar paquetes en nombre de otros usuarios, el propietario debe ser miembro del rol de base de datos db_owner.

Funcionamiento de la sincronización de paquetes

Para usar la sincronización de paquetes, llame a rxSyncPackages, que es una nueva función de RevoScaleR.

Para cada llamada a rxSyncPackages, debe especificar una instancia de SQL Server y una base de datos. A continuación, enumere los paquetes que se van a sincronizar o especifique el ámbito del paquete.

  1. Cree el contexto de proceso de SQL Server mediante la función RxInSqlServer. Si no se especifica un contexto de proceso, se usa el contexto de proceso actual.

  2. Proporcione el nombre de una base de datos en la instancia del contexto de proceso especificado. Los paquetes se sincronizan por base de datos.

  3. Especifique los paquetes que se van a sincronizar mediante el argumento de ámbito.

    Si utiliza el ámbito privado, solo se sincronizan los paquetes que pertenecen al propietario especificado. Si especifica el ámbito compartido, se sincronizan todos los paquetes no privados de la base de datos.

    Si ejecuta la función sin especificar el ámbito privado o compartido, se sincronizan todos los paquetes.

  4. Si el comando se ejecuta correctamente, los paquetes existentes en el sistema de archivos se agregan a la base de datos, con el ámbito y el propietario especificados.

    Si el sistema de archivos está dañado, los paquetes se restauran en función de la lista que se mantiene en la base de datos.

    Si la característica de administración de paquetes no está disponible en la base de datos de destino, se produce un error: "The package management feature is either not enabled on the SQL Server or version is too old" (La característica de administración de paquetes no está habilitada en SQL Server o la versión es demasiado antigua).

Ejemplo 1. Sincronizar todos los paquetes por base de datos

En este ejemplo se obtienen todos los paquetes nuevos del sistema de archivos local y se instalan los paquetes en la base de datos [TestDB]. Dado que ningún propietario es específico, la lista incluye todos los paquetes que se han instalado para ámbitos privados y compartidos.

connectionString <- "Driver=SQL Server;Server=myServer;Database=TestDB;Trusted_Connection=True;"
computeContext <- RxInSqlServer(connectionString = connectionString )
rxSyncPackages(computeContext=computeContext, verbose=TRUE)

Ejemplo 2. Restringir paquetes sincronizados por ámbito

En los siguientes ejemplos se sincronizan solo los paquetes en el ámbito especificado.

#Shared scope
rxSyncPackages(computeContext=computeContext, scope="shared", verbose=TRUE)

#Private scope
rxSyncPackages(computeContext=computeContext, scope="private", verbose=TRUE)

Ejemplo 3. Restringir paquetes sincronizados por propietario

En el ejemplo siguiente se muestra cómo sincronizar solo los paquetes que se instalaron para un usuario específico. En este ejemplo, el usuario se identifica mediante el nombre de inicio de sesión de SQL, user1.

rxSyncPackages(computeContext=computeContext, scope="private", owner = "user1", verbose=TRUE))

Administración de paquetes de R para SQL Server