Instale bibliotecas de arquivos do espaço de trabalho

Este artigo orienta você pelas etapas necessárias para carregar arquivos de pacote ou requirements.txt para arquivos de workspace e instalá-los em clusters no Azure Databricks. Você pode instalar bibliotecas em computação para todos os fins ou em computação de trabalho.

Importante

Esse artigo descreve o armazenamento de bibliotecas como arquivos de espaço de trabalho. Isso é diferente das bibliotecas de workspace que estão preteridas.

Para obter mais informações sobre arquivos do espaço de trabalho, veja Navegar no espaço de trabalho.

O Databricks Runtime 15.0 ou superior é necessário para fazer upload de arquivos requirements.txt para arquivos de espaço de trabalho. Para detalhes completos de compatibilidade da biblioteca, veja Bibliotecas.

Carregar bibliotecas em arquivos do espaço de trabalho

Você pode carregar bibliotecas em arquivos de espaço de trabalho da mesma forma que carrega outros arquivos.

Para carregar uma biblioteca em arquivos do espaço de trabalho:

1. Clique em Workspace na barra lateral esquerda.
2. Navegue até o local no espaço de trabalho onde deseja fazer upload da biblioteca.
3. Clique em no canto superior direito e escolha Importar.
4. A caixa de diálogo Importar aparece. Para Importar de: escolha Arquivo ou URL. Arraste e solte ou navegue até os arquivos que deseja carregar ou forneça o caminho do URL para o arquivo.
5. Clique em Importar.

Instalar bibliotecas de arquivos do espaço de trabalho em um cluster

Ao instalar uma biblioteca em um cluster, todos os notebooks em execução nesse cluster têm acesso à biblioteca.

Para instalar uma biblioteca de arquivos do espaço de trabalho em um cluster:

1. Clique em Computação na barra lateral esquerda.
2. Clique no nome do cluster na lista de clusters.
3. Clique na guia Bibliotecas.
4. Clique em Instalar novo. A caixa de diálogo Instalar biblioteca é exibida.
5. Para Fonte da Biblioteca, selecione Espaço de trabalho.
6. Faça o upload do arquivo da biblioteca ou requirements.txt, navegue até a biblioteca ou requirements.txt no workspace, ou insira o seu local no workspace no campo Caminho do Arquivo no Workspace, como mostrado abaixo: /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>
7. Clique em Instalar.

Adicione bibliotecas dependentes a tarefas de fluxo de trabalho a partir de arquivos do espaço de trabalho

Você pode adicionar bibliotecas dependentes a tarefas a partir de arquivos do espaço de trabalho. Consulte Configurar e editar tarefas do Databricks.

Para configurar uma tarefa de fluxo de trabalho com uma biblioteca dependente de arquivos do espaço de trabalho:

1. Selecione uma tarefa existente em um fluxo de trabalho ou crie uma nova tarefa.
2. Ao lado de Bibliotecas dependentes, clique em + Adicionar.
3. Na caixa de diálogo Adicionar biblioteca dependente, selecione Espaço de trabalho para Origem da biblioteca.
4. Faça o upload do arquivo da biblioteca ou requirements.txt, navegue até a biblioteca ou arquivo requirements.txt no workspace, ou insira seu local no w no campo Caminho do Arquivo no Workspace, como o seguinte exemplo: /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>
5. Clique em Instalar.

Instalar bibliotecas de arquivos do espaço de trabalho em um notebook

Você pode instalar bibliotecas Python diretamente em um notebook para criar ambientes personalizados específicos do notebook. Por exemplo, você pode usar uma versão específica de uma biblioteca em um notebook, sem afetar outros usuários no cluster que possam precisar de uma versão diferente da mesma biblioteca. Para obter mais informações, confira Bibliotecas com escopo de notebook.

Ao instalar uma biblioteca em um notebook, somente o notebook atual e todos os trabalhos associados a esse notebook têm acesso a essa biblioteca. Outros notebooks anexados ao mesmo cluster não são afetados.