Instalar os Serviços de Machine Learning do SQL Server 2022 (R e Python) no Linux

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

Este artigo explica como instalar o Serviços de Machine Learning do SQL Server no Linux. Os scripts Python e R podem ser executados no banco de dados usando os Serviços de Machine Learning.

Você pode instalar os Serviços de Machine Learning no Ubuntu e no RHEL (Red Hat Enterprise Linux). Atualmente, o SLES (SUSE Linux Enterprise Server) não tem suporte.

Você pode instalar os Serviços de ML em um contêiner do Docker que execute uma distribuição do Linux. Dentro do contêiner do Docker, as etapas seriam as mesmas que abaixo.

Para obter mais informações, confira a seção Plataformas com suporte nas Diretrizes de instalação do SQL Server em Linux.

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

• Instale o SQL Server em Linux e confirme a instalação.

• Verifique os repositórios do SQL Server no Linux das extensões do Python e do R. Se você já configurou os repositórios de origem para a instalação do mecanismo de banco de dados, execute os comandos de instalação de pacote mssql-server-extensibility usando o mesmo registro de repositório.

• Você deve ter uma ferramenta para executar comandos T-SQL.

  • Você pode usar o Azure Data Studio, uma ferramenta de banco de dados gratuita que é executada no Linux, no Windows e no macOS.

• Será necessário reiniciar a instância de SQL Server durante esse processo de instalação.

Lista de pacotes

Em um dispositivo conectado à Internet, os pacotes são baixados e instalados independentemente do mecanismo de banco de dados usando o instalador de pacote para cada sistema operacional.

Pacotes de instalação disponíveis para o SQL Server 2022 (16.x) no Linux:

Instalar o pacote mssql-server-extensibility

1. Configure repositórios Linux correspondentes à distribuição do Linux. Instale o recurso de extensibilidade do SQL Server com o pacote mssql-server-extensibility e a dependência associada libssl-dev.

   Ubuntu

   sudo apt-get install mssql-server-extensibility libssl-dev
   

   RHEL

   yum install mssql-server-extensibility
   

2. Examine e aceite o EULA (Contrato de Licença de Usuário Final) para Serviços de ML do SQL Server.

   sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y
   

   Para concluir a aceitação do EULA, a instância do SQL Server deve ser reiniciada.

   sudo systemctl restart mssql-server
   

Instalar runtimes e pacotes

Suporte à instalação do R

Instalar runtime do R

1. Baixe e instale a versão do R desejada. Escolha uma versão do R 4.2 ou superior, disponível para download diretamente de cran.r-project.org. Siga as instruções para o runtime desejado.

2. Abra um terminal R de administração:

   sudo R
   

3. Instale as dependências de 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")
   

4. Baixe e instale 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")
   

5. Verifique a instalação do RevoScaleR no terminal do R.

   library("RevoScaleR")
   

Configurar o runtime do R com SQL Server

1. Configure o runtime do R instalado com o SQL Server para Linux, em que path/to/ é o caminho do arquivo para o binário R e RFolderVersion é o nome da pasta específica da versão da instalação do runtime do R, por exemplo, R4.2.

   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
   

2. Reinicie o serviço Launchpadd .

   systemctl restart mssql-launchpadd.service
   

3. Configure o SQL Server para Linux a fim de permitir scripts externos usando o procedimento armazenado do sistema sp_configure.

   EXEC sp_configure 'external scripts enabled', 1;
   GO
   RECONFIGURE
   GO
   

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

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

Configurar o suporte ao Python

Instalar o runtime do Python

1. Baixe e instale o Python. Escolha a versão Python 3.10 especificamente, disponível para download diretamente de python.org. Siga as instruções fornecidas. Além disso, instale a biblioteca de runtime do Python compartilhada para a versão de runtime desejada. Por exemplo, para instalar libpython3.10 para o Ubuntu: sudo apt-get install libpython3.10.

2. Baixe e instale revoscalepy para o usuário raiz.

   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
   

3. Verifique a instalação do revoscalepy no terminal do Python. Verifique se a biblioteca pode ser importada.

   import revoscalepy
   

Configurar o runtime do Python com SQL Server

1. Configure o runtime do Python instalado com SQL Server, em que pythonbinbath é definido como o caminho do binário do Python instalado e datadirectories inclui o caminho em que os pacotes são instalados para a versão desejada do Python, por exemplo, /usr/lib/python3.10/dist-packages. Use o seguinte script com o caminho de instalação real:

   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
   

2. Reinicie o serviço Launchpadd .

   systemctl restart mssql-launchpadd.service
   

3. Configure o SQL Server para Linux a fim de permitir scripts externos usando o procedimento armazenado do sistema sp_configure.

   EXEC sp_configure 'external scripts enabled', 1;
   GO
   RECONFIGURE
   GO
   

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

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

Instalar o Java

Para instalar a extensão de linguagem Java, confira Instalar a extensão da linguagem Java do SQL Server em Linux.

Verifique a instalação

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

• Execute um script T-SQL que executa um procedimento armazenado do sistema invocando o Python ou o R com uma ferramenta de consulta.

• Execute o comando do SQL a seguir para testar a execução do R no SQL Server. Erros? Tente executar uma reinicialização do serviço, sudo systemctl restart mssql-server.service.

  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 
  

• Execute o comando do SQL a seguir para testar a execução do Python no SQL Server.

  EXEC 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 conhecer as etapas da instalação dos pacotes. Localize o site de download e baixe os pacotes específicos usando a lista de pacotes abaixo.

Pacotes autônomos do RevoScale para runtime do Python e do R

Os pacotes RevoScale também são compatíveis como pacotes autônomos com runtimes do Python e do R. Para configurar o runtime do Python ou do R para o cenário autônomo, siga as instruções nas seções Instalar runtime do Python e Instalar runtime do R, respectivamente.

Conteúdo relacionado

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

• Tutorial do Python: Prever o aluguel de esquis com regressão linear nos Serviços de Machine Learning do SQL Server
• Tutorial do Python: Categorizar clientes que usam cluster K-means com Serviços de Machine Learning do SQL Server

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:

• Início Rápido: Executar o R no T-SQL
• Tutorial: Análise interna no banco de dados para desenvolvedores de R