Instale os Serviços de Aprendizagem Automática do SQL Server 2022 (Python e R) no Linux

Aplica-se a: SQL Server 2022 (16.x) em Linux

Este artigo orienta-o na instalação dos Serviços de Aprendizagem Automática SQL Server no Linux. Scripts Python e R podem ser executados na base de dados usando Serviços de Aprendizagem Automática.

Pode instalar Serviços de Aprendizagem Automática no Ubuntu e Red Hat Enterprise Linux (RHEL). O SUSE Linux Enterprise Server (SLES) não é suportado.

Podes instalar Machine Learning Services num contentor Docker a correr uma distribuição Linux. Dentro do contentor Docker, os passos são os seguintes.

Para mais informações, consulte a secção Plataformas Suportadas na orientação de instalação do SQL Server no Linux.

Importante

Este artigo refere-se ao SQL Server 2022 (16.x). Para SQL Server 2019 em Linux, veja Install SQL Server 2019 Machine Learning Services (Python e R) em Linux. Para SQL Server no Windows, veja Instalar SQL Server 2022 Machine Learning Services (Python e R) no Windows.

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

Instala o SQL Server no Linux e verifica a instalação.
Verifique os repositórios SQL Server Linux para as extensões Python e R. Se já configurou repositórios de origem para a instalação do motor de base de dados, pode executar os comandos de instalação do pacote mssql-server-extensibility usando o mesmo registo de repositório.
Você deve ter uma ferramenta para executar comandos Transact-SQL (T-SQL).
- Você pode se conectar a uma instância do SQL Server usando qualquer ferramenta de cliente familiar do SQL Server, como sqlcmd, SQL Server Management Studio (SSMS) ou a extensão MSSQL para Visual Studio Code.
Será necessário reiniciar a instância do SQL Server durante este processo de instalação.

Lista de pacotes

Num dispositivo ligado à internet, os pacotes são descarregados e instalados independentemente do motor de base de dados usando o instalador de pacotes para cada sistema operativo.

O seguinte pacote de instalação está disponível para SQL Server 2022 (16.x) em Linux:

Nome do pacote	Aplicável a	Description
`mssql-server-extensibility`	Todos	Framework de extensibilidade usado para executar Python e R.

Instalar o pacote mssql-server-extensibility

Configurar repositórios para instalar e atualizar o SQL Server no Linux correspondente à distribuição Linux. Instale a funcionalidade de extensibilidade do SQL Server com o pacote mssql-server-extensibility e a dependência libssl-devassociada .

Ubuntu
```
sudo apt-get install mssql-server-extensibility libssl-dev
```
RHEL
```
yum install mssql-server-extensibility
```
Revise e aceite o Acordo de Licença de Utilizador Final (EULA) para SQL Server Machine Learning Serviços.
```
sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y
```
Para completar a aceitação do EULA, a instância do SQL Server deve ser reiniciada.
```
sudo systemctl restart mssql-server
```

Configuração do suporte R

Instalar o ambiente de execução do R

Descarregue e instale a versão do R que desejarem. Escolha uma versão do R 4.2 ou superior, disponível para download direto da cran.r-project.org. Siga as instruções para o tempo de execução desejado.
Abrir um terminal R de administrador:
```
sudo R
```

Instale dependências para CompatibilityAPI e RevoScaleR executando o seguinte:

# R Terminal
install.packages("iterators", lib="/usr/lib/R/library")
install.packages("foreach", lib="/usr/lib/R/library")
install.packages("R6", lib="/usr/lib/R/library")
install.packages("jsonlite", lib="/usr/lib/R/library")

Descarregar e instalar CompatibilityAPI e RevoScaleR para Linux.

install.packages("https://aka.ms/sqlml/r4.2/linux/CompatibilityAPI_1.1.0_R_x86_64-pc-linux-gnu.tar.gz", repos=NULL, lib="/usr/lib/R/library")
install.packages("https://aka.ms/sqlml/r4.2/linux/RevoScaleR_10.0.1_R_x86_64-pc-linux-gnu.tar.gz", repos=NULL, lib="/usr/lib/R/library")

Verifique a instalação RevoScaleR a partir do terminal R.
```
library("RevoScaleR")
```

Configurar o tempo de execução do R com o SQL Server

Configure o ambiente de execução do R instalado no SQL Server para Linux. Os comandos seguintes utilizam os caminhos de instalação padrão do R. Atualize os caminhos caso tenha instalado o R noutro local.
```
sudo /opt/mssql/bin/mssql-conf set extensibility rbinpath /usr/lib/R/bin/R
sudo /opt/mssql/bin/mssql-conf set extensibility datadirectories /usr/lib/R
```

