Skip To Content

Planifier une tâche de notebook

Depuis la version 10.8.1, vous pouvez créer des tâches pour planifier l’exécution automatique d’un notebook. Chaque fois que votre notebook est exécuté selon la planification définie, le site ouvre un nouveau conteneur et exécute le notebook sans intervention de l’utilisateur.

Dans la fenêtre Tasks (Tâches) de l’éditeur de notebooks, vous pouvez créer une ou plusieurs tâches planifiées pour l’exécution du notebook. Il est possible de programmer le notebook pour qu’il s’exécute une seule fois, ou plusieurs fois à des intervalles réguliers pouvant aller de toutes les minutes à une fois tous les cinq mois.

Si vous préparez un notebook pour l’exécution automatisée, par exemple de manière récurrente, vous devez garder plusieurs éléments à l’esprit.

Préparer le notebook

Le planificateur permet d’insérer des paramètres en tant que nouvelle cellule au moment de l’exécution, notamment des identifiants de connexion de compte ou des variables à définir.

Cette opération utilise l’option de la barre d’outils de la cellule Tags (Balises), ce qui vous permet de créer et de gérer les balises pour chaque cellule de l’espace de travail du notebook. Pour modifier les options de la barre d’outils de la cellule, cliquez sur View (Afficher) > Cell Toolbar (Barre d’outils de la cellule).

Vous pouvez désigner l’emplacement au sein du notebook auquel cette nouvelle cellule est ajoutée en indiquant la balise parameters dans une cellule du notebook. La nouvelle cellule est insérée après cette cellule. Une seule cellule comportant la balise parameters est reconnue par l’opération.

Contenu à éviter

En dehors de l’insertion de la cellule de paramètres, la planification d’un notebook ne prévoit aucune interaction de l’utilisateur avec les notebooks. Évitez d’ajouter du contenu qui nécessite une interaction de l’utilisateur pendant l’exécution de votre notebook, par exemple cliquer sur un point sur la carte.

Les identifiants de connexion et les nouvelles variables à ajouter lors de l’exécution automatisée doivent être insérés dans la cellule des paramètres, comme indiqué ci-dessus. Assurez-vous que votre notebook ne contient pas de contenu empêchant la réalisation complète de l’exécution du notebook.

Créer une tâche pour le notebook

Lorsque votre notebook est prêt, vous pouvez créer une tâche pour planifier son exécution. Dans la fenêtre Tasks (Tâches) de l’éditeur de notebooks, vous pouvez créer une ou plusieurs tâches pour automatiser l’exécution du notebook et définir la planification de la tâche.

  1. Si vous ne l’avez pas déjà fait, enregistrez votre notebook et donnez-lui un titre. La fenêtre Tasks (Tâches) doit se trouver dans le ruban supérieur de l’éditeur de notebooks.
  2. Cliquez sur Create Task (Créer une tâche). La boîte de dialogue correspondante s’ouvre.

    Remarque :
    Vous pouvez également créer des tâches dans l’onglet Tasks (Tâches) de la page des détails des éléments du notebook.

  3. Dans le champ Title (Titre), indiquez un titre évocateur de la tâche de planification, comme Weekly data cleaning run.
  4. Si vous souhaitez que des paramètres soient ajoutés au notebook au moment de son exécution par la tâche, indiquez-les dans la section Parameters (Paramètres). Pour chaque paramètre, vous devez indiquer une clé (Key) ainsi que la valeur (Value) qui lui est appariée. Par exemple, vous pouvez avoir mypassword comme clé et gis.rocks123 comme valeur. Cliquez sur le signe plus (+) pour enregistrer le paramètre.

    Une fois que vous avez ajouté au moins un paramètre, l’option Save Parameters to Notebook (Enregistrer les paramètres dans le notebook)s apparaît. Si l’option est sélectionnée, la cellule insérée avec vos nouveaux paramètres sera enregistrée dans le notebook au moment de son exécution.

  5. Cliquez sur Next (Suivant) pour passer à la page Set task schedule details (Détailler la planification de la tâche). C’est sur cette page que vous pouvez définir la planification précise de cette tâche.

    Conseil :
    Les options ci-après changent en fonction de la valeur Repeat Every (Fréquence) sélectionnée. Par exemple, si vous optez pour la fréquence Repeat Every Day (Tous les jours), des cases à cocher correspondant à chaque jour de la semaine sont proposées.

  6. L’option Update Item on Completion (Mettre à jour l’élément à la fin) a pour fonction d’enregistrer le notebook après chaque exécution. Si vous souhaitez mettre à jour le notebook avec les résultats de chaque exécution, laissez cette option sélectionnée. Si vous préférez que le notebook ne soit pas mis à jour automatiquement, désélectionnez-la.
  7. Lorsque vous êtes satisfait du titre, des éventuels paramètres facultatifs et de la planification de la tâche, cliquez sur Create Task (Créer la tâche). La tâche est activée, puis elle exécute le notebook selon la planification définie.

Si vous avez besoin de plusieurs planifications, éventuellement avec des paramètres insérés différents, vous pouvez créer d’autres tâches pour le notebook en suivant le même processus.

Utiliser des tâche existantes

Une fois que vous avez créé une tâche pour votre notebook, vous pouvez en afficher les détails, la mettre à jour ou la supprimer à votre convenance. Les options correspondantes sont disponibles dans la fenêtre Tasks (Tâches) de l’éditeur de notebooks et dans l’onglet Tasks (Tâches) de la page des détails des éléments du notebook.

Dans cette fenêtre et dans cet onglet, vous pouvez afficher toutes les tâches du notebook avec leur date de création, la date de leur dernière modification ainsi que leur statut actuel (Active ou Complete [Terminée]).

Chaque tâche est associée à quatre icônes d’action. Vous pouvez cliquer sur l’icône View Task Details (Afficher les détails de la tâche) pour examiner les résultats de chaque exécution de la tâche. Pour modifier le titre, les paramètres ou la planification de la tâche, cliquez sur l’icône Edit Task (Mettre à jour la tâche). Vous pouvez également mettre sur pause une tâche active ou reprendre une tâche mise sur pause. Pour supprimer une tâche, cliquez sur l’icône Delete Task (Supprimer la tâche).

Le changement de propriété d’un notebook change également la propriété des tâches de ce notebook. Les tâches sont transférées vers le nouvel utilisateur avec un état désactivé. Le nouveau propriétaire peut activer les tâches depuis la fenêtre Tasks (Tâches) de l’éditeur de notebooks ou dans l’onglet Tasks (Tâches) de la page des détails des éléments du notebook.

Conseil :

Lorsqu’une tâche est supprimée, l’historique de ses exécutions l’est également. Si vous souhaitez conserver l’historique d’une tâche active, pensez à mettre la tâche sur pause pour arrêter toutes ses exécutions ultérieures.