Partilhar via

Scripts init globais

  • Artigo

Importante

O Databricks recomenda configurar todos os scripts init como scripts init com escopo de cluster e gerenciá-los em 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 espaço de trabalho configurado com um único usuário ou modo de acesso compartilhado herdado sem isolamento. 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

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. Apenas os modos de acesso compartilhado de usuário único e sem isolamento são suportados.
  • É 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.