Usar scripts de inicialización globales

Importante

Los scripts de inicialización global solo se ejecutan en clústeres configurados con un solo usuario o modo de acceso compartido heredado sin aislamiento, por lo que Databricks recomienda configurar todos los scripts de inicialización como scripts de inicialización con ámbito de clúster y administrarlos en el área de trabajo mediante directivas de clúster.

Un script de inicialización global se ejecuta en todos los clústeres creados en el área de trabajo. Los scripts de inicialización globales son útiles cuando se quiere aplicar configuraciones de bibliotecas o pantallas de seguridad en toda la organización. Solo los administradores del área de trabajo pueden crear scripts de inicio globales. Puede crearlos con la interfaz de usuario o con la API REST.

Importante

Dado que los scripts de inicialización globales se ejecutan en todos los clústeres, tenga en cuenta los posibles impactos, como los siguientes:

  • Es fácil agregar bibliotecas o realizar otras modificaciones que provoquen impactos inesperados. Siempre que sea posible, use scripts de inicialización de ámbito de clúster.
  • Cualquier usuario que cree un clúster y habilite la entrega de registros del clúster puede ver la salida de stderr y stdout de los scripts de inicialización globales. Debe asegurarse de que los scripts de inicialización globales no devuelvan ninguna información confidencial.

Para solucionar problemas en los scripts de inicialización globales, puede configurar la entrega de registros de clúster y examinar el registro del script de inicialización. Consulte Registro de script de inicialización.

Nota:

Los scripts de inicialización globales no se ejecutan en clústeres de Model Serving.

Adición de un script de inicialización global mediante la interfaz de usuario

Para configurar scripts de inicialización globales mediante la configuración de administrador:

  1. Vaya a la configuración de administración y haga clic en la pestaña Proceso.

  2. Haga clic en Administrar junto a Scripts de inicialización global.

  3. Haga clic en + Agregar.

  4. Asigne un nombre al script y, para especificarlo, escriba, pegue o arrastre un archivo de texto al campo Script.

    Nota:

    El script de inicialización no puede tener más de 64 KB. Si un script supera ese tamaño, aparece un mensaje de error al intentar guardar.

  5. Si tiene más de un script de inicialización global configurado para el área de trabajo, establezca el orden en el que se ejecutará el nuevo script.

  6. Si quiere que el script esté habilitado para todos los clústeres nuevos y reiniciados después de guardar, defina la opción en Habilitado.

    Importante

    Al agregar un script de inicialización global o hacer cambios en el nombre, el orden de ejecución o la habilitación de scripts de inicialización, esos cambios no surten efecto hasta que reinicie el clúster.

  7. Haga clic en Agregar.

Incorporación de un script de inicialización global mediante Terraform

Puede agregar un script de inicialización global mediante el proveedor Terraform de Databricks y databricks_global_init_script.

Edición de un script de inicialización global mediante la interfaz de usuario

  1. Vaya a la configuración de administración y haga clic en la pestaña Proceso.
  2. Haga clic en Administrar junto a Scripts de inicialización global.
  3. Haga clic en un script.
  4. Edite el script.
  5. Haga clic en Confirmar.

Configuración de un script de inicialización global mediante la API

Los administradores del espacio de trabajo pueden agregar, eliminar, reordenar y obtener información sobre las secuencias de comandos de inicio global en tu área de trabajo mediante la API de secuencias de comandos de inicio global.