Scripts d’initialisation globaux
Databricks recommande de configurer tous les scripts d'initialisation comme des scripts d'initialisation à l'échelle du cluster et de les gérer dans votre workspace à l'aide de stratégies de cluster. Voir les scripts d'initialisation à l'échelle du cluster.
Un script d'initialisation global s'exécute sur tous les clusters de votre workspace configurés avec le mode d'accès dédié (anciennement utilisateur unique) ou le mode d'accès partagé hérité sans isolation. Seuls les administrateurs de Workspace peuvent créer des scripts d'initialisation globaux. Vous pouvez les créer en utilisant l'interface utilisateur ou l'API REST.
Avant d'utiliser des scripts d'initialisation globaux, veuillez prendre en considération ce qui suit :
- Les scripts d'initialisation globaux ne s'exécutent pas sur les SQL Warehouses, les clusters de diffusion de modèles ou le compute serverless, y compris les LakeFlow Pipelines. Seuls les computes classiques avec des modes d'accès dédiés ou sans isolement partagé sont pris en charge.
- Il est facile d'ajouter des bibliothèques ou d'apporter d'autres modifications qui entraînent des impacts inattendus. Chaque fois que possible, utilisez plutôt des scripts d'initialisation à l'échelle du cluster.
- Tout utilisateur qui crée un cluster et active la livraison des Logs de clusters peut afficher la sortie
stderretstdoutdes scripts d'initialisation globaux. Vous devez vous assurer que vos scripts d'initialisation globaux ne génèrent aucune information sensible.
Vous pouvez résoudre les problèmes des scripts d'initialisation globaux en configurant la livraison des logs de cluster et en examinant le log du script d'initialisation. Voir Journalisation des scripts d'initialisation.
Ajoutez un script d'initialisation global à l'aide de l'interface utilisateur
Pour configurer les scripts d'initialisation globaux à l'aide des paramètres d'administration :
-
Allez dans les paramètres d’administration et cliquez sur l’onglet **Compute**.
-
Cliquez sur Gérer à côté de Scripts d'initialisation globaux .
-
Cliquez sur + Ajouter .
-
Nommez le script et saisissez-le en le tapant, en le collant ou en faisant glisser un fichier texte dans le champ Script .
Le script d'initialisation ne peut pas dépasser 64KB. Si un script dépasse cette taille, un message d'erreur s'affiche lorsque vous tentez d'enregistrer.
-
Si vous avez plus d'un script d'initialisation global configuré pour votre workspace, définissez l'ordre dans lequel le nouveau script s'exécutera.
-
Si vous souhaitez que le script soit activé pour tous les clusters nouveaux et redémarrés après l'enregistrement, activez Activé .
Lorsque vous ajoutez un script d'initialisation global ou apportez des modifications au nom, à l'ordre d'exécution ou à l'activation des scripts d'initialisation, ces modifications ne prennent effet que lorsque vous redémarrez le cluster.
- Cliquez sur **Ajouter**.
Ajoutez un script d’initialisation global à l’aide de Terraform
Vous pouvez ajouter un script d'initialisation global en utilisant le fournisseur Databricks Terraform et databricks_global_init_script.
Modifiez un script d'initialisation global à l'aide de l'interface utilisateur
- Allez dans les paramètres d’administration et cliquez sur l’onglet **Compute**.
- Cliquez sur Gérer à côté de Scripts d'initialisation globaux .
- Cliquez sur un script.
- Modifiez le script.
- Cliquez sur Confirmer .
Configurer un script d'initialisation global à l'aide de l'API
Les administrateurs de Workspace peuvent ajouter, supprimer, réorganiser et obtenir des informations sur les scripts d'initialisation globaux de votre Workspace à l'aide de l'API de scripts d'initialisation globaux.