Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
SQL Server 2016 (13.x) e versões posteriores Instância Gerenciada SQL do Azure
Este artigo descreve como obter informações sobre pacotes R instalados nos Serviços de Aprendizado de Máquina no SQL Server e nos Clusters de Big Data do SQL Server 2019. Exemplos de scripts R mostram como listar informações do pacote, como caminho de instalação e versão.
Este artigo descreve como obter informações sobre pacotes R instalados no SQL Server Machine Learning Services. Exemplos de scripts R mostram como listar informações do pacote, como caminho de instalação e versão.
Este artigo descreve como obter informações sobre pacotes R instalados nos Serviços de Aprendizado de Máquina de Instância Gerenciada SQL do Azure. Exemplos de scripts R mostram como listar informações do pacote, como caminho de instalação e versão.
Observação
Os recursos e as opções de instalação variam entre as versões do SQL Server. Use a lista suspensa do seletor de versão para escolher a versão apropriada do SQL Server.
Local padrão da biblioteca R
Quando você instala o aprendizado de máquina com o SQL Server, uma única biblioteca de pacotes é criada no nível da instância para cada idioma instalado. No Windows, a biblioteca de instâncias é uma pasta segura registrada no SQL Server.
Todos os scripts executados no banco de dados no SQL Server devem carregar funções da biblioteca de instâncias. O SQL Server não pode acessar pacotes instalados em outras bibliotecas. Isso também se aplica a clientes remotos: 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 só pode ser modificada 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 for 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 for 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 for instalado como uma instância nomeada definida pelo usuário, o nome fornecido será usado.
Execute a seguinte instrução para verificar a biblioteca de pacotes 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 padrão do Microsoft R
Os seguintes pacotes do Microsoft R são instalados com o SQL Server R Services.
| Packages | Versão | Description |
|---|---|---|
| RevoScaleR | 8.0.3 | Usado 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 | Usado para incluir o script R em procedimentos armazenados. |
Pacotes padrão do Microsoft R
Os seguintes pacotes do Microsoft R são instalados com os Serviços de Aprendizado de Máquina do SQL Server quando você seleciona o recurso R durante a instalação.
| Packages | Versão | Description |
|---|---|---|
| RevoScaleR | 9.2 | Usado 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 | Usado 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 | Usado para escrever instruções MDX em R. |
Pacotes padrão do Microsoft R
Os seguintes pacotes do Microsoft R são instalados com os Serviços de Aprendizado de Máquina do SQL Server quando você seleciona o recurso R durante a instalação.
| Packages | Versão | Description |
|---|---|---|
| RevoScaleR | 9.4.7 | Usado 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 | Usado 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 | Usado para escrever instruções MDX em R. |
Atualizações de componentes
Por padrão, os pacotes R são atualizados por meio de service packs e atualizações cumulativas. Pacotes adicionais e atualizações de versão completa dos componentes principais do R só são possíveis por meio de atualizações do 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 R de código aberto padrão
O suporte para R inclui o R de código aberto, para que possa chamar funções base do R e instalar pacotes adicionais de terceiros e de código aberto. O suporte à linguagem R inclui funcionalidades principais, como base, stats, utils e outros. Uma instalação base do R também inclui vários conjuntos de dados de exemplo e ferramentas R padrão, como RGui (um editor interativo leve) e RTerm (um prompt de comando R).
Para obter informações sobre qual versão do R está incluída em cada versão do SQL Server, consulte Versões Python e 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 Microsoft R são baseados em versões específicas do R. Modificar sua instalação pode desestabilizá-lo.
Listar todos os pacotes R instalados
O exemplo a seguir usa a função installed.packages() R em um procedimento armazenado Transact-SQL para exibir uma lista de pacotes R que foram instalados na biblioteca R_SERVICES para a instância SQL atual. Esse script retorna o nome do pacote e os campos de versão 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 para o campo DESCRIÇÃO do pacote R, consulte https://cran.r-project.org.
Encontre um único pacote R
Se você instalou um pacote R e deseja garantir que ele esteja disponível para uma instância específica do SQL Server, você pode executar um procedimento armazenado para carregar o pacote e retornar mensagens.
Por exemplo, a seguinte instrução procura o pacote glue e o carrega, se disponível. Se o pacote não puder ser localizado ou carregado, você receberá um erro.
EXECUTE sp_execute_external_script
@language =N'R',
@script=N'
require("glue")
'
Para ver mais informações sobre o pacote, consulte 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"))
'