Usar o RevoScaleR para instalar pacotes de R

Aplica-se a: SQL Server 2016 (13.x) SQL Server 2017 (14.x)

Este artigo descreve como usar as funções do RevoScaleR (versão 9.0.1 e posterior) para instalar pacotes de R no SQL Server com os Serviços de Machine Learning ou R Services. As funções do RevoScaleR podem ser usadas por usuários remotos e não administradores para instalar pacotes no SQL Server sem acesso direto ao servidor.

Funções do RevoScaleR para o gerenciamento de pacotes

A tabela a seguir descreve as funções usadas para a instalação e o gerenciamento do pacote do R.

Pré-requisitos

• Gerenciamento remoto habilitado no SQL Server. Para obter mais informações, confira Habilitar o gerenciamento de pacotes do R no SQL Server.

• As versões do RevoScaleR são as mesmas em ambientes de cliente e de servidor. Para obter mais informações, confira Obter informações sobre o pacote do R.

• Você tem permissão para se conectar ao servidor e a um banco de dados e executar comandos do R. Você deve ser um membro de uma função de banco de dados que permita a instalação de pacotes na instância e no banco de dados especificados.

  • Os pacotes no escopo compartilhado podem ser instalados por usuários que pertencem à função de rpkgs-shared em um banco de dados especificado. Todos os usuários nesta função podem desinstalar pacotes compartilhados.

  • Os pacotes no escopo particular podem ser instalados por usuários que pertencem à função de rpkgs-private em um banco de dados. No entanto, os usuários podem ver e desinstalar apenas os próprios pacotes.

  • Proprietários de banco de dados podem trabalhar com pacotes compartilhados ou particulares.

Conexões de cliente

Uma estação de trabalho cliente pode ser Microsoft R Client ou um Microsoft Machine Learning Server (os cientistas de dados geralmente usam a edição de desenvolvedor gratuita) na mesma rede.

Ao chamar funções de gerenciamento de pacotes de um cliente R remoto, você deve criar um objeto de contexto de computação primeiro, usando a função RxInSqlServer. Depois disso, para cada função de gerenciamento de pacotes que você usar, passe o contexto de computação como um argumento.

A identidade do usuário normalmente é especificada ao configurar o contexto de computação. Se você não especificar um nome de usuário e uma senha ao criar o contexto de computação, a identidade do usuário que executa o código R será usada.

1. Em uma linha de comando do R, defina uma cadeia de conexão para a instância e o banco de dados.

2. Use o construtor RxInSqlServer para definir um contexto de computação do SQL Server, usando a cadeia de conexão.

   sqlcc <- RxInSqlServer(connectionString = myConnString, shareDir = sqlShareDir, wait = sqlWait, consoleOutput = sqlConsoleOutput)
   

3. Crie uma lista dos pacotes que você deseja instalar e salve a lista em uma variável de cadeia de caracteres.

   packageList <- c("e1071", "mice")
   

4. Chame rxInstallPackages e passe o contexto de computação e a variável de cadeia de caracteres que contém os nomes dos pacotes.

   rxInstallPackages(pkgs = packageList, verbose = TRUE, computeContext = sqlcc)
   

   Se forem necessários pacotes dependentes, eles também serão instalados, supondo que uma conexão de Internet esteja disponível no cliente.

   Os pacotes são instalados usando as credenciais do usuário que está fazendo a conexão, no escopo padrão desse usuário.

Chamar funções de gerenciamento de pacotes em procedimentos armazenados

Você pode executar funções de gerenciamento de pacotes dentro de sp_execute_external_script. Quando você fizer isso, a função será executada usando o contexto de segurança do chamador do procedimento armazenado.

Exemplos

Esta seção fornece exemplos de como usar essas funções de um cliente remoto ao se conectar a uma instância do SQL Server ou banco de dados como o contexto de computação.

Para todos os exemplos, você deve fornecer uma cadeia de conexão ou um contexto de computação, que requer uma cadeia de conexão. Este exemplo fornece uma maneira de criar um contexto de computação para SQL Server:

instance_name <- "computer-name/instance-name";
database_name <- "TestDB";
sqlWait= TRUE;
sqlConsoleOutput <- TRUE;
connString <- paste("Driver=SQL Server;Server=", instance_name, ";Database=", database_name, ";Trusted_Connection=true;", sep="");
sqlcc <- RxInSqlServer(connectionString = connString, wait = sqlWait, consoleOutput = sqlConsoleOutput, numTasks = 4);

