Obter informações sobre o pacote do R

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Instância Gerenciada de SQL do Azure

Este artigo descreve como obter informações sobre os pacotes R instalados nos Serviços de Machine Learning do SQL Server e nos Clusters de Big Data do SQL Server 2019. Os exemplos de scripts R mostram como listar informações de pacote, como o caminho e a versão de instalação.

Observação

As funcionalidades de recursos e as opções de instalação variam entre as versões do SQL Server. Use a lista suspensa seletor de versão para escolher a versão apropriada do SQL Server.

Localização da biblioteca padrão do R

Quando você instala o aprendizado de máquina com o SQL Server, uma única biblioteca de pacotes é criada no nível de instância para cada linguagem instalada. No Windows, a biblioteca de instâncias é uma pasta protegida registrada no SQL Server.

Todo script executado no banco de dados no SQL Server deve carregar funções da biblioteca de instâncias. O SQL Server não pode acessar pacotes instalados em outras bibliotecas. Isso se aplica a clientes remotos também: qualquer script R em execução no contexto de computação do servidor só pode usar pacotes instalados na biblioteca de instâncias. Para proteger os ativos do servidor, a biblioteca de instâncias padrão pode ser modificada apenas por um administrador do computador.

O caminho padrão dos binários para R é:

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

Isso pressupõe a instância SQL padrão, MSSQLSERVER. Se o SQL Server estiver instalado como uma instância nomeada definida pelo usuário, o nome fornecido será usado.

Execute a instrução a seguir para verificar a biblioteca de pacotes do R padrão para a instância atual:

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

Atualizações de componentes

Por padrão, os pacotes do R são atualizados por meio de service packs e atualizações cumulativas. Pacotes adicionais e atualizações de versão completa dos principais componentes do R são possíveis apenas por meio das atualizações de produto.

Listar todos os pacotes do R instalados

O exemplo a seguir usa a função do R installed.packages() em um procedimento armazenado Transact-SQL para exibir uma lista de pacotes do R que foram instalados na biblioteca R_SERVICES da instância do SQL atual. Esse script retorna os campos de nome e versão do pacote no arquivo 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 obter mais informações sobre os campos opcionais e padrão do campo DESCRIÇÃO do pacote do R, confira https://cran.r-project.org.

Localizar um único pacote do R

Se você tiver instalado um pacote do R e desejar verificar se ele está disponível para uma instância específica do SQL Server, poderá executar um procedimento armazenado para carregar o pacote e retornar as mensagens.

Por exemplo, a instrução a seguir procura e carrega o pacote glue, se disponível. Se não for possível localizar ou carregar o pacote, você receberá um erro.

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

Para ver mais informações sobre o pacote, exiba o packageDescription. A instrução a seguir retorna informações para o pacote MicrosoftML.

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

Próximas etapas

• Instalar novos pacotes de R com sqlmlutils