workspace biblioteca (legado)
Essa documentação foi descontinuada e pode não estar atualizada. O produto, serviço ou tecnologia mencionados neste conteúdo não são mais suportados. Ver biblioteca de agrupamento.
workspace biblioteca foram descontinuados e não devem ser usados. No entanto, o armazenamento de biblioteca como arquivos workspace é diferente de workspace biblioteca e ainda é totalmente compatível. O senhor pode instalar a biblioteca armazenada como arquivos workspace diretamente em compute ou no Job tarefa.
As bibliotecas de workspaces servem como um repositório local a partir do qual você cria bibliotecas instaladas em clusters. Uma biblioteca de workspace pode ser um código personalizado criado por sua organização ou pode ser uma versão específica de uma biblioteca de código aberto padronizada por sua organização.
O senhor deve instalar uma biblioteca workspace em um clustering antes que ela possa ser usada em um Notebook ou Job. Consulte Instalar uma biblioteca workspace em um clustering.
As bibliotecas do workspace na pasta Shared estão disponíveis para todos os usuários em um workspace, enquanto as bibliotecas do workspace em uma pasta de usuário estão disponíveis apenas para esse usuário.
A biblioteca pode ser instalada a partir de DBFS ao usar Databricks Runtime 14.3 LTS e abaixo. No entanto, qualquer usuário do site workspace pode modificar os arquivos de biblioteca armazenados no site DBFS. Para aumentar a segurança da biblioteca em um Databricks workspace, o armazenamento de arquivos da biblioteca no DBFS root está obsoleto e desativado pelo default em Databricks Runtime 15.1 e acima. Consulte O armazenamento de biblioteca em DBFS root está obsoleto e desativado por default.
Em vez disso, o site Databricks recomenda o upload de todas as bibliotecas, incluindo Python biblioteca, JAR arquivos e Spark conectores, para workspace arquivos ou Unity Catalog volumes, ou usando repositórios de pacotes de biblioteca. Se sua carga de trabalho não for compatível com esses padrões, o senhor também poderá usar a biblioteca armazenada no armazenamento de objetos na nuvem.
Qual é a diferença entre a biblioteca workspace e a biblioteca armazenada com os arquivos workspace?
O termo "workspace biblioteca" refere-se a qualquer biblioteca registrada em workspace. workspace biblioteca aparecem ao lado dos arquivos Notebook e workspace e seguem as regras do ACL para o diretório que os contém.
O termo "workspace files" refere-se a qualquer arquivo arbitrário armazenado no site workspace. O senhor pode armazenar o arquivo Python .whl pacote como arquivos workspace e depois registrá-los como workspace biblioteca. Consulte O que são arquivos workspace?
O senhor pode upload biblioteca como arquivos workspace. Consulte o uso básico dos arquivos de espaço de trabalho.
Embora o senhor possa fazer upload de vários tipos de arquivos para os arquivos do workspace, somente o arquivo Python .whl podem ser instalados usando os arquivos workspace. Consulte biblioteca com escopo de computação.
Em Databricks Runtime 13.3 LTS e acima, o senhor pode usar %pip para instalar arquivos Python wheel armazenados como arquivos workspace. Consulte Instalar um pacote armazenado como um arquivo workspace com %pip.
Criar uma workspace biblioteca
Essa funcionalidade não está mais disponível. Consulte Criação e instalação de workspace biblioteca não está mais disponível.
- Clique com o botão direito do mouse na pasta do workspace onde você deseja armazenar a biblioteca.
- Selecione Criar > biblioteca . A caixa de diálogo Criar Biblioteca é exibida.
- Selecione a Origem da biblioteca e siga o procedimento apropriado:
Faça upload de um arquivo Jar, Python egg ou Python wheel
A instalação de arquivos Python egg está obsoleta e será removida em uma versão futura do Databricks Runtime.
A biblioteca pode ser instalada a partir de DBFS ao usar Databricks Runtime 14.3 LTS e abaixo. No entanto, qualquer usuário do site workspace pode modificar os arquivos de biblioteca armazenados no site DBFS. Para aumentar a segurança da biblioteca em um Databricks workspace, o armazenamento de arquivos da biblioteca no DBFS root está obsoleto e desativado pelo default em Databricks Runtime 15.1 e acima. Consulte O armazenamento de biblioteca em DBFS root está obsoleto e desativado por default.
Em vez disso, o site Databricks recomenda o upload de todas as bibliotecas, incluindo Python biblioteca, JAR arquivos e Spark conectores, para workspace arquivos ou Unity Catalog volumes, ou usando repositórios de pacotes de biblioteca. Se sua carga de trabalho não for compatível com esses padrões, o senhor também poderá usar a biblioteca armazenada no armazenamento de objetos na nuvem.
- Na lista de botões Fonte da biblioteca, selecione Carregar .
- Selecione Jar , Python Egg ou Python Whl .
- Opcionalmente, insira um nome de biblioteca.
- Arraste seu Jar, Egg ou Whl até a caixa suspensa ou clique na caixa suspensa e navegue até um arquivo. O arquivo é enviado para
dbfs:/FileStore/jars. - Clique em Criar . A tela de status da biblioteca é exibida.
Fazer referência a um arquivo de upload JAR, Python egg ou Python wheel
O senhor pode criar uma nova workspace biblioteca fazendo referência a JAR, Python egg ou Python wheel arquivos armazenados no DBFS root, no armazenamento de objetos ou com workspace arquivos. Após esse fluxo de trabalho, registre um ponteiro para uma biblioteca sem fazer upload ou mover arquivos.
Com o Databricks Runtime 13.2 e o acima, o senhor também pode fazer referência a um volume em Unity Catalog. Esse recurso está na versão prévia pública.
Para compute com modo de acesso padrão (antigo modo de acesso compartilhado), o senhor deve adicionar JARs ao allowlist. Consulte Allowlist biblioteca e script de inicialização em compute com o modo de acesso padrão (anteriormente, modo de acesso compartilhado).
-
Selecione File path/S3 (Caminho do arquivo/S3 ) na lista de botões Library Source (Origem da biblioteca).
-
Selecione Jar , Python Egg ou Python Whl .
-
Opcionalmente, insira um nome de biblioteca.
-
Especifique o caminho para a biblioteca, como os seguintes exemplos:
s3://bucket-name/path/to/library.whl/Workspace/path/to/library.whldbfs:/path/to/library.whl/Volumes/<catalog>/<schema>/<volume>/<path_to_library_file>
-
Clique em Criar . A tela de status da biblioteca é exibida.
Para obter mais informações sobre como trabalhar com o biblioteca no armazenamento de objetos, consulte Instalar o biblioteca a partir do armazenamento de objetos.
Para obter mais informações sobre os arquivos workspace, consulte Trabalhar com arquivos em Databricks.
Instalar uma biblioteca workspace em um clustering
O Databricks processa todas as bibliotecas de workspace na ordem em que foram instaladas no cluster. Talvez seja necessário prestar atenção à ordem de instalação no cluster se houver dependências entre bibliotecas.
A biblioteca pode ser instalada a partir de DBFS ao usar Databricks Runtime 14.3 LTS e abaixo. No entanto, qualquer usuário do site workspace pode modificar os arquivos de biblioteca armazenados no site DBFS. Para aumentar a segurança da biblioteca em um Databricks workspace, o armazenamento de arquivos da biblioteca no DBFS root está obsoleto e desativado pelo default em Databricks Runtime 15.1 e acima. Consulte O armazenamento de biblioteca em DBFS root está obsoleto e desativado por default.
Em vez disso, o site Databricks recomenda o upload de todas as bibliotecas, incluindo Python biblioteca, JAR arquivos e Spark conectores, para workspace arquivos ou Unity Catalog volumes, ou usando repositórios de pacotes de biblioteca. Se sua carga de trabalho não for compatível com esses padrões, o senhor também poderá usar a biblioteca armazenada no armazenamento de objetos na nuvem.
No modo de acesso de usuário único, é usada a identidade do principal atribuído (um usuário ou entidade de serviço). No modo de acesso padrão (antigo modo de acesso compartilhado), a biblioteca usa a identidade do usuário que instalou a biblioteca. O modo de acesso compartilhado sem isolamento não suporta volumes, mas usa a mesma atribuição de identidade do modo de acesso padrão.
Para ver todas as opções de instalação do biblioteca em cluster, consulte biblioteca em cluster.
Para instalar uma biblioteca que já existe no workspace, você pode começar pela interface do usuário do cluster ou pela interface do usuário da biblioteca:
agrupamento
- Na barra lateral, clique em
compute . - Clique em um nome de cluster.
- Clique na guia Bibliotecas .
- Clique em Instalar novo .
- Na lista de botões Origem da biblioteca, selecione Biblioteca do workspace .
- Selecione uma biblioteca de workspace.
- Clique em Instalar .
biblioteca
- Vá para a pasta que contém a biblioteca.
- Clique no nome da biblioteca.
- Marque a caixa de seleção ao lado do cluster no qual você deseja instalar a biblioteca e clique em Instalar . Somente clusters em execução aparecem na lista.
Veja os detalhes da workspace biblioteca
As pastas de workspace oferecem conveniência para descobrir bibliotecas de workspace e gerenciar ACLs.
- Acesse a pasta do workspace que contém a biblioteca.
- Clique no nome da biblioteca.
A página de detalhes da biblioteca mostra os clusters em execução e o status de instalação da biblioteca. Se a biblioteca estiver instalada, a página conterá um link para o host do pacote. Se a biblioteca tiver sido carregada, a página exibirá um link para o arquivo de pacote de upload.
Mova a workspace biblioteca
As pastas de workspace oferecem conveniência para descobrir bibliotecas de workspace e gerenciar ACLs.Mover uma biblioteca do workspace não move arquivos, mas pode modificar quais usuários têm acesso à biblioteca do workspace.
- Acesse a pasta do workspace que contém a biblioteca.
- Clique com o botão direito do mouse no nome da biblioteca e selecione Mover . Um navegador de pastas é exibido.
- Clique na pasta de destino.
- Clique em Mover .
Excluir uma workspace biblioteca
Antes de excluir uma workspace biblioteca, o senhor deve desinstalá-la de todos os clusters.
Para excluir uma biblioteca de workspace:
- Mova a biblioteca para a pasta Lixeira.
- Exclua permanentemente a biblioteca na pasta Lixeira ou esvazie a pasta Lixeira.