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"))
'