Reinicie o mssql-launchpadd serviço.

systemctl restart mssql-launchpadd.service

Configure o SQL Server para Linux para permitir scripts externos usando o sp_configure procedimento armazenado do sistema.
```
EXECUTE sp_configure 'external scripts enabled', 1;
GO

RECONFIGURE;
GO
```

Verifique a instalação executando um simples comando T-SQL para devolver a versão do R:

EXECUTE sp_execute_external_script
    @script = N'print(R.version)',
    @language = N'R';
GO

Configuração de suporte para Python

Instalar o ambiente de execução Python

Descarregue e instale Python. Escolha especificamente Python 3.10, disponível para download direto em python.org. Siga as instruções fornecidas. Além disso, instala a biblioteca partilhada em Python para a versão de runtime. Por exemplo, para instalar libpython3.10 no Ubuntu: sudo apt-get install libpython3.10.

Descarregue e instale revoscalepy para o utilizador root.

sudo pip install dill numpy==1.22.0 pandas patsy python-dateutil
sudo pip install https://aka.ms/sqlml/python3.10/linux/revoscalepy-10.0.1-py3-none-any.whl --target=/usr/lib/python3.10/dist-packages

Verifica a revoscalepy instalação a partir do terminal Python. Verifica se a biblioteca pode ser importada.
```
import revoscalepy
```

Configurar o tempo de execução do Python com o SQL Server

Configure o runtime do Python instalado no SQL Server, em que pythonbinpath está definido como o caminho do binário do Python instalado e datadirectories inclui o caminho em que os pacotes estão instalados para a versão pretendida do Python, por exemplo, /usr/lib/python3.10/dist-packages. Use o seguinte script com o seu caminho real de instalação:
```
sudo /opt/mssql/bin/mssql-conf set extensibility pythonbinpath /usr/bin/python3.10
sudo /opt/mssql/bin/mssql-conf set extensibility datadirectories /usr/lib:/usr/lib/python3.10/dist-packages
```

Reinicie o mssql-launchpadd serviço.

systemctl restart mssql-launchpadd.service

Configure o SQL Server para Linux para permitir scripts externos usando o sp_configure procedimento armazenado do sistema.
```
EXECUTE sp_configure 'external scripts enabled', 1;
GO

RECONFIGURE;
GO
```

Verifique a instalação executando um simples comando T-SQL para devolver a versão do Python:

EXECUTE sp_execute_external_script
    @script = N'import sys;print(sys.version)',
    @language = N'Python';
GO

Instalar o Java

Para instalar a extensão da linguagem Java, consulte Instalar a Extensão da Linguagem Java do SQL Server no Linux.

Verificar a instalação

Para validar a instalação, utilize qualquer um dos seguintes métodos:

Execute um script T-SQL que execute um procedimento armazenado do sistema invocando Python ou R usando uma ferramenta de consulta.

Execute o seguinte comando SQL para testar a execução de R no SQL Server. Erros? Tente reiniciar o serviço, sudo systemctl restart mssql-server.service.

EXECUTE 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

Execute o seguinte comando SQL para testar a execução em Python no SQL Server.

EXECUTE sp_execute_external_script
    @language = N'Python',
    @script = N'
      OutputDataSet = InputDataSet;
      ', @input_data_1 = N'SELECT 1 AS hello'
    WITH RESULT SETS
(
        ([hello] INT NOT NULL)
);
GO

Instalação offline

Siga as instruções de instalação offline para os passos de instalação dos pacotes. Encontre o seu site de downloads e depois descarregue pacotes específicos usando a lista de pacotes acima.

Tip

Várias das ferramentas de gestão de pacotes fornecem comandos que podem ajudar a determinar dependências de pacotes. Para yum, use sudo yum deplist [package]. Para o Ubuntu, use sudo apt-get install --reinstall --download-only [package name] seguido de dpkg -I [package name].deb.

Pacotes RevoScale independentes para runtimes em Python e R

Os pacotes RevoScale também são suportados como pacotes autónomos com runtimes em Python e R. Para configurar um ambiente de execução Python ou R para o cenário autónomo, siga as instruções nas secções Instalar o ambiente de execução Python e Instalar o ambiente de execução R, respetivamente.

Comentários

Esta página foi útil?

Last updated on 2026-10-01