Instale o SQL Server Machine Learning Services com R e Python na linha de comandos

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

Este artigo fornece instruções para instalar SQL Server Machine Learning Services com Python e R a partir de uma linha de comandos.

Pode especificar uma interação silenciosa, básica ou completa com a interface de utilizador da Instalação. Este artigo complementa Instalar, configurar ou desinstalar o SQL Server no Windows a partir do prompt de comandos, abordando os parâmetros únicos dos componentes de aprendizagem automática R e Python.

Note

Os recursos e as opções de instalação variam entre as versões do SQL Server. Utilize o menu suspenso do seletor de versão para escolher a versão apropriada do SQL Server.

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

  • Execute comandos a partir de um prompt de comandos elevado.

  • Uma instância do Database Engine é necessária para instalações dentro da base de dados. Não podes instalar apenas funcionalidades em R ou Python, embora possas adicioná-las incrementalmente a uma instância existente. Se quiseres apenas R e Python sem o Database Engine, instala o servidor autónomo.

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

  • Não instales num controlador de domínio. A componente Machine Learning Services da instalação falha.

  • Evite instalar instâncias autónomas e dentro da base de dados no mesmo computador. Um servidor autónomo compete pelos mesmos recursos, prejudicando o desempenho de ambas as instalações.

Argumentos de linha de comando

Deve incluir o argumento /FEATURES e concordar com os termos de licenciamento.

Quando instala através do prompt de comandos, o SQL Server suporta modo silencioso total usando o /Q parâmetro, ou modo Quiet Simple usando o /QS parâmetro. O /QS interruptor só mostra progresso, não aceita qualquer entrada e não apresenta mensagens de erro caso encontre alguma. O /QS parâmetro só é suportado quando especifica /Action=install.

Argumentos de linha de comandos para o SQL Server 2017

Arguments Description
/FEATURES = AdvancedAnalytics Instala a versão na base de dados: SQL Server Machine Learning Services (In-Database).
/FEATURES = SQL_INST_MR Associe este argumento com AdvancedAnalytics. Instala o recurso R (In-Database), incluindo o Microsoft R Open e os pacotes R proprietários.
/FEATURES = SQL_INST_MPY Associe este argumento a AdvancedAnalytics. Instala a funcionalidade Python (In-Database), incluindo o Anaconda e os pacotes Python proprietários.
/FEATURES = SQL_SHARED_MR Instala a funcionalidade R para a versão autónoma: SQL Server Machine Learning Server (Standalone). Um servidor autónomo é uma "funcionalidade partilhada" que não está vinculada a uma instância do Database Engine.
/FEATURES = SQL_SHARED_MPY Instala a funcionalidade Python para a versão autónoma: SQL Server Machine Learning Server (Independente). Um servidor autónomo é uma "funcionalidade partilhada" que não está vinculada a uma instância do Database Engine.
/IACCEPTROPENLICENSETERMS Indica que aceitas os termos da licença para usar os componentes open source do R.
/IACCEPTPYTHONLICENSETERMS Indica que aceitas os termos da licença para usar os componentes Python.
/IACCEPTSQLSERVERLICENSETERMS Indica que aceitas os termos da licença para usar o SQL Server.
/MRCACHEDIRECTORY Para configuração offline, define a pasta que contém os ficheiros CAB do componente R.
/MPYCACHEDIRECTORY Reservado para uso futuro. Uso %TEMP% para armazenar ficheiros CAB de componentes em Python para instalação em computadores que não têm ligação à internet.

Argumentos de linha de comandos para SQL Server 2019

Arguments Description
/FEATURES = AdvancedAnalytics Instala a versão na base de dados: SQL Server Machine Learning Services (In-Database).
/FEATURES = SQL_INST_MR Associe este argumento a AdvancedAnalytics. Instala o recurso R (In-Database), incluindo o Microsoft R Open e os pacotes R proprietários.
/FEATURES = SQL_INST_MPY Associe este argumento a AdvancedAnalytics. Instala a funcionalidade Python (In-Database), incluindo o Anaconda e os pacotes Python proprietários.
/FEATURES=SQL_INST_MJAVA Combine isto com AdvancedAnalytics. Instala a funcionalidade Java (In-Database), incluindo o Open JRE. Aplica-se a Extensão de Linguagem Java do SQL Server.
/FEATURES = SQL_SHARED_MR Instala a funcionalidade R para a versão autónoma: SQL Server Machine Learning Server (Standalone). Um servidor autónomo é uma "funcionalidade partilhada" que não está vinculada a uma instância do Database Engine.
/FEATURES = SQL_SHARED_MPY Instala a funcionalidade Python para a versão autónoma: SQL Server Machine Learning Server (Independente). Um servidor autónomo é uma "funcionalidade partilhada" que não está vinculada a uma instância do Database Engine.
/IACCEPTROPENLICENSETERMS Indica que aceitas os termos da licença para usar os componentes open source do R.
/IACCEPTPYTHONLICENSETERMS Indica que aceitas os termos da licença para usar os componentes Python.
/IACCEPTSQLSERVERLICENSETERMS Indica que aceitas os termos da licença para usar o SQL Server.
/MRCACHEDIRECTORY Para configuração offline, define a pasta que contém os ficheiros CAB do componente R.
/MPYCACHEDIRECTORY Reservado para uso futuro. Uso %TEMP% para armazenar ficheiros CAB de componentes em Python para instalação em computadores que não têm ligação à internet.

