Usar os scripts de inicialização globais

Importante

Os scripts de inicialização globais são executados apenas em clusters configurados com usuário único ou modo de acesso compartilhado sem isolamento herdado, portanto, a Databricks recomenda configurar todos os scripts de inicialização como scripts de inicialização com escopo de cluster e gerenciá-los em seu espaço de trabalho usando políticas de cluster.

Um script de inicialização global é executado em cada cluster criado no workspace. Os scripts de inicialização global são úteis quando você deseja impor configurações de biblioteca em toda a organização ou telas de segurança. Somente os administradores de workspace podem criar scripts de inicialização global. Você pode criá-los usando a interface do usuário ou a API REST.

Importante

Como os scripts de inicialização global são executados em todos os clusters, considere os impactos potenciais, como os seguintes antes da configuração:

  • É fácil adicionar bibliotecas ou fazer outras modificações que causam impactos inesperados. Sempre que possível, use scripts de inicialização no escopo do cluster.
  • Qualquer usuário que cria um cluster e habilita a entrega de log de cluster pode ver a saída stderr e stdout dos scripts de inicialização global. Você deve garantir que os scripts de inicialização global não produzam nenhuma informação confidencial.

Você pode solucionar os problemas dos scripts de inicialização globais configurando o fornecimento de log do cluster e examinando o log do script de inicialização. Registro em log do script de inicialização.

Observação

Os scripts de inicialização global não são executados em clusters do serviço de modelo.

Adicionar um script de inicialização global usando a interface do usuário

Para configurar scripts de inicialização global usando as configurações do administrador:

  1. Acesse as configurações do administrador e clique na guia Computação.

  2. Clique em Gerenciar ao lado de Scripts de inicialização global.

  3. Clique em + Adicionar.

  4. Dê um nome ao script e insira-o digitando, colando ou arrastando um arquivo de texto para o campo Script.

    Observação

    O script de inicialização não pode ser maior que 64 KB. Se um script exceder esse tamanho, uma mensagem de erro será exibida quando você tentar salvá-lo.

  5. Caso tenha mais de um script de inicialização global configurado para seu workspace, defina a ordem na qual o novo script será executado.

  6. Se você quiser que o script seja habilitado para todos os clusters novos e reiniciados depois de você salvá-lo, alterne a opção para Habilitado.

    Importante

    Quando você adiciona um script de inicialização global ou faz alterações no nome, na ordem de execução ou na habilitação de scripts init, essas alterações não entram em vigor até você reiniciar o cluster.

  7. Clique em Adicionar.

Adicionar um script de inicialização global usando o Terraform

Você pode adicionar um script de inicialização global usando o provedor do Databricks Terraform e databricks_global_init_script.

Editar um script de inicialização global por meio da interface do usuário

  1. Acesse as configurações do administrador e clique na guia Computação.
  2. Clique em Gerenciar ao lado de Scripts de inicialização global.
  3. Clique em um script.
  4. Edite o script.
  5. Clique em Confirmar.

Configurar um script de inicialização global usando a API

Os administradores de workspace podem adicionar, excluir, reordenar e obter informações sobre os scripts de inicialização global no seu workspace usando a API de Scripts de Inicialização Global.