Compartilhar via


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 o artigo Instalar o SQL Server do prompt de comando, que aborda parâmetros exclusivos dos componentes de aprendizado de máquina de 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 os comandos de um prompt de comandos com privilégios elevados.

  • Para instalações no banco de dados, uma instância do mecanismo de banco de dados é necessária. Não é possível instalar apenas os recursos do R ou do Python, embora seja possível adicioná-los incrementalmente a uma instância existente. Se quiser apenas o R e o Python sem o mecanismo de banco de dados, instale o servidor autônomo.

  • Não instale em um cluster de failover. O mecanismo de segurança usado para isolar processos de 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 dos Serviços de Machine Learning da instalação falhará.

  • Evite instalar instâncias autônomas e no banco de dados no mesmo computador. Um servidor autônomo competirá pelos mesmos recursos, prejudicando o desempenho das duas instalações.

Argumentos de linha de comando

O argumento /FEATURES é obrigatório, assim como os contratos de termo de licenciamento.

Quando você instala pelo prompt de comando, o SQL Server dá suporte ao modo silencioso completo usando o parâmetro /Q ou o modo Silencioso Simples usando o parâmetro /QS. A opção /QS mostra apenas o andamento, não aceita entradas e não exibe mensagens de erro, se encontrado. O parâmetro /QS só tem suporte quando /Action=install é especificado.

Argumentos de linha de comando do SQL Server 2016

Argumentos Descrição
/FEATURES = AdvancedAnalytics Instala a versão no banco de dados: SQL Server R Services (no banco de dados).
/FEATURES = SQL_SHARED_MR Instala o recurso de R para a versão autônoma: SQL Server R Server (autônomo). Um servidor autônomo é um "recurso compartilhado" não associado a uma instância do mecanismo de banco de dados.
/IACCEPTROPENLICENSETERMS Indica que você aceitou os termos de licença para usar os componentes de software livre do R.
/IACCEPTPYTHONLICENSETERMS Indica que você aceitou os termos de licença para usar os componentes do Python.
/IACCEPTSQLSERVERLICENSETERMS Indica que você aceitou 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.

Argumentos de linha de comando do 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 Use em conjunto 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 Use em conjunto 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 autônomo é um "recurso compartilhado" não associado 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 autônomo é um "recurso compartilhado" não associado a uma instância do mecanismo de banco de dados.
/IACCEPTROPENLICENSETERMS Indica que você aceitou os termos de licença para usar os componentes de software livre do R.
/IACCEPTPYTHONLICENSETERMS Indica que você aceitou os termos de licença para usar os componentes do Python.
/IACCEPTSQLSERVERLICENSETERMS Indica que você aceitou 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. Use %TEMP% para armazenar arquivos CAB do componente de Python para instalação em computadores que não têm uma conexão com a Internet.

Argumentos de linha de comando do 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 Use em conjunto 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 Use em conjunto 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 Use em conjunto 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 autônomo é um "recurso compartilhado" não associado 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 autônomo é um "recurso compartilhado" não associado a uma instância do mecanismo de banco de dados.
/IACCEPTROPENLICENSETERMS Indica que você aceitou os termos de licença para usar os componentes de software livre do R.
/IACCEPTPYTHONLICENSETERMS Indica que você aceitou os termos de licença para usar os componentes do Python.
/IACCEPTSQLSERVERLICENSETERMS Indica que você aceitou 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. Use %TEMP% para armazenar arquivos CAB do componente de Python para instalação em computadores que não têm uma conexão com a Internet.

Argumentos de linha de comando do 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ê aceitou os termos de licença para usar o SQL Server.

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

A análise no banco de dados está disponível para instâncias do mecanismo de banco de dados, necessárias para adicionar o recurso AdvancedAnalytics à sua instalação. Você pode instalar uma instância do mecanismo de banco de dados com análise avançada ou adicioná-la a uma instância existente.

Para exibir informações de progresso sem os prompts de tela interativos, use o argumento /qs.

Importante

Após a instalação, restam duas etapas de configuração adicionais. A integração não é concluída até que essas tarefas sejam executadas. Confira Configuração pós-instalação para obter instruções.

Serviços de Machine Learning do SQL Server 2022: mecanismo de banco de dados, análise avançada

Para instalação simultânea da instância do mecanismo de banco de dados, forneça o nome da instância e um logon do administrador (Windows). Inclua os recursos para instalar componentes de núcleo e de linguagem, bem como a aceitação de todos os termos de licenciamento.

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

