Planifier une requête

Important

Cette fonctionnalité est disponible en préversion publique. Contactez votre représentant Azure Databricks pour demander un accès.

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

Pour définir la planification :

  1. Cliquez sur l’onglet informations sur la requête.

    Informations sur la requête

  2. Cliquez sur le lien à droite de Actualiser la planification pour ouvrir un sélecteur avec des intervalles de planification.

    Intervalle de planification

  3. Définissez la planification.

    Le sélecteur défile et vous permet de choisir :

    • Intervalle : 1-30 minutes, 1-12 heures, 1 ou 30 jours, 1 ou 2 semaines

    • Une heure. Le sélecteur d’heure s’affiche dans le sélecteur uniquement lorsque l’intervalle est supérieur à 1 jour et que la sélection du jour est supérieure à 1 semaine. Lorsque vous planifiez une heure spécifique, SQL Analytics prend une entrée dans le fuseau horaire de votre ordinateur et la convertit en heure UTC. Si vous souhaitez qu’une requête s’exécute à un moment donné au format UTC, vous devez ajuster le sélecteur en indiquant votre décalage local. Par exemple, si vous souhaitez qu’une requête s’exécute à 00:00 l’heure UTC chaque jour, mais que votre fuseau horaire actuel est PDT (UTC-7), vous devez sélectionner 17:00 dans le sélecteur :

      Intervalle de planification hebdomadaire

  4. Cliquez sur OK.

    Votre requête est exécutée automatiquement.

    Si vous rencontrez une requête planifiée qui n’est pas exécutée en fonction de sa planification, vous devez déclencher manuellement la requête pour vous assurer qu’elle n’échoue pas. Toutefois, vous devez être conscient des points suivants :

    • Si vous planifiez un intervalle, par exemple « toutes les 15 minutes », l’intervalle est calculé à partir de la dernière exécution réussie. Si vous exécutez une requête manuellement, la requête planifiée n’est pas exécutée tant que l’intervalle n’est pas écoulé.
    • Si vous planifiez une heure, SQL Analytics attend que les résultats soient « obsolètes ». Par exemple, si vous avez un ensemble de requêtes à actualiser tous les jeudis et que vous l’exécutez manuellement le mercredi, les résultats seront toujours considérés comme « valides », ce qui signifie que la requête n’est pas planifiée pour une nouvelle exécution. Ainsi, par exemple, lors de la définition d’une planification hebdomadaire, vérifiez la durée d’exécution de la dernière requête et attendez l’exécution de la requête planifiée le jour sélectionné après cette exécution. Veillez à ne pas exécuter la requête manuellement pendant cette période.

    En cas d’échec de l’exécution d’une requête, SQL Analytics effectue une nouvelle tentative avec un algorithme d’interruption. Plus le nombre de défaillances est éloigné, plus la prochaine tentative sera proche (et l’intervalle d’actualisation peut être dépassé).

Rapports d’échec de la requête

Si une ou plusieurs requêtes échouent, les messages électroniques SQL Analytics interrogent les propriétaires une fois par heure. Ces e-mails se poursuivent jusqu’à ce qu’il n’y ait plus de défaillances. Les e-mails de rapport d’échec s’exécutent sur un processus indépendant à partir des planifications de requête réelles. L’échec de l’exécution de la requête peut prendre jusqu’à une heure avant que SQL Analytics n’envoie le rapport d’échec.

Si les propriétaires de requêtes ne reçoivent pas de rapports d’échec par e-mail en cas d’échec des requêtes planifiées, votre administrateur les a désactivées pour votre instance SQL Analytics.