Compartilhar via

Instalar o SQL Server 2016 R Services

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

Saiba como instalar o SQL Server 2016 R Services no Windows. Você pode usar o R Services para executar scripts R no banco de dados.

Observação

No SQL Server 2017 e posterior, o R está incluído nos Serviços de Machine Learning, juntamente com o Python. Caso você deseje obter o R e tenha o SQL Server 2017 ou posterior, confira Instalar os Serviços de Machine Learning do SQL Server para adicionar o recurso.

Lista de verificação pré-instalação

  • Uma instância do mecanismo de banco de dados é necessária. Não é possível instalar apenas o R, embora você possa adicioná-lo de maneira incremental a uma instância existente.

  • Para garantir a continuidade dos negócios, um grupo de disponibilidade Always On é suportado para os Serviços R. Você precisa instalar o R Services e configurar pacotes em cada nó.

  • Não instale o R Services em uma FCI (Instância do Cluster de Failover) sempre ativada do SQL Server. O mecanismo de segurança usado para isolar processos do R não é compatível com um ambiente FCI (Instância de Cluster de Failover AlwaysOn) do SQL Server.

  • Não instale o R Services em um controlador de domínio. A parte do R Services da instalação falhará.

  • Não instale Recursos Compartilhados>R Server (Autônomo) no mesmo computador que executa uma instância no banco de dados.

  • A instalação lado a lado com outras versões do R é compatível, mas não recomendada. É compatível porque a instância do SQL Server usa suas próprias cópias da distribuição do R de código aberto. No entanto, a execução de código que usa o R no computador do SQL Server fora do SQL Server pode levar a vários problemas:

    • Você usa uma biblioteca diferente e um executável diferente e obtém resultados diferentes do que quando está em execução no SQL Server.
    • Scripts R em execução em bibliotecas externas não podem ser gerenciados pelo SQL Server, levando à contenção de recursos.

Importante

Após a conclusão da instalação, conclua as etapas de pós-configuração adicionais descritas neste artigo. Essas etapas incluem a habilitação do SQL Server para usar scripts externos e a adição de contas necessárias para o SQL Server executar trabalhos do R em seu nome. Geralmente, as alterações na configuração exigem uma reinicialização da instância ou do serviço Launchpad.

Obtenha a mídia de instalação

O local de download para SQL Server depende da edição:

  • Edições SQL Server Enterprise, Standard e Express. Essas edições são licenciadas para uso em produção. Para as edições Enterprise e Standard, entre em contato com seu fornecedor de software para obter a mídia de instalação. Você pode encontrar informações de compra e um diretório de parceiros da Microsoft no site de compras da Microsoft.

  • A última edição gratuita.

Instalar o requisito de patch

A Microsoft identificou um problema com a versão específica dos binários do Runtime Microsoft VC++ 2013 que são instalados como um pré-requisito pelo SQL Server. Se essa atualização para os binários de runtime de VC não estiver instalada, o SQL Server poderá enfrentar problemas de estabilidade em determinados cenários. Antes de instalar o SQL Server, siga as instruções em Notas de Versão do SQL Server para ver se seu computador precisa de um patch para os binários de runtime do VC.

Executar a instalação

Para instalações locais, você deve executar a Instalação como um administrador. Se você instalar o SQL Server de um compartilhamento remoto, deverá usar uma conta de domínio que tenha permissões de leitura e de execução no compartilhamento remoto.

  1. Inicie o assistente de instalação do SQL Server 2016.

  2. Na guia Instalação, selecione Nova instalação autônoma do SQL Server ou adicionar recursos a uma instalação existente.

    Captura de tela de Instalação dos Serviços R (In-Database).

  3. Na página Seleção de Recursos, selecione as seguintes opções:

    • Selecione Serviços do Mecanismo de Banco de Dados. O mecanismo de banco de dados é necessário em cada instância do que usa o aprendizado de máquina.
    • Selecione R Services (no Banco de Dados) . Instala o suporte para o uso no banco de dados do R.

    Captura de tela da seleção de recursos do R Services.

    Importante

    Não instale o R Server e o R Services ao mesmo tempo.

  4. Na página Consentimento para Instalar o Microsoft R Open , selecione Aceitar.

    Esse contrato de licença é necessário para baixar o Microsoft R Open, que inclui uma distribuição dos pacotes e das ferramentas base do R de software livre, junto com pacotes R avançados e provedores de conectividade da equipe de desenvolvimento do Microsoft R.

  5. Depois de aceitar o contrato de licença, haverá uma breve pausa enquanto o instalador está preparado. Selecione Avançar quando o botão ficar disponível.

  6. Na página Pronto para Instalar, verifique se os itens a seguir estão incluídos e, em seguida, selecione Instalar.

    • Serviços do Mecanismo de Banco de Dados
    • R Services (no Banco de Dados)

  7. Após a conclusão da instalação, se você receber instruções para reiniciar o computador, faça-o agora. É importante ler a mensagem do Assistente de Instalação quando você terminar de configurar. Para obter mais informações, consulte Exibir e ler arquivos de log de Instalação do SQL Server.

