Scripts d’initialisation globaux (hérités)

Important

Cette documentation a été mise hors service et peut ne pas être mise à jour. Les produits, services ou technologies mentionnés dans ce contenu ne sont plus pris en charge. Voir Que sont les scripts d'initialisation ?.

Avertissement

Les scripts d’initialisation hérités et les scripts d’initialisation nommés par les clusters sont en fin de vie et ne peuvent plus être utilisés.

Les scripts d’initialisation globaux hérités s’exécutent sur chaque cluster. Les scripts globaux hérités sont moins sécurisés que le nouveau framework de scripts init globaux : ils ignorent les échecs en mode silencieux et ne peuvent pas référencer de variables d’environnement.

Databricks recommande de migrer tous les scripts d’initialisation globaux hérités existants vers la nouvelle infrastructure de scripts d’initialisation globaux. Les scripts init globaux hérités ne sont pas visibles dans l’interface utilisateur, mais sont disponibles à l’adresse dbfs:/databricks/init/. Ils doivent être supprimés ou déplacés de ce dossier pour effectuer une migration.

Migrer d’un script init global hérité vers un nouveau script init global

Si votre espace de travail Azure Databricks a été lancé avant août 2020, il se peut que vous ayez encore des scripts init globaux hérités. Les scripts d’initialisation globaux hérités ont été dépréciés et ne sont plus disponibles sur les nouveaux espaces de travail. Elles ne doivent pas être utilisées.

Notes

Le 1er septembre 2023, Azure Databricks désactivera les scripts d’initialisations globaux hérités pour tous les espaces de travail. Azure Databricks vous recommande de migrer vos scripts init globaux hérités vers l’infrastructure de script d’initialisation globale actuelle dès que possible.

Notebook de migration automatisée

Databricks Engineering a créé un notebook pour automatiser le processus de migration à partir de scripts d’initialisation globaux hérités. Pour obtenir des instructions et un lien vers le téléchargement du notebook, consultez Notebook de migration de script d’initialisation global hérité.

Instructions relatives à la migration manuelle

Pour migrer depuis les scripts init globaux hérités vers les nouveau scripts init globaux :

  1. Copiez vos scripts d’initialisation globaux hérités existants depuis leurs emplacements DBFS réservés (/databricks/init) et ajoutez-les à la nouvelle infrastructure de scripts d’initialisation globaux, en utilisant l’interface utilisateur ou l’API REST. Consultez Utiliser des scripts init globaux.

    Maintenez-les désactivés jusqu’à ce que vous ayez terminé l’étape suivante.

  2. Désactivez tous les scripts init globaux hérités.

    Dans la console d’administration, accédez à l’onglet Scripts init globaux et désactivez Scripts init globaux hérités.

    Désactiver les scripts init globaux hérités

    Notes

    Si vous n’avez pas accès à l’interface utilisateur, supprimez tous les fichiers de l’emplacement /databricks/init pour arrêter l’exécution des scripts init hérités.

  3. Activez vos nouveaux scripts init globaux.

    Sous l’onglet Scripts init globaux, passez le bouton bascule sur Activé pour chaque script init que vous souhaitez activer.

  4. Redémarrez tous les clusters.

Important

Une fois que les scripts d’initialisation globaux hérités sont désactivés, les scripts hérités cessent immédiatement de s’exécuter. Cela a deux impacts importants :

  • Les scripts hérités et les nouveaux scripts d’initialisation globaux ne sont pas exécutés sur les nœuds ajoutés lors de l’exécution d’une mise à l’échelle automatique d’un cluster. Pour vous assurer que les nouveaux scripts s’exécutent sur tous les clusters et les nouveaux nœuds sur les clusters existants, vous devez redémarrer tous les clusters.
  • Il peut être nécessaire de modifier les scripts non idempotents quand vous migrez vers le nouveau framework de scripts init globaux et désactivez les scripts hérités.