Scripts de inicialización global (heredado)

Importante

Esta documentación se ha retirado y es posible que no se actualice. Los productos, servicios o tecnologías mencionados en este contenido ya no se admiten. Consulte ¿Qué son los scripts de inicialización?.

Advertencia

Los scripts de inicialización globales heredados y los scripts de inicialización con nombre de clúster son de fin de ciclo de vida y ya no se pueden usar.

Los scripts de inicialización globales heredados se ejecutan en cada clúster. Son menos seguros que el nuevo marco de scripts de inicialización global, ignoran los errores de forma silenciosa y no pueden hacer referencia a variables de entorno.

Databricks recomienda migrar todos los scripts de inicialización globales heredados que se tengan al nuevo marco de scripts de inicialización global. Los scripts de inicialización globales heredados no son visibles en la interfaz de usuario, pero se pueden encontrar en dbfs:/databricks/init/. Deben eliminarse o moverse de esa carpeta para completar una migración.

Migración de los scripts de inicialización globales heredados a los nuevos

Si su área de trabajo de Azure Databricks se inició antes de agosto de 2020, es posible que todavía tenga scripts de inicialización globales heredados. Los scripts de inicialización globales heredados han quedado en desuso y ya no están disponibles en las nuevas áreas de trabajo. No deben usarse.

Nota:

El 1 de septiembre de 2023, Azure Databricks deshabilitará los scripts de inicialización globales heredados para todas las áreas de trabajo. Azure Databricks recomienda migrar los scripts de inicialización globales heredados al marco de scripts de inicialización global actual lo antes posible.

Cuaderno de migración automatizada

Databricks Engineering ha creado un cuaderno para ayudar a automatizar el proceso de migración de scripts de inicialización globales heredados. Para obtener instrucciones y un vínculo a la descarga del cuaderno, consulte Cuaderno de migración de script de inicialización global heredado.

Instrucciones de migración manual

Para migrar de scripts de inicialización globales heredados a los nuevos scripts de inicialización globales:

1. Copie los scripts de inicialización globales heredados existentes desde su ubicación reservada de DBFS (/databricks/init) y agréguelos al nuevo marco de script de inicialización global mediante la interfaz de usuario o la API de REST. Consulte Utilice scripts de inicialización globales.

   Manténgalos deshabilitados hasta que haya completado el siguiente paso.

2. Deshabilite todos los scripts de inicialización globales heredados.

   En la configuración de administrador, vaya a la pestaña Scripts de inicialización globales y desactive Scripts de inicialización globales heredados.

   

   Nota:

   Si no tiene acceso a la interfaz de usuario, quite todos los archivos de la ubicación /databricks/init para detener la ejecución de scripts de inicialización heredados.

3. Habilite los nuevos scripts de inicialización globales.

   En la pestaña Global Init Scripts (Scripts de inicialización globales), active el conmutador Enabled (Habilitado) para cada script de inicialización que quiera habilitar.

4. Reinicie todos los clústeres.

Importante

Una vez deshabilitados los scripts de inicialización global heredados, los scripts heredados dejan de ejecutarse inmediatamente. Esto tiene dos impactos importantes:

• Los scripts heredados y los nuevos scripts de inicialización global no se ejecutan en los nodos agregados cuando se ejecuta un escalado automático de clústeres. Para asegurarse de que los nuevos scripts se ejecutan en todos los clústeres y nodos nuevos de los clústeres existentes, debe reiniciar todos los clústeres.
• Puede que sea necesario modificar los scripts no idempotentes al migrar al nuevo marco de scripts de inicialización globales y deshabilitar los scripts heredados.