Argumentos de linha de comandos para o SQL Server 2022

Arguments Description
/FEATURES = AdvancedAnalytics Instala a versão na base de dados: SQL Server Machine Learning Services (In-Database).
/IACCEPTSQLSERVERLICENSETERMS Indica que aceitas os termos da licença para usar o SQL Server.

Instalação de instâncias na própria base de dados

Análises dentro da base de dados estão disponíveis para instâncias do Database Engine. Precisas de uma instância do Database Engine para adicionar a AdvancedAnalytics funcionalidade à tua instalação. Pode instalar uma instância do Database Engine com Advanced Analytics, ou adicioná-la a uma instância existente.

Para ver informações de progresso sem os pedidos interativos apresentados no ecrã, utilize o argumento /qs.

Importante

Após a instalação, restam dois passos adicionais de configuração. A integração só está completa até realizares estas tarefas. Consulte a configuração pós-instalação para instruções.

SQL Server 2022 Machine Learning Services: Database Engine, 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 Database Engine. Incluir funcionalidades para instalar componentes centrais e de linguagem, e aceitar 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: Database Engine, 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 Database Engine. Incluir funcionalidades para instalar componentes centrais e de linguagem, e aceitar 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 comando utiliza um login do SQL Server numa instância do Database Engine 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 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ória)

Aplica-se apenas a instalações dentro da base de dados.

Quando a instalação do SQL Server 2016 (13.x), do SQL Server 2017 (14.x) e do SQL Server 2019 (15.x) estiver concluída, obtém uma instância do Database Engine com R e Python, os pacotes Microsoft R e Python, o Microsoft R Open, o Anaconda, ferramentas, exemplos e scripts que fazem parte da distribuição.

A partir do SQL Server 2022 (16.x), o SQL Server Setup deixa de instalar runtimes para R, Python e Java. Em vez disso, instala os runtimes e pacotes personalizados de R e Python que desejas. Para mais informações, consulte 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. SQL Server Machine Learning Services: Ative os scripts externos antes de poder utilizar esta funcionalidade. Siga as instruções em Instalar os Serviços Machine Learning do SQL Server (Python e R) no Windows como passo seguinte.

Adicionar Análise Avançada a uma instância existente do Database Engine

Ao adicionar Advanced Analytics na base de dados a uma instância existente do Database Engine, forneça o nome da instância. Por exemplo, se instalou anteriormente um SQL Server 2017 ou posterior, Database Engine e Python, pode usar este 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 Database Engine

Ao adicionar o Advanced Analytics na base de dados a uma instância existente do Motor de Base de Dados, forneça o nome da instância. Por exemplo, se instalou anteriormente um SQL Server 2022 (16.x) e um Database Engine posterior, pode adicionar a funcionalidade Machine Learning Services usando o seguinte comando:

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

Instalação silenciosa para SQL Server 2022

Para uma instalação silenciosa do SQL Server 2022 (16.x), utilize 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 da localização de .cab ficheiros. Por esta razão, deve especificar o local onde os ficheiros .cab devem ser descompactados. Para Python, coloque ficheiros 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 servidores independentes

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

Importante

O suporte ao Machine Learning Server (anteriormente conhecido como R Server) terminou a 1 de julho de 2022. Para obter mais informações, consulte O que está acontecendo com o Servidor de Aprendizado de Máquina?

Um servidor autónomo é uma funcionalidade partilhada que não está vinculada a uma instância do Database Engine. Os exemplos seguintes mostram uma sintaxe válida para a instalação do servidor autónomo.

SQL Server Machine Learning Server suporta Python e R num servidor autónomo:

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

Quando termina a instalação do SQL Server Setup para o SQL Server 2016 (13.x), SQL Server 2017 (14.x) e SQL Server 2019 (15.x), obtém um servidor, pacotes da Microsoft, distribuições de código aberto de R e Python, ferramentas, amostras e scripts incluídos na distribuição.

A partir do SQL Server 2022 (16.x), o SQL Server Setup deixa de instalar runtimes para R, Python e Java. Em vez disso, instala os runtimes e pacotes personalizados de R e Python que desejas. Para mais informações, consulte Install SQL Server 2022 Machine Learning Services no Windows ou Install SQL Server 2019 Machine Learning Services no Linux.

Para abrir uma janela de consola R, vá a \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á a \Program files\Microsoft SQL Server\<nnn>\PYTHON_SERVER\bin\x64 (onde <nnn> é 150 ou 140), e selecione python.exe.