Compartilhar via


Script de inicialização global

Importante

O Databricks recomenda configurar todos os scripts de inicialização como scripts de inicialização no escopo do cluster e gerenciá-los no seu espaço de trabalho usando políticas de cluster. Consulte Scripts de inicialização com escopo de cluster.

Um script de inicialização global é executado em todos os clusters em seu workspace configurados com o modo de acesso compartilhado sem isolamento de usuário único ou herdado. 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

Antes de usar scripts de inicialização global, considere o seguinte:

  • Os scripts de inicialização global não são executados em todos os tipos de cluster. Há suporte apenas para modos de acesso compartilhado de usuário único e sem isolamento.
  • É 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.