Instalar os Serviços de Machine Learning do SQL Server com R e Python na linha de comando

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Este artigo fornece instruções para instalar os Serviços de Machine Learning do SQL Server com Python e R usando uma linha de comando.

Você pode especificar a interação silenciosa, básica ou completa com a interface do usuário de Instalação. Este artigo complementa Instalar, configurar ou desinstalar o SQL Server no Windows a partir do prompt de comando, abordando os parâmetros exclusivos dos componentes de aprendizado de máquina em R e Python.

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.

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

  • Execute comandos em um prompt de comando elevado.

  • Uma instância do Mecanismo de Banco de Dados é necessária para instalações dentro do banco de dados. Você não pode instalar apenas recursos em R ou Python, embora possa adicioná-los incrementalmente a uma instância existente. Se você quiser apenas R e Python sem o Mecanismo de Banco de Dados, instale o servidor independente.

  • Não instale em um cluster de failover. O mecanismo de segurança usado para isolar processos em R e Python não é compatível com um ambiente de cluster de failover do Windows Server.

  • Não instale em um controlador de domínio. A parte de Machine Learning Services da instalação falha.

  • Evite instalar instâncias autônomas e em banco de dados no mesmo computador. Um servidor independente compete pelos mesmos recursos, prejudicando o desempenho de ambas as instalações.

Argumentos de linha de comando

Você deve incluir o /FEATURES argumento e concordar com os termos de licenciamento.

Quando você instala pelo prompt de comando, o SQL Server suporta modo silencioso total usando o /Q parâmetro, ou modo Quiet Simple usando o /QS parâmetro. O /QS switch só mostra progresso, não aceita nenhuma entrada e não exibe mensagens de erro caso encontre alguma. O /QS parâmetro só é suportado quando você especifica /Action=install.

Argumentos de linha de comando para SQL Server 2017

Argumentos Descrição
/FEATURES = AdvancedAnalytics Instala a versão no banco de dados: Serviços de Machine Learning do SQL Server (no banco de dados).
/FEATURES = SQL_INST_MR Combine esse argumento com AdvancedAnalytics. Instala o recurso de R (no banco de dados), incluindo o Microsoft R Open e os pacotes de R proprietários.
/FEATURES = SQL_INST_MPY Combine esse argumento com AdvancedAnalytics. Instala o recurso de Python (no banco de dados), incluindo o Anaconda e os pacotes de Python proprietários.
/FEATURES = SQL_SHARED_MR Instala o recurso de R para a versão autônoma: SQL Server Machine Learning Server (autônomo). Um servidor independente é um "recurso compartilhado" que não está vinculado a uma instância do Mecanismo de Banco de Dados.
/FEATURES = SQL_SHARED_MPY Instala o recurso de Python para a versão autônoma: SQL Server Machine Learning Server (autônomo). Um servidor independente é um "recurso compartilhado" que não está vinculado a uma instância do Mecanismo de Banco de Dados.
/IACCEPTROPENLICENSETERMS Indica que você aceita os termos de licença para usar os componentes código aberto do R.
/IACCEPTPYTHONLICENSETERMS Indica que você aceita os termos da licença para usar os componentes em Python.
/IACCEPTSQLSERVERLICENSETERMS Indica que você aceita os termos de licença para usar o SQL Server.
/MRCACHEDIRECTORY Para a instalação offline, define a pasta que contém os arquivos CAB do componente de R.
/MPYCACHEDIRECTORY Reservado para uso futuro. Uso %TEMP% para armazenar arquivos CAB de componentes Python para instalação em computadores que não têm conexão com a internet.

Argumentos de linha de comando para SQL Server 2019

Argumentos Descrição
/FEATURES = AdvancedAnalytics Instala a versão no banco de dados: Serviços de Machine Learning do SQL Server (no banco de dados).
/FEATURES = SQL_INST_MR Combine esse argumento com AdvancedAnalytics. Instala o recurso de R (no banco de dados), incluindo o Microsoft R Open e os pacotes de R proprietários.
/FEATURES = SQL_INST_MPY Combine esse argumento com AdvancedAnalytics. Instala o recurso de Python (no banco de dados), incluindo o Anaconda e os pacotes de Python proprietários.
/FEATURES=SQL_INST_MJAVA Combine isso com AdvancedAnalytics. Instala o recurso Java (no banco de dados), incluindo o Open JRE. Aplica-se à Extensão de Linguagem Java do SQL Server.
/FEATURES = SQL_SHARED_MR Instala o recurso de R para a versão autônoma: SQL Server Machine Learning Server (autônomo). Um servidor independente é um "recurso compartilhado" que não está vinculado a uma instância do Mecanismo de Banco de Dados.
/FEATURES = SQL_SHARED_MPY Instala o recurso de Python para a versão autônoma: SQL Server Machine Learning Server (autônomo). Um servidor independente é um "recurso compartilhado" que não está vinculado a uma instância do Mecanismo de Banco de Dados.
/IACCEPTROPENLICENSETERMS Indica que você aceita os termos de licença para usar os componentes código aberto do R.
/IACCEPTPYTHONLICENSETERMS Indica que você aceita os termos da licença para usar os componentes em Python.
/IACCEPTSQLSERVERLICENSETERMS Indica que você aceita os termos de licença para usar o SQL Server.
/MRCACHEDIRECTORY Para a instalação offline, define a pasta que contém os arquivos CAB do componente de R.
/MPYCACHEDIRECTORY Reservado para uso futuro. Uso %TEMP% para armazenar arquivos CAB de componentes Python para instalação em computadores que não têm conexão com a internet.