Dependendo de onde o servidor está localizado e do modelo de segurança, talvez seja necessário fornecer uma especificação de domínio e sub-rede na cadeia de conexão ou usar um logon do SQL. Por exemplo:

connStr <- "Driver=SQL Server;Server=myserver.financeweb.contoso.com;Database=Finance;Uid=RUser1;Pwd=RUserPassword"

Obter o caminho do pacote em um contexto de computação do SQL Server remoto

Este exemplo obtém o caminho para o pacote RevoScaleR no contexto de computação sqlcc.

sqlPackagePaths <- rxFindPackage(package = "RevoScaleR", computeContext = sqlcc)
print(sqlPackagePaths)

Resultados

"C:/Arquivos de Programas/Microsoft SQL Server/MSSQL14.MSSQLSERVER/R_SERVICES/library/RevoScaleR"

Obter locais de vários pacotes

O exemplo a seguir obtém os caminhos para os pacotes RevoScaleR e lattice no contexto de computação sqlcc. Ao encontrar informações sobre vários pacotes, passa um vetor de cadeia de caracteres que contém os nomes dos pacotes.

packagePaths <- rxFindPackage(package = c("RevoScaleR", "lattice"), computeContext = sqlcc)
print(packagePaths)

Obter versões do pacote em um contexto de computação remota

Execute este comando de um console do R para obter o número de build e os números de versão para pacotes instalados no contexto de computação sqlServer.

sqlPackages <- rxInstalledPackages(fields = c("Package", "Version", "Built"), computeContext = sqlServer)

Instalar um pacote no SQL Server

Este exemplo instala o pacote forecast e suas dependências no contexto de computação.

pkgs <- c("forecast")
rxInstallPackages(pkgs = pkgs, verbose = TRUE, scope = "private", computeContext = sqlcc)

Remover um pacote do SQL Server

Este exemplo remove o pacote forecast e suas dependências do contexto de computação.

pkgs <- c("forecast")
rxRemovePackages(pkgs = pkgs, verbose = TRUE, scope = "private", computeContext = sqlcc)

Sincronizar pacotes entre o banco de dados e o sistema de arquivos

O exemplo a seguir verifica o banco de dados TestDBe determina se todos os pacotes estão instalados no sistema de arquivos. Se alguns pacotes estiverem ausentes, eles serão instalados no sistema de arquivos.

# Instantiate the compute context
connectionString <- "Driver=SQL Server;Server=myServer;Database=TestDB;Trusted_Connection=True;"
computeContext <- RxInSqlServer(connectionString = connectionString )

# Synchronize the packages in the file system for all scopes and users
rxSyncPackages(computeContext=computeContext, verbose=TRUE)

A sincronização de pacotes funciona em uma base por banco de dados e por usuário. Para obter mais informações, confira Sincronização de Pacotes do R para o SQL Server.

Usar um procedimento armazenado para listar pacotes no SQL Server

Execute este comando do Management Studio ou outra ferramenta que dê suporte ao T-SQL, para obter uma lista de pacotes instalados na instância atual, usando rxInstalledPackages em um procedimento armazenado.

EXEC sp_execute_external_script 
  @language=N'R', 
  @script=N'
    myPackages <- rxInstalledPackages();
    OutputDataSet <- as.data.frame(myPackages);
    '

A função rxSqlLibPaths pode ser usada para determinar a biblioteca ativa usada por Serviços de Machine Learning do SQL Server. Esse script pode retornar apenas o caminho da biblioteca para o servidor atual.

declare @instance_name nvarchar(100) = @@SERVERNAME, @database_name nvarchar(128) = db_name();
exec sp_execute_external_script 
  @language = N'R',
  @script = N'
    connStr <- paste("Driver=SQL Server;Server=", instance_name, ";Database=", database_name, ";Trusted_Connection=true;", sep="");
    .libPaths(rxSqlLibPaths(connStr));
    print(.libPaths());
  ', 
  @input_data_1 = N'', 
  @params = N'@instance_name nvarchar(100), @database_name nvarchar(128)',
  @instance_name = @instance_name, 
  @database_name = @database_name;

Confira também

• Habilitar o gerenciamento remoto de pacotes R
• Sincronizar os pacotes R
• Dicas para usar pacotes de R
• Obter informações sobre o pacote do R