Optar por não usar bibliotecas Python pré-instaladas para aplicações Databricks

Esta página descreve como optar por não usar bibliotecas Python pré-instaladas numa aplicação Databricks com escala horizontal, gerir as suas próprias dependências e voltar a ativar as bibliotecas pré-instaladas mais tarde. A desativação só está disponível em aplicações dimensionadas horizontalmente que foram convertidas a partir de uma aplicação padrão. Veja Converter uma aplicação padrão para usar escala horizontal. A escala horizontal está em Beta.

Quando convertes uma aplicação padrão para escala horizontal, Azure Databricks fixa a aplicação convertida nas bibliotecas Python pré-instaladas para que as importações existentes da tua app continuem a funcionar. Opta por não correr a aplicação numa imagem base limpa do sistema operativo e declara todas as bibliotecas tu mesmo.

Optar por não usar bibliotecas pré-instaladas

Optar por sair diz ao Azure Databricks para construir a sua próxima implementação com uma imagem base do sistema operativo limpa. As bibliotecas pré-instaladas já não estão disponíveis a menos que as declare em requirements.txt ou pyproject.toml.

Para optar por não participar:

1. Na página de detalhes da aplicação, clique em Editar.
2. No passo Configurar, desmarque a caixa de verificação Utilizar bibliotecas Python pré-instaladas.
3. Clique em Guardar. A implementação atualmente em curso não é afetada.
4. Implemente novamente a sua aplicação a partir do separador Implantações . Esta nova implementação baseia-se na imagem do sistema operativo base limpa.

Fluxo de trabalho recomendado

As suas dependências podem incluir bibliotecas pré-instaladas de forma transitiva, por isso nem sempre é claro quais as bibliotecas que a sua aplicação necessita diretamente. Encontre bibliotecas em falta numa aplicação de teste antes de optar por sair em produção:

1. Crie uma nova aplicação com escala horizontal. As novas aplicações escaladas horizontalmente já são executadas na imagem de base limpa do sistema operativo, pelo que isso corresponde ao seu objetivo após a exclusão voluntária.
2. Implemente a fonte da sua aplicação de produção na aplicação de teste. Atualize requirements.txt (ou pyproject.toml) e reimplemente até que a aplicação de teste inicie, processe pedidos e passe nos seus testes.
3. Copie as declarações finais de dependência para a fonte da sua aplicação de produção.
4. Na aplicação de produção, siga os passos em Desativar bibliotecas pré-instaladas e implemente o código-fonte atualizado.

A produção continua em execução na imagem com as bibliotecas pré-instaladas até que a nova implementação passe nas verificações de estado, pelo que esta abordagem evita períodos de indisponibilidade enquanto identifica dependências em falta na aplicação de teste.

Resolver erros após optar por sair

A falha mais comum após desativar é um ModuleNotFoundError ao iniciar a aplicação, causado por uma framework ou biblioteca que o seu código importou implicitamente do conjunto pré-instalado. Para resolvê-lo:

1. Abra o separador Registos na página de detalhes da aplicação.
2. Encontre o nome do módulo em falta nos registos de build ou runtime.
3. Adicione o pacote correspondente a requirements.txt (ou pyproject.toml) e volte a implementar.

Uma nova implementação só substitui a implementação em execução se o processo da aplicação permanecer a correr nos primeiros segundos após o arranque. Uma implantação com opção de exclusão que falha imediatamente devido a uma importação em falta nunca entra em funcionamento, e o tráfego continua na implantação anterior em funcionamento enquanto a lista de dependências é corrigida. A verificação de inicialização é sumária, por isso teste se a sua aplicação processa realmente os pedidos depois de desativar essa opção, em vez de depender dessa verificação para detetar implementações com falhas.

Voltar a ligar as bibliotecas pré-instaladas

Para regressar às bibliotecas pré-instaladas após optar por sair:

1. Na página de detalhes da aplicação, clique em Editar.
2. No passo Configurar, selecione a caixa de seleção Usar bibliotecas Python pré-instaladas.
3. Clique em Guardar.
4. Implemente novamente a sua aplicação a partir do separador Implantações . Esta nova implementação baseia-se na imagem base com as bibliotecas pré-instaladas.

Os seus requirements.txt e pyproject.toml continuam a aplicar-se, pelo que quaisquer declarações explícitas que tenha adicionado enquanto estava desativado são mantidas.