Plannings de requête

Dernière mise à jour : 2023-11-14
  • Rubriques :
  • Queries
    Afficher plus sur ce sujet
  • Créé pour :
  • Developer
    User
    Admin
    Leader

Vous pouvez automatiser les exécutions de requêtes en créant des plannings de requête. Les requêtes planifiées s’exécutent sur une cadence personnalisée pour gérer vos données en fonction de la fréquence, de la date et de l’heure. Vous pouvez également choisir un jeu de données de sortie pour vos résultats, si nécessaire. Les requêtes qui ont été enregistrées en tant que modèle peuvent être planifiées à partir de l’éditeur de requêtes.

IMPORTANT

Vous pouvez uniquement ajouter un planning à une requête qui a déjà été créée, enregistrée et exécutée.

Toutes les requêtes planifiées sont ajoutées à la liste dans la variable Requêtes planifiées . Depuis cet espace de travail, vous pouvez surveiller l’état de toutes les tâches de requête planifiées via l’interface utilisateur. Sur le Requêtes planifiées vous pouvez trouver des informations importantes sur vos exécutions de requête et vous abonner à des alertes. Les informations disponibles incluent l’état, les détails de planification et les codes/messages d’erreur en cas d’échec de l’exécution. Voir Surveiller le document des requêtes planifiées pour plus d’informations.

Création de plannings de requête

Pour ajouter un planning à une requête, sélectionnez un modèle de requête dans l’onglet Modèles ou Requêtes planifiées pour accéder au Query Editor.

Pour savoir comment ajouter des plannings à l’aide de l’API, veuillez lire le guide de point d’entrée des requêtes planifiées.

Lorsqu’une requête enregistrée est accessible à partir du Query Editor, l’onglet Plannings s’affiche sous le nom de la requête. Sélectionnez Plannings.

Query Editor avec l’onglet Plannings en surbrillance.

L’espace de travail des plannings s’affiche. Sélectionnez Ajouter un planning pour créer un planning.

Espace de travail Planning du Query Editor avec l’option Ajouter un planning mise en surbrillance.

La page Détails du planning s’affiche. Sur cette page, vous pouvez choisir la fréquence de la requête planifiée, la date de début et de fin, le jour de la semaine où la requête planifiée sera exécutée, ainsi que le jeu de données vers lequel exporter la requête.

Le panneau Détails du planning est mis en surbrillance.

Vous pouvez choisir les options suivantes pour Fréquence :

  • Horaire : la requête planifiée s’exécute toutes les heures pour la période que vous avez sélectionnée.
  • Quotidien : la requête planifiée s’exécute tous les X jours à l’heure et à la période que vous avez sélectionnées. Notez que l’heure sélectionnée est indiquée en UTC, et non dans votre fuseau horaire local.
  • Hebdomadaire : la requête sélectionnée sera exécutée aux jours de la semaine, à l’heure et à la période que vous avez sélectionnés. Notez que l’heure sélectionnée est indiquée en UTC, et non dans votre fuseau horaire local.
  • Mensuel : la requête sélectionnée s’exécute tous les mois au jour, à l’heure et à la période que vous avez sélectionnés. Notez que l’heure sélectionnée est indiquée en UTC, et non dans votre fuseau horaire local.
  • Annuel : la requête sélectionnée s’exécute chaque année au jour, au mois, à l’heure et à la période que vous avez sélectionnés. Notez que l’heure sélectionnée est indiquée en UTC, et non dans votre fuseau horaire local.

Pour le jeu de données de sortie, vous avez la possibilité d’utiliser un jeu de données existant ou de créer un nouveau jeu de données.

IMPORTANT

Puisque vous utilisez un jeu de données existant ou que vous en créez un nouveau, vous n’avez pas besoin d’inclure INSERT INTO ou CREATE TABLE AS SELECT dans le cadre de la requête, puisque les jeux de données sont déjà définis. L’inclusion de INSERT INTO ou CREATE TABLE AS SELECT dans le cadre de vos requêtes planifiées entraînera une erreur.

Si vous n’avez pas accès aux requêtes paramétrées, passez à la suppression ou désactivation d’une planification .

Définir les paramètres d’une requête planifiée planifiée

IMPORTANT

La fonction d’IU de requête paramétrée est actuellement disponible dans une version limitée uniquement et n’est pas disponible pour tous les clients.

Si vous créez une requête planifiée pour une requête paramétrée, vous devez maintenant définir les valeurs des paramètres pour ces exécutions de requête.

La section Détails de la planification du workflow de création de la planification avec la section Paramètres de requête mise en surbrillance.

Après avoir confirmé tous ces détails, sélectionnez Enregistrer pour créer un planning. L’espace de travail des plannings affiche les détails du planning nouvellement créé, y compris l’ID du planning, le planning lui-même et le jeu de données de sortie du planning. Vous pouvez utiliser l’ID de planning pour rechercher plus d’informations sur les exécutions de la requête planifiée elle-même. Pour en savoir plus, veuillez lire le guide des points d’entrée d’exécution de requête planifiée.

Espace de travail des plannings avec le nouveau planning mis en surbrillance.

Supprimer ou désactiver un planning

Vous pouvez supprimer ou désactiver un planning dans l’espace de travail des plannings d’une requête spécifique ou dans l’ Requêtes planifiées Workspace qui répertorie toutes les requêtes planifiées.

Pour accéder au Planifications de la requête choisie, vous devez sélectionner le nom d'un modèle de requête parmi les Modèles ou le Requêtes planifiées . L’éditeur de requêtes de cette requête est alors accessible. Dans Query Editor, sélectionnez Planifications pour accéder à l’espace de travail des plannings.

Sélectionnez un planning dans les lignes des plannings disponibles. Vous pouvez activer ou désactiver la requête planifiée à l’aide du bouton d’activation.

IMPORTANT

Vous devez désactiver le planning avant de pouvoir supprimer un planning pour une requête.

Sélectionnez Supprimer un planning pour supprimer le planning désactivé.

L’espace de travail des plannings avec l’option Désactiver le planning et Supprimer le planning est en surbrillance.

Vous pouvez également utiliser la variable Requêtes planifiées tab propose une collection d’actions intégrées pour chaque requête planifiée. Les actions intégrées disponibles sont les suivantes : Désactiver le planning ou Activation du planning, Supprimer le planning, et Abonner aux alertes pour la requête planifiée. Pour obtenir des instructions complètes sur la suppression ou la désactivation d’une requête planifiée via l’onglet Requêtes planifiées, voir la section guide de suivi des requêtes planifiées.

Sur cette page