Definir variáveis de ambiente

Somente para a integração de recursos do R, é necessário definir a variável de ambiente MKL_CBWR para garantir a saída consistente dos cálculos da Intel MKL (Math Kernel Library).

  1. No Painel de Controle, selecione Sistema e Segurança>Sistema>Configurações Avançadas do Sistema>Variáveis de Ambiente.

  2. Crie uma variável de usuário ou do sistema.

    • Defina o nome da variável como MKL_CBWR
    • Defina o valor da variável como AUTO

Esta etapa requer uma reinicialização do servidor. Você poderá segurar a reinicialização até que todo o trabalho de configuração seja concluído.

Habilitar a execução do script

  1. Abra o SSMS (SQL Server Management Studio).

  2. Conecte-se à instância em que você instalou o R Services, selecione Nova Consulta para abrir uma janela de consulta e execute o seguinte comando:

    sp_configure

    O valor da propriedade, external scripts enabled, deve ser 0 neste ponto. Isso ocorre porque o recurso está desativado por padrão. Para executar scripts R, o recurso deve ser habilitado explicitamente por um administrador.

  3. Para habilitar o recurso de script externo, execute a instrução a seguir:

    EXECUTE sp_configure 'external scripts enabled', 1;
RECONFIGURE WITH OVERRIDE;

Reinicie o serviço.

Quando a instalação for concluída, reinicie o mecanismo de banco de dados antes de passar para a próxima, habilitando a execução do script.

Reiniciar o serviço também reinicia automaticamente o serviço SQL Server Launchpad relacionado.

Você pode reiniciar o serviço usando o comando Reiniciar, encontrado no clique com o botão direito do mouse, para a instância no SSMS ou usando o SQL Server Configuration Manager.

Verifique a instalação

Use as etapas a seguir para verificar se todos os componentes usados para iniciar o script externo estão em execução.

  1. No SQL Server Management Studio, abra uma nova janela de consulta e execute o seguinte comando:

    EXECUTE sp_configure 'external scripts enabled';

    O run_value agora deve ser definido como 1.

  2. Abra o SQL Server Configuration Manager e verifique se o serviço SQL Server Launchpad está em execução. Você deve ter um serviço para cada instância do mecanismo de banco de dados que tem o R instalado. Para obter mais informações sobre o serviço, confira Arquitetura de extensibilidade nos Serviços de Machine Learning do SQL Server.

  3. Se o Launchpad estiver em execução, você deverá conseguir executar o R simples para verificar se os runtimes de script externo podem se comunicar com o SQL Server.

    Abra uma nova janela de consulta no SQL Server Management Studio e execute o seguinte script:

    EXEC sp_execute_external_script  @language =N'R',
@script=N'
OutputDataSet <- InputDataSet;
',
@input_data_1 =N'SELECT 1 AS hello'
WITH RESULT SETS (([hello] int not null));
GO

    Na primeira vez que o runtime de script externo for carregado, o script poderá demorar um pouco para ser executado. Os resultados devem ser semelhantes a estes:

    hello
    1

Aplicar atualizações

Recomendamos que você aplique o service pack e a atualização cumulativa mais recentes aos componentes de machine learning e do mecanismo de banco de dados.

Em dispositivos conectados à Internet, as atualizações cumulativas são normalmente aplicadas por meio do Windows Update, mas você também pode usar as etapas abaixo para atualizações controladas. Quando você aplica a atualização do mecanismo de banco de dados, a Instalação obtém as atualizações cumulativas para as bibliotecas do R instaladas na mesma instância.

