Aller au contenu principal

Planifier une query

Vous pouvez utiliser les exécutions de query planifiées pour mettre à jour vos tableaux de bord ou activer des alertes de routine. Par default, vos requêtes n'ont pas de planification.

remarque

Si une alerte utilise votre requête, l'alerte s'exécute selon son propre planning de refresh et n'utilise pas le planning de la requête.

Pour définir le calendrier :

  1. Dans l'éditeur SQL, cliquez sur Schedule > Add schedule pour ouvrir un menu avec les paramètres de planification.

    Intervalle de planification

  2. Choisissez quand exécuter le query.

    • Utilisez les sélecteurs déroulants pour spécifier la fréquence, la période, l'heure de début et le fuseau horaire. Vous pouvez éventuellement sélectionner la case à cocher Afficher la syntaxe Cron pour modifier la planification dans Quartz Cron Syntax.
    • Choisissez Plus d'options pour afficher les paramètres facultatifs. Vous pouvez également choisir :
      • Un nom pour le planning.
      • Un SQL warehouse pour alimenter la query. By default, le SQL Warehouse utilisé pour l'exécution de requêtes ad hoc est également utilisé pour un Job planifié. Utilisez ce paramètre facultatif pour sélectionner un autre warehouse afin d'exécuter la requête planifiée.
  3. Cliquez sur Créer . Votre query s'exécutera automatiquement selon le planning. Si vous constatez qu'une query planifiée ne s'exécute pas conformément à son planning, vous devriez manuellement Trigger la query pour vous assurer qu'elle ne échoue pas.

    Si l'exécution d'une query échoue lors d'une exécution planifiée, Databricks réessaie avec un algorithme de temporisation. Cela signifie que les nouvelles tentatives se produisent moins fréquemment à mesure que les échecs persistent. En cas d'échecs persistants, la prochaine tentative pourrait dépasser l'intervalle planifié.

    Après avoir créé un calendrier, l'étiquette sur le bouton Calendrier affiche Calendrier(#) , où le # représente le nombre d'événements planifiés qui vous sont visibles. Vous ne pouvez pas voir les calendriers qui n'ont pas été partagés avec vous.

important

Les nouveaux plannings ne sont pas automatiquement partagés avec d'autres utilisateurs, même si ces utilisateurs ont accès à la query. Pour rendre les exécutions planifiées et les résultats visibles aux autres utilisateurs, utilisez les paramètres de partage décrits à l'étape suivante.

  1. Partager le planning.

    Les autorisations de query ne sont pas liées aux autorisations de planification. Après avoir créé votre intervalle d'exécution programmé, modifiez les autorisations de planification afin de fournir un accès à d'autres utilisateurs.

    • Cliquez sur Planification(#) .
    • Cliquez sur le menu kebab Icône du menu kebab. et sélectionnez Modifier les autorisations de planification .
    • Choisissez un utilisateur ou un groupe dans le menu déroulant de la boîte de dialogue.
    • Choisissez CAN VIEW pour permettre aux utilisateurs sélectionnés de voir les résultats des exécutions planifiées.

refresh behavior and execution context

Lorsqu'une requête est « Exécuter en tant que propriétaire » et qu'un planning est ajouté, les informations d'identification du propriétaire de la requête sont utilisées pour l'exécution, et toute personne ayant au moins l'autorisation CAN RUN voit les résultats de ces requêtes actualisées.

Lorsqu'une query est « Exécutée en tant que spectateur » et qu'une planification est ajoutée, les identifiants du propriétaire de la planification sont utilisés pour l'exécution. Seuls les utilisateurs disposant des autorisations de planification appropriées voient les résultats des refresh queries ; tous les autres spectateurs doivent manuellement refresh pour voir les résultats de query mis à jour.