Scripts de inicialização global (legado)

Importante

Esta documentação foi desativada e pode não ser atualizada. Os produtos, serviços ou tecnologias mencionados neste conteúdo não são mais suportados. Consulte O que são scripts init?.

Aviso

Os scripts de inicialização global herdados e os scripts de inicialização nomeados por cluster estão em fim de vida útil e não podem mais ser usados.

Os scripts de inicialização global herdados são executados em todos os clusters. Eles são menos seguros do que a nova estrutura de script init global, ignoram silenciosamente falhas e não podem fazer referência a variáveis de ambiente.

O Databricks recomenda a migração de todos os scripts init globais herdados existentes para a nova estrutura de script init global. Os scripts de inicialização global herdados não são visíveis na interface do usuário, mas podem ser encontrados em dbfs:/databricks/init/. Eles devem ser excluídos ou movidos dessa pasta para concluir uma migração.

Migrar de scripts init herdados para novos scripts init globais

Se seu espaço de trabalho do Azure Databricks foi iniciado antes de agosto de 2020, você ainda pode ter scripts de inicialização globais herdados. Os scripts de inicialização global herdados foram preteridos e não estão mais disponíveis em novos espaços de trabalho. Não devem ser utilizados.

Nota

Em 1º de setembro de 2023, o Azure Databricks desabilitará scripts de inicialização globais herdados para todos os espaços de trabalho. O Azure Databricks recomenda que você migre seus scripts de inicialização global herdados para a estrutura de script de inicialização global atual o mais rápido possível.

Bloco de anotações de migração automatizada

A Databricks Engineering criou um notebook para ajudar a automatizar o processo de migração de scripts init globais legados. Para obter instruções e um link para o download do bloco de anotações, consulte Bloco de anotações de migração de script de inicialização global herdado.

Instruções de migração manual

Para migrar de scripts init globais herdados para os novos scripts init globais:

1. Copie seus scripts de inicialização global herdados existentes de seu local DBFS reservado (/databricks/init) e adicione-os à nova estrutura de script de inicialização global usando a interface do usuário ou a API REST. Consulte Usar scripts de inicialização global.

   Mantenha-os desativados até concluir a próxima etapa.

2. Desative todos os scripts de inicialização globais herdados.

   Nas configurações de administrador, vá para a guia Scripts de inicialização global e desative a opção Scripts de inicialização globais herdados.

   

   Nota

   Se você não tiver acesso à interface do usuário, remova todos os arquivos do /databricks/init local para interromper a execução de scripts init herdados.

3. Habilite seus novos scripts de inicialização global.

   Na guia Scripts de inicialização global, alterne a opção Ativado para cada script de inicialização que você deseja habilitar.

4. Reinicie todos os clusters.

Importante

Quando os scripts de inicialização global herdados são desativados, os scripts herdados param de ser executados imediatamente. Isto tem dois impactos importantes:

• Os scripts herdados e os novos scripts de inicialização global não são executados em nós adicionados quando um cluster em execução é dimensionado automaticamente. Para garantir que novos scripts sejam executados em todos os clusters e novos nós em clusters existentes, reinicie todos os clusters.
• Scripts não idempotentes podem precisar ser modificados quando você migra para a nova estrutura de script de inicialização global e desabilita scripts herdados.