Obter informações do pacote Python

Aplica-se a: SQL Server 2017 (14.x) e versões posteriores Instância Gerenciada SQL do Azure

Local padrão da biblioteca Python

Quando você instala o aprendizado de máquina com o SQL Server, uma única biblioteca de pacotes é criada no nível da instância para cada idioma instalado. A biblioteca de instâncias é uma pasta segura registrada no SQL Server.

Todo o script ou código executado no banco de dados no SQL Server deve carregar funções da biblioteca de instâncias. O SQL Server não pode acessar pacotes instalados em outras bibliotecas. Isso também se aplica a clientes remotos: qualquer código Python em execução no contexto de computação do servidor só pode usar pacotes instalados na biblioteca de instâncias. Para proteger os ativos do servidor, a biblioteca de instâncias padrão só pode ser modificada por um administrador do computador.

Habilite scripts externos executando os seguintes comandos SQL:

sp_configure 'external scripts enabled', 1;
RECONFIGURE WITH override;

Execute a seguinte instrução SQL se desejar verificar a biblioteca padrão para a instância atual. Este exemplo retorna a lista de pastas incluídas na variável Python sys.path . A lista inclui o diretório atual e o caminho da biblioteca padrão.

EXECUTE sp_execute_external_script
  @language =N'Python',
  @script=N'import sys; print("\n".join(sys.path))'

Para obter mais informações sobre a variável sys.path e como ela é usada para definir o caminho de pesquisa do intérprete para módulos, consulte O caminho de pesquisa do módulo.

Pacotes padrão do Microsoft Python

Os seguintes pacotes do Microsoft Python são instalados com o SQL Server Machine Learning Services quando você seleciona o recurso Python durante a instalação.

Para obter informações sobre qual versão do Python está incluída, consulte Versões Python e R.

Atualizações de componentes

Por padrão, os pacotes Python são atualizados por meio de service packs e atualizações cumulativas. Pacotes adicionais e atualizações de versão completa dos principais componentes Python só são possíveis por meio de atualizações de produtos.

Pacotes Python de código aberto padrão

Quando você seleciona a opção de linguagem Python durante a instalação, a distribuição Anaconda 4.2 (sobre Python 3.5) é instalada. Além das bibliotecas de código Python, a instalação padrão inclui dados de exemplo, testes de unidade e scripts de exemplo.

Listar todos os pacotes Python instalados

O script de exemplo a seguir exibe uma lista de todos os pacotes Python instalados na instância do SQL Server.

EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
import pkg_resources
import pandas
OutputDataSet = pandas.DataFrame(sorted([(i.key, i.version) for i in pkg_resources.working_set]))'
WITH result sets((Package NVARCHAR(128), Version NVARCHAR(128)));

Encontre um único pacote Python

Se você instalou um pacote Python e deseja ter certeza de que ele está disponível para uma instância específica do SQL Server, você pode executar um procedimento armazenado para procurar o pacote e retornar mensagens.

Por exemplo, o código a seguir procura o scikit-learn pacote. Se o pacote for encontrado, o código imprimirá a versão do pacote.

EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
import pkg_resources
pkg_name = "scikit-learn"
try:
    version = pkg_resources.get_distribution(pkg_name).version
    print("Package " + pkg_name + " is version " + version)
except:
    print("Package " + pkg_name + " not found")
'

Resultado:

STDOUT message(s) from external script: Package scikit-learn is version 0.20.2

Veja a versão do Python

O código de exemplo a seguir retorna a versão do Python instalada na instância do SQL Server.

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

Próximos passos