Instalar pacotes com ferramentas Python no SQL Server

Aplica-se a: SQL Server 2017 (14.x)

Este artigo descreve como usar ferramentas Python padrão para instalar novos pacotes Python em uma instância do SQL Server Machine Learning Services. Em geral, o processo de instalação de novos pacotes é semelhante ao de um ambiente Python padrão. No entanto, algumas etapas adicionais são necessárias se o servidor não tiver uma conexão com a Internet.

Para obter mais informações sobre o local do pacote e os caminhos de instalação, consulte Obter informações sobre o pacote Python.

Prerequisites

• Você deve ter os Serviços de Aprendizado de Máquina do SQL Server instalados com a opção de linguagem Python.

Outras considerações

• Os pacotes devem ser compatíveis com Python 3.5 e executados no Windows.

• A biblioteca de pacotes Python está localizada na pasta Arquivos de Programas da instância do SQL Server e, por padrão, a instalação nessa pasta requer permissões de administrador. Para obter mais informações, consulte Local da biblioteca de pacotes.

• A instalação de pacotes é feita por instância. Se você tiver várias instâncias dos Serviços de Aprendizado de Máquina, deverá adicionar o pacote a cada uma delas.

• Os servidores de banco de dados são frequentemente bloqueados. Em muitos casos, o acesso à Internet é totalmente bloqueado. Para pacotes com uma longa lista de dependências, você precisará identificar essas dependências com antecedência e estar pronto para instalar cada uma manualmente.

• Antes de adicionar um pacote, considere se o pacote é adequado para o ambiente do SQL Server.

  • Recomendamos que você use Python no banco de dados para tarefas que se beneficiam da integração total com o mecanismo de banco de dados, como aprendizado de máquina, em vez de tarefas que simplesmente consultam o banco de dados.

  • Se você adicionar pacotes que colocam muita pressão computacional no servidor, o desempenho será prejudicado.

  • Em um ambiente SQL Server protegido, convém evitar o seguinte:

    • Pacotes que requerem acesso à rede
    • Pacotes que exigem acesso elevado ao sistema de arquivos
    • Pacotes usados para desenvolvimento da Web ou outras tarefas que não se beneficiam da execução dentro do SQL Server

Adicionar um pacote Python no SQL Server

Para instalar um novo pacote Python que pode ser usado em um script no SQL Server, instale o pacote na instância dos Serviços de Aprendizado de Máquina. Se você tiver várias instâncias dos Serviços de Aprendizado de Máquina, deverá adicionar o pacote a cada uma delas.

O pacote instalado nos seguintes exemplos é o CNTK, uma framework de deep learning da Microsoft que suporta personalização, treino e partilha de diferentes tipos de redes neurais.

Para instalação offline, baixe o pacote Python

Se você estiver instalando pacotes Python em um servidor sem acesso à Internet, você deve baixar o arquivo WHL de um computador com acesso à Internet e, em seguida, copiar o arquivo para o servidor.

Por exemplo, em um computador conectado à Internet, você pode baixar um .whl arquivo para CNTK e, em seguida, copiar o arquivo para uma pasta local no computador SQL Server. Consulte Instalar CNTK a partir de arquivos Wheel para obter uma lista de arquivos .whl disponíveis para CNTK.

Para obter mais informações sobre downloads da estrutura CNTK para várias plataformas e para várias versões do Python, consulte Configurar CNTK em sua máquina.

Encontre a biblioteca Python

Localize o local padrão da biblioteca Python usado pelo SQL Server. Se você tiver instalado várias instâncias, localize a PYTHON_SERVICES pasta da instância onde deseja adicionar o pacote.

Por exemplo, se os Serviços de Aprendizado de Máquina foram instalados usando padrões e o aprendizado de máquina foi habilitado na instância padrão, o caminho é:

cd "C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\PYTHON_SERVICES"

Instale o pacote usando pip

Usa o instalador de pip para instalar novos pacotes. Você pode encontrar pip.exe na Scripts subpasta da PYTHON_SERVICES pasta. A Instalação do SQL Server não adiciona a Scripts subpasta ao caminho do sistema, portanto, você deve especificar o caminho completo ou pode adicionar a pasta Scripts à variável PATH no Windows.

• Se o computador tiver acesso à Internet, forneça o nome do pacote:

  scripts\pip.exe install cntk
  

  Você também pode especificar a URL de um pacote e versão específicos, por exemplo:

  scripts\pip.exe install https://cntk.ai/PythonWheel/CPU-Only/cntk-2.1-cp35-cp35m-win_amd64.whl
  

• Se o computador não tiver acesso à Internet, especifique o arquivo WHL baixado anteriormente. Por exemplo:

  scripts\pip.exe install C:\Downloads\cntk-2.1-cp35-cp35m-win_amd64.whl
  

Você pode ser solicitado a elevar as permissões para concluir a instalação. À medida que a instalação progride, você pode ver mensagens de status na janela do prompt de comando.

Carregue o pacote ou suas funções como parte do script

Quando a instalação estiver concluída, você poderá começar imediatamente a usar o pacote em scripts Python no SQL Server.

Para usar funções do pacote em seu script, insira a instrução padrão import <package_name> nas linhas iniciais do script:

EXECUTE sp_execute_external_script 
  @language = N'Python', 
  @script = N'
import cntk
# Python statements ...
'

Consulte também

• Obter informações do pacote Python
• Tutoriais do Python para os Serviços de Aprendizado de Máquina do SQL Server
• API Python para CNTK