Scripts de inicialização globais (herdado)

Importante

Esta documentação foi desativada e pode não estar atualizada. Não há mais suporte para os produtos, serviços ou tecnologias mencionados neste conteúdo. Consulte O que são scripts de inicialização?.

Aviso

Os scripts de inicialização globais herdados e os scripts de inicialização nomeados por cluster atingiram o fim de sua vida útil e não podem mais ser usados.

Scripts de inicialização globais herdados são executados em cada cluster. Eles são menos seguros do que a nova estrutura de script de inicialização global, ignoram silenciosamente as falhas e não podem referenciar variáveis de ambiente.

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

Migrar scripts herdados para novos scripts de inicialização global

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

Observação

Em 1 de setembro de 2023, o Azure Databricks desabilitará os scripts de inicialização global herdados de 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 assim que possível.

Notebook de migração automatizado

A Engenheiros de Dados do Databricks criou um notebook para ajudar a automatizar o processo de migração dos scripts de inicialização global herdados. Para obter instruções e um link para o download do notebook, consulte Notebook de migração de scripts de inicialização global herdados.

Instruções de migração manual

Para migrar dos scripts de inicialização global herdados para os novos scripts de inicialização global:

1. Copie seus scripts de inicialização global herdados existentes do seu local de 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. Confira Usar scripts de inicialização globais.

   Mantenha-os desabilitados até que você tenha concluído a próxima etapa.

2. Desabilite todos os scripts de inicialização global herdados.

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

   

   Observação

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

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

   Na guia Scripts de Inicialização Global, ative a opção Habilitado para cada script de inicialização que deseja habilitar.

4. Reinicie todos os clusters.

Importante

Depois que os scripts de inicialização globais herdados são desabilitados, os scripts herdados param de ser executados imediatamente. Isso tem dois impactos importantes:

• Scripts herdados e novos scripts de inicialização globais 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, você deve reiniciar todos os clusters.
• Os scripts não idempotentes poderão precisar ser modificados quando você migrar para a nova estrutura de script de inicialização global e desabilitar os scripts herdados.