Planifier des requêtes

Vous pouvez automatiser vos requêtes Stripe Sigma en planifiant une exécution quotidienne, hebdomadaire ou mensuelle. Les résultats de chaque requête planifiée sont envoyés par e-mail aux membres de l’équipe spécifiés ou sous forme d’événements webhook.

Planification d’une requête

Chargez une requête dans l’éditeur, puis cliquez sur ** Planifier**. Nous vous recommandons de donner un nom unique à chacune de vos requêtes planifiées afin d’éviter toute confusion. Si votre requête n’a pas encore de nom (ou si vous souhaitez le modifier), vous pouvez le définir au cours du processus de planification.

Calendrier

Chaque requête planifiée peut être exécutée sur une base quotidienne, hebdomadaire ou mensuelle. Les requêtes sont exécutées dès que les données correspondant à cette période sont disponibles.

Abonnés

Par défaut, les créateurs de requêtes planifiées sont abonnés aux notifications par e-mail. Pour envoyer des notifications à d’autres membres de l’équipe, saisissez leur adresse e-mail. Les résultats envoyés par e-mail incluent le nom et la date de la requête planifiée, ainsi qu’un lien permettant de télécharger les résultats au format CSV. Pour afficher un aperçu de l’e-mail, cliquez sur Aperçu de l’e-mail.

Vous, comme les membres de votre équipe, pouvez à tout moment cesser de recevoir des notifications en cliquant sur le lien Se désabonner figurant dans l’e-mail. Vous pouvez aussi modifier la requête planifiée dans le Dashboard et ajouter ou retirer des abonnés.

Chronologie

Selon le calendrier choisi, la chronologie affiche la date de la prochaine exécution de votre requête ainsi que la date prévue de traitement des données (un délai supplémentaire est nécessaire avant que vous ne puissiez interroger les données de votre compte).

Gestion des requêtes planifiées Les requêtes planifiées à venir sont affichées dans la section Planifiées de l’onglet Requêtes. Les calendriers sont regroupés selon leurs créateurs (c’est-à-dire vous-même ou d’autres membres de votre équipe).

Pour modifier une requête planifiée, sélectionnez-la et cliquez sur Modifier le calendrier. Pour la supprimer, cliquez sur — et sélectionnez Supprimer.

Réception des résultats sous forme de webhooks

Si vous utilisez des webhooks, vous pouvez recevoir des notifications pour les requêtes planifiées sous forme d’événements de webhook. Par exemple, Stripe envoie l’événement sigma.scheduled_query_run.created à chaque exécution d’une requête planifiée. Vous pouvez consulter un exemple d’événement ci-dessous.

Le sous-champ data.object.file.url de la charge utile du webhook contient l’URL sur laquelle vous pouvez accéder au fichier de résultats en utilisant votre clé API secrète de production. Par exemple, si votre serveur reçoit le webhook ci-dessous, vous pouvez télécharger les résultats à l’aide de cette commande curl :

curl https://files.stripe.com/v1/files/{{ FILE ID }}/contents -u sk_live_XXXXXXX:

Pour en savoir plus sur la façon d’intégrer les webhooks, consultez notre documentation sur les webhooks.

// Sample payload of a sigma.scheduled_query_run.created webhook

{
  "object": "event",
  "pending_webhooks": 2,
  "created": 1504794194,
  "type": "sigma.scheduled_query_run.created",
  "livemode": true,
  "request": null,
  "data": {
    "object": {
      "id": "sqr_3HTcNOauOAxzvBfDErMm",
      "object": "scheduled_query_run",
      "status": "completed",
      "data_load_time": 1504656000,
      "file": {
        "id": "{{ FILE ID }}",
        "object": "file",
        "url": "https://files.stripe.com/v1/files/{{ FILE ID }}/contents",
        "created": 1507841188,
        "purpose": "sigma_scheduled_query",
        "size": 53075,
        "type": "csv"
      },
      "title": "Scheduled Query Example",
      "sql": "SELECT count(*) FROM charges WHERE created >= date('2017-01-01')",
      "created": 1504794194,
      "result_available_until": 1505398933,
      "error": null,
      "livemode": true
    }
  }
}