Usar scripts de inicialização global

  • Artigo

Importante

Os scripts de inicialização global só são executados em clusters configurados com o modo de acesso compartilhado sem isolamento de usuário único ou herdado, portanto, o 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 em seu espaço de trabalho. Os scripts de inicialização global são úteis quando você deseja impor configurações de biblioteca ou telas de segurança em toda a organização. Somente os administradores de ritmo de trabalho podem criar scripts de inicialização globais. 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 impactos potenciais como os seguintes:

  • É fácil adicionar bibliotecas ou fazer outras modificações que causem impactos inesperados. Sempre que possível, use scripts de inicialização com escopo de cluster.
  • Qualquer usuário que crie um cluster e habilite a entrega de log de cluster pode exibir a saída e stdout os stderr scripts de inicialização global. Você deve garantir que seus scripts de inicialização global não produzam informações confidenciais.

Você pode solucionar problemas de scripts de inicialização global configurando a entrega de log de cluster e examinando o log de script de inicialização. Consulte Log de script de inicialização.

Nota

Os scripts de inicialização global não são executados em clusters de 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 de administrador:

  1. Vá para as configurações de administrador e clique na guia Computação .

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

  3. Clique em + Adicionar.

  4. Nomeie o script e insira-o digitando, colando ou arrastando um arquivo de texto para o campo Script .

    Nota

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

  5. Se você tiver mais de um script de inicialização global configurado para seu espaço de trabalho, defina a ordem em que o novo script será executado.

  6. Se desejar que o script seja habilitado para todos os clusters novos e reiniciados depois de salvar, alterne 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 de inicialização, essas alterações não entram em vigor até que você reinicie 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 Databricks Terraform e databricks_global_init_script.

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

  1. Vá para as configurações de administrador e clique na guia Computação .
  2. Clique em Gerenciar ao lado de Scripts de inicialização globais.
  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 espaço de trabalho podem adicionar, excluir, reordenar e obter informações sobre os scripts de inicialização global em seu espaço de trabalho usando a API de Scripts de Inicialização Global.