Argumentos de linha de comando para SQL Server 2022

Argumentos Descrição
/FEATURES = AdvancedAnalytics Instala a versão no banco de dados: Serviços de Machine Learning do SQL Server (no banco de dados).
/IACCEPTSQLSERVERLICENSETERMS Indica que você aceita os termos de licença para usar o SQL Server.

Instalações da instância no banco de dados

Análises dentro do banco de dados estão disponíveis para instâncias do Mecanismo de Banco de Dados. Você precisa de uma instância do Mecanismo de Banco de Dados para adicionar o AdvancedAnalytics recurso à sua instalação. Você pode instalar uma instância do Mecanismo de Banco de Dados com Advanced Analytics ou adicioná-la a uma instância existente.

Para visualizar informações de progresso sem os avisos interativos exibidos na tela, use o argumento /qs.

Importante

Após a instalação, restam duas etapas de configuração adicionais. A integração só está completa quando você realiza essas tarefas. Confira Configuração pós-instalação para obter instruções.

SQL Server 2022 Machine Learning Services: Mecanismo de Banco de Dados, Análise Avançada

Forneça o nome da instância e uma conta de administrador (Windows) para uma instalação simultânea da instância do Mecanismo de Banco de Dados. Inclua recursos para instalação de componentes principais e de linguagem, e aceite todos os termos de licenciamento.

Setup.exe /qs /ACTION=Install /FEATURES=SQLEngine,ADVANCEDANALYTICS
/INSTANCENAME=MSSQLSERVER /SQLSYSADMINACCOUNTS="<Windows-username>"
/IACCEPTSQLSERVERLICENSETERMS

SQL Server Machine Learning Serviços: Mecanismo de Banco de Dados, Análise Avançada com Python e R

Forneça o nome da instância e uma conta de administrador (Windows) para uma instalação simultânea da instância do Mecanismo de Banco de Dados. Inclua recursos para instalação de componentes principais e de linguagem, e aceite todos os termos de licenciamento.

Setup.exe /qs /ACTION=Install /FEATURES=SQLEngine,ADVANCEDANALYTICS,SQL_INST_MR,SQL_INST_MPY
/INSTANCENAME=MSSQLSERVER /SQLSYSADMINACCOUNTS="<Windows-username>"
/IACCEPTSQLSERVERLICENSETERMS /IACCEPTROPENLICENSETERMS /IACCEPTPYTHONLICENSETERMS

Esse comando utiliza um login do SQL Server em uma instância do Mecanismo de Banco de Dados com autenticação mista.

Setup.exe /q /ACTION=Install /FEATURES=SQLEngine,ADVANCEDANALYTICS,SQL_INST_MR,SQL_INST_MPY
/INSTANCENAME=MSSQLSERVER /SECURITYMODE=SQL /SAPWD="%password%" /SQLSYSADMINACCOUNTS="<sql-username>"
/IACCEPTSQLSERVERLICENSETERMS /IACCEPTROPENLICENSETERMS /IACCEPTPYTHONLICENSETERMS

Este exemplo instala apenas Python, mostrando que você pode adicionar uma única linguagem omitindo uma funcionalidade.

Setup.exe /qs /ACTION=Install /FEATURES=SQLEngine,ADVANCEDANALYTICS,SQL_INST_MPY
/INSTANCENAME=MSSQLSERVER /SQLSYSADMINACCOUNTS="<username>"
/IACCEPTSQLSERVERLICENSETERMS  /IACCEPTPYTHONLICENSETERMS

Configuração pós-instalação (obrigatório)

Aplica-se apenas a instalações no banco de dados.

Quando o SQL Setup for SQL Server 2016 (13.x), SQL Server 2017 (14.x) e SQL Server 2019 (15.x) terminar, você recebe uma instância do Mecanismo de Banco de Dados com R e Python, os pacotes Microsoft R e Python, Microsoft R Open, Anaconda, ferramentas, samples e scripts que fazem parte da distribuição.

A partir do SQL Server 2022 (16.x), o SQL Server Setup não instala mais runtimes para R, Python e Java. Em vez disso, instale os runtimes e pacotes personalizados em R e Python que você deseja. Para mais informações, veja Install SQL Server 2022 Machine Learning Services no Windows ou Install SQL Server 2019 Machine Learning Services no Linux.

Conclua a instalação realizando as seguintes tarefas:

  1. Reinicie o serviço Mecanismo de Banco de Dados.

  2. Serviços de Machine Learning do SQL Server: Habilite scripts externos para usar o recurso. Siga as instruções em Instalar os Serviços de Machine Learning do SQL Server (Python e R) no Windows como próxima etapa.

Adicionar Análise Avançada a uma instância existente do Mecanismo de Banco de Dados

Ao adicionar Advanced Analytics no banco de dados a uma instância existente do Mecanismo de Banco de Dados, forneça o nome da instância. Por exemplo, se você instalou anteriormente um SQL Server 2017 ou posterior, Mecanismo de Banco de Dados e Python, poderia usar esse comando para adicionar R.

Setup.exe /qs /ACTION=Install /FEATURES=SQL_INST_MR /INSTANCENAME=MSSQLSERVER
/IACCEPTSQLSERVERLICENSETERMS  /IACCEPTROPENLICENSETERMS

Adicionar Análise Avançada a uma instância existente do Mecanismo de Banco de Dados

Quando você adiciona Advanced Analytics dentro do banco de dados a uma instância existente do Mecanismo de Banco de Dados, forneça o nome da instância. Por exemplo, se você já instalou um SQL Server 2022 (16.x) e um Mecanismo de Banco de Dados posterior, pode adicionar o recurso Machine Learning Services usando o seguinte comando:

Setup.exe /qs /ACTION=Install /FEATURES=ADVANCEDANALYTICS /INSTANCENAME=MSSQLSERVER
/IACCEPTSQLSERVERLICENSETERMS  /IACCEPTROPENLICENSETERMS

Instalação silenciosa do SQL Server 2022

Para uma instalação silenciosa do SQL Server 2022 (16.x), use o seguinte exemplo:

Setup.exe /q /ACTION=Install /FEATURES=SQLEngine,ADVANCEDANALYTICS
/INSTANCENAME=MSSQLSERVER /SQLSYSADMINACCOUNTS="<username>"
/IACCEPTSQLSERVERLICENSETERMS

Instalação silenciosa

Uma instalação silenciosa suprime a verificação dos locais de arquivos .cab. Por esse motivo, você precisa especificar a localização em que os arquivos .cab devem ser desempacotados. Para Python, coloque arquivos CAB em %TEMP%. Para R, defina o caminho da pasta usando o diretório temporário.

Setup.exe /q /ACTION=Install /FEATURES=SQLEngine,ADVANCEDANALYTICS,SQL_INST_MR,SQL_INST_MPY
/INSTANCENAME=MSSQLSERVER /SQLSYSADMINACCOUNTS="<username>"
/IACCEPTSQLSERVERLICENSETERMS /IACCEPTROPENLICENSETERMS /IACCEPTPYTHONLICENSETERMS
/MRCACHEDIRECTORY=%temp%

Instalações de servidor autônomo

Aplica-se a: SQL Server 2016 (13.x), SQL Server 2017 (14.x) e SQL Server 2019 (15.x) apenas.

Importante

O suporte para Machine Learning Server (conhecido anteriormente como Microsoft R Server) terminou em 1º de julho de 2022. Para obter mais informações, confira O que está acontecendo com Machine Learning Server?

Um servidor independente é um recurso compartilhado que não está vinculado a uma instância do Mecanismo de Banco de Dados. Os exemplos a seguir mostram uma sintaxe válida para a instalação do servidor autônomo.

O SQL Server Machine Learning Server dá suporte a Python e R em um servidor autônomo:

Setup.exe /q /ACTION=Install /FEATURES=SQL_SHARED_MR,SQL_SHARED_MPY
/IACCEPTROPENLICENSETERMS /IACCEPTPYTHONLICENSETERMS /IACCEPTSQLSERVERLICENSETERMS

Quando o SQL Server Setup for SQL Server 2016 (13.x), SQL Server 2017 (14.x) e SQL Server 2019 (15.x) terminar, você recebe um servidor, pacotes da Microsoft, distribuições open-source de R e Python, ferramentas, exemplos e scripts que fazem parte da distribuição.

A partir do SQL Server 2022 (16.x), o SQL Server Setup não instala mais runtimes para R, Python e Java. Em vez disso, instale os runtimes e pacotes personalizados em R e Python que você deseja. Para mais informações, veja Install SQL Server 2022 Machine Learning Services no Windows ou Install SQL Server 2019 Machine Learning Services no Linux.

Para abrir uma janela de console R, vá até \Program files\Microsoft SQL Server\<nnn>\R_SERVER\bin\x64 (onde <nnn> é 150, 140, ou 130), e selecione RGui.exe. Para mais informações, veja Comandos Basic R e funções RevoScaleR: 25 exemplos comuns.

Para abrir um comando Python, vá para \Program files\Microsoft SQL Server\<nnn>\PYTHON_SERVER\bin\x64 (onde <nnn> é 150 ou 140), e selecione python.exe.