Compartilhar via


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.

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

Este artigo descreve como obter informações sobre os pacotes do R instalados nos Serviços de Machine Learning da Instância Gerenciada de SQL do Azure. 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\MSSQL13.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.

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

C:\Program Files\Microsoft SQL Server\MSSQL14.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.

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

Pacotes do R padrão da Microsoft

Os seguintes pacotes do R da Microsoft são instalados com o SQL Server R Services.

Pacotes Versão Descrição
RevoScaleR 8.0.3 Usada para contextos de computação remota, streaming, execução paralela de funções rx para importação e transformação de dados, modelagem, visualização e análise.
sqlrutils 1.0.0 Usada para incluir o script R em procedimentos armazenados.

Pacotes do R padrão da Microsoft

Os pacotes do R da Microsoft a seguir são instalados com os Serviços de Machine Learning do SQL Server quando você seleciona o recurso do R durante a instalação.

Pacotes Versão Descrição
RevoScaleR 9.2 Usada para contextos de computação remota, streaming, execução paralela de funções rx para importação e transformação de dados, modelagem, visualização e análise.
sqlrutils 1.0.0 Usada para incluir o script R em procedimentos armazenados.
MicrosoftML 1.4.0 Adiciona algoritmos de aprendizado de máquina em R.
olapR 1.0.0 Usada para escrever instruções MDX em R.

Pacotes do R padrão da Microsoft

Os pacotes do R da Microsoft a seguir são instalados com os Serviços de Machine Learning do SQL Server quando você seleciona o recurso do R durante a instalação.

Pacotes Versão Descrição
RevoScaleR 9.4.7 Usada para contextos de computação remota, streaming, execução paralela de funções rx para importação e transformação de dados, modelagem, visualização e análise.
sqlrutils 1.0.0 Usada para incluir o script R em procedimentos armazenados.
MicrosoftML 9.4.7 Adiciona algoritmos de aprendizado de máquina em R.
olapR 1.0.0 Usada para escrever instruções MDX em R.

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.

Além disso, você pode adicionar pacotes MicrosoftML e olapR a uma instância do SQL Server por meio de uma atualização de componente.

Pacotes do R de software livre padrão

O suporte ao R inclui o R de software livre para que você possa chamar funções básicas do R e instalar pacotes de terceiros e de software livre adicionais. O suporte à linguagem R inclui a principal funcionalidade, como base, stats, utils e outros. A instalação básica do R também inclui vários exemplos de conjuntos de dados e ferramentas padrão do R, como o RGui (um editor interativo leve) e o RTerm (um prompt de comando do R).

Para obter informações sobre qual versão do R está incluída em cada versão do SQL Server, consulte Versões do Python e do R.

Importante

Você nunca deve substituir manualmente a versão do R instalada pela Instalação do SQL Server por versões mais recentes na Web. Os pacotes do Microsoft R são baseados em versões específicas do R. Modificar sua instalação poderia desestabilizá-lo.

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