Em servidores desconectados, são necessárias etapas adicionais. Para obter mais informações, confira Instalar em computadores sem acesso à Internet > Aplicar atualizações cumulativas.

  1. Comece com uma instância de linha de base já instalada: Versão inicial do SQL Server 2016, SQL Server 2016 SP 1 ou SQL Server 2016 SP 2.

  2. Acesse a lista de atualizações cumulativas: Atualizações mais recentes do Microsoft SQL Server

  3. Selecione o service pack (ainda não instalado como a instância de linha de base) e a atualização cumulativa mais recentes. Um executável é baixado e extraído automaticamente.

  4. Execute a instalação. Aceite os termos de licenciamento e, na página seleção de recursos, examine os recursos para os quais as atualizações cumulativas são aplicadas. Você deverá ver todos os recursos instalados para a instância atual, incluindo o R Services. A instalação baixa os arquivos CAB necessários para atualizar todos os recursos.

  5. Continue com o assistente, aceitando os termos de licenciamento para a distribuição do R.

Observação

A CU (atualização cumulativa) 14 e posterior para o SQL Server 2016 SP2 inclui uma versão mais recente do runtime do R. Para obter mais informações, consulte Alterar a versão padrão do runtime de linguagem R ou Python.

Configuração adicional

Se a etapa de verificação de script externo for bem-sucedida, você poderá executar comandos do R por meio do SQL Server Management Studio, do Azure Data Studio ou de qualquer outro cliente que possa enviar instruções T-SQL ao servidor.

Se você receber um erro ao executar o comando, examine as etapas de configuração adicionais nesta seção. Talvez seja necessário realizar configurações apropriadas adicionais para o serviço ou banco de dados.

No nível da instância, a configuração adicional pode incluir:

No banco de dados, talvez você precise das seguintes atualizações de configuração:

Observação

Nem todas as alterações listadas são necessárias e nenhuma pode ser necessária. Os requisitos dependem do esquema de segurança, da localização em que o SQL Server foi instalado e da maneira como você espera que os usuários se conectem ao banco de dados e executem scripts externos. Para obter mais diretrizes de instalação, consulte Instalar os Serviços de Machine Learning do SQL Server.

Otimizações sugeridas

Talvez convenha também otimizar o servidor para oferecer suporte ao machine learning com R ou instalar modelos pré-treinados.

Adicionar mais contas de trabalho

Se você acreditar que fará uso considerável do R ou esperar que muitos usuários executem scripts simultaneamente, aumente o número de contas de trabalho atribuídas ao serviço Launchpad. Para obter mais informações, confira a execução simultânea da escala de scripts externos nos Serviços de Machine Learning do SQL Server.

Otimizar o servidor para a execução de script externo

As configurações padrão da instalação do SQL Server destinam-se a otimizar o equilíbrio do servidor para uma variedade de serviços compatíveis com o mecanismo de banco de dados, que podem incluir processos ETL (incluir, transformar e carregar), relatórios, auditoria e aplicativos que usam os dados do SQL Server. Portanto, nas configurações padrão, você poderá descobrir que os recursos para os recursos de machine learning são algumas vezes restritos ou limitados, especialmente em operações com uso intensivo de memória.

Para verificar se os trabalhos de machine learning são priorizados e têm os recursos apropriados, recomendamos que você use o SQL Server Resource Governor para configurar um pool de recursos externo. Talvez convenha também alterar a quantidade de memória alocada ao mecanismo de banco de dados do SQL Server ou aumentar o número de contas executadas no serviço SQL Server Launchpad.

Se você estiver usando o Standard Edition e não tiver o Resource Governor, poderá usar DMVs (Exibições de Gerenciamento Dinâmico) e Eventos Estendidos, bem como monitoramento de eventos do Windows, para ajudar a gerenciar os recursos do servidor usados pelo R.

Instalar pacotes adicionais do R

As soluções do R que você cria para o SQL Server podem chamar funções básicas do R, funções dos pacotes proprietários instalados com o SQL Server e pacotes R de terceiros compatíveis com a versão do R de software livre instalada pelo SQL Server.

Pacotes que você desejar usar do SQL Server deverão ser instalados na biblioteca padrão usada pela instância. Caso você tenha uma instalação separada do R no computador ou tenha instalado pacotes em bibliotecas do usuário, não poderá usar esses pacotes no T-SQL.

O processo de instalação e gerenciamento de pacotes R é diferente no SQL Server 2016 e no SQL Server 2017. No SQL Server 2016, um administrador de banco de dados precisa instalar os pacotes R necessários para os usuários. No SQL Server 2017, você pode configurar grupos de usuários para compartilhar pacotes em um nível por banco de dados ou configurar funções de banco de dados para permitir que os usuários instalem seus próprios pacotes. Para obter mais informações, confira Instalar pacotes com as ferramentas R.

Conteúdo relacionado

  • Last updated on