Serviços de Machine Learning do SQL Server: mecanismo de banco de dados, análise avançada com Python e R

Para instalação simultânea da instância do mecanismo de banco de dados, forneça o nome da instância e um logon do administrador (Windows). Inclua os recursos para instalar componentes de núcleo e de linguagem, bem como a aceitação de 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

Este é o mesmo comando, mas com um logon do SQL Server em um mecanismo de banco de dados usando 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 é referente somente ao Python, mostrando que você pode adicionar uma linguagem omitindo um recurso.

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

SQL Server R Services: mecanismo de banco de dados e análise avançada com R

Para instalação simultânea da instância do mecanismo de banco de dados, forneça o nome da instância e um logon do administrador (Windows). Inclua os recursos para instalar componentes de núcleo e de linguagem, bem como a aceitação de todos os termos de licenciamento.

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

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

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

Quando a Instalação de SQL do Server 2016 (13.x), do SQL Server 2017 (14.x) e do SQL Server 2019 (15.x) for concluída, você contará com uma instância do mecanismo de banco de dados com R e Python, os pacotes R e Python da Microsoft, o Microsoft R Open, o Anaconda, ferramentas, exemplos e scripts que fazem parte da distribuição.

A partir do SQL Server 2022 (16.x), os runtimes do R, do Python e do Java não são mais instalados com a Instalação do SQL. Portanto, instale os pacotes e os runtimes personalizados R e/ou Python desejados. Para obter mais informações, confira Instalar os Serviços de Machine Learning do SQL Server 2022 no Windows ou Instalar os Serviços de Machine Learning do SQL Server (Python e R) no Linux.

São necessárias mais duas tarefas para concluir a instalação:

  1. Reiniciar o serviço do 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 (no Banco de Dados) como a próxima etapa.

  1. Reiniciar o serviço do mecanismo de banco de dados.

  2. SQL Server R Services: Habilite scripts externos para usar o recurso. Siga as instruções em Instalar os serviços R do SQL Server (no banco de dados) como a próxima etapa.

Adicionar análise avançada a uma instância de mecanismo de banco de dados existente

Ao adicionar análise avançada no banco de dados a uma instância do mecanismo de banco de dados existente, forneça o nome da instância. Por exemplo, se tiver instalado um mecanismo de banco de dados do SQL Server 2017 ou posterior e o Python, você poderá usar esse comando para adicionar o R.

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

Adicionar análise avançada a uma instância de mecanismo de banco de dados existente

Ao adicionar análise avançada no banco de dados a uma instância do mecanismo de banco de dados existente, forneça o nome da instância. Por exemplo, se você já tiver instalado um mecanismo de banco de dados do SQL Server 2022 (16.x) e posterior, poderá adicionar o recurso Serviços de Machine Learning com o seguinte:

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, os arquivos CAB devem estar em %TEMP*. Para R, você pode definir 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 do servidor autônomo

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?

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

Um servidor autônomo é um "recurso compartilhado" não associado 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

SQL Server R Server é destinado somente ao R:

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

Quando a Instalação de SQL do SQL Setup for SQL Server 2016 (13.x), SQL Server 2017 (14.x) e SQL Server 2019 (15.x) for concluída, você contará com um servidor, pacotes da Microsoft, distribuições R e Python de código aberto, ferramentas, exemplos e scripts que fazem parte da distribuição.

A partir do SQL Server 2022 (16.x), os runtimes do R, do Python e do Java não são mais instalados com a Instalação do SQL. Portanto, instale os pacotes e os runtimes personalizados R e/ou Python desejados. Para obter mais informações, confira Instalar os Serviços de Machine Learning do SQL Server 2022 no Windows ou Instalar os Serviços de Machine Learning do SQL Server (Python e R) no Linux.

Para abrir uma janela do console do R, vá para \Program files\Microsoft SQL Server\150(or 140,130)\R_SERVER\bin\x64 e clique duas vezes em RGui.exe. Você é novo no R? Experimente este tutorial: Comandos básicos de R e funções RevoScaleR: 25 exemplos comuns.

Para abrir um comando do Python, vá para \Program files\Microsoft SQL Server\150 (or 140)\PYTHON_SERVER\bin\x64 e clique duas vezes em Python.exe.

Próximas etapas

Os desenvolvedores do Python podem aprender a usar o Python com o SQL Server seguindo estes tutoriais:

Os desenvolvedores do R podem começar com alguns exemplos simples e aprender os fundamentos de como o R funciona com o SQL Server. Para a próxima etapa, confira os links a seguir: