Actualisation des données

Comprendre l'actualisation des données Stripe ainsi que l'onglet Schéma.

Sigma et Data Pipeline fournissent un accès aux données Stripe disponibles avec l’API Stripe. Vous pouvez aussi accéder aux données telles que les rapports financiers Stripe, qui ne sont pas disponibles dans l’API Stripe.

Actualisation des données

Sigma et Data Pipeline mettent la plupart de vos données à disposition pour requête sous un jour.

Sigma met la plupart de vos données de transaction à disposition pour requête dans un délai d’un jour. Toute l’activité de l’API pour un jour donné (de 00 h 00 à 23 h 59 UTC) est disponible pour vos requêtes à midi UTC le lendemain. Par exemple, vos données du jour à la fin de la journée du dimanche (heure UTC) sont disponibles le lundi midi UTC. De même, vos données mensuelles au dernier jour du mois sont disponibles le premier jour du mois suivant.

Temps de chargement des données avec Sigma

L’interface du Dashboard affiche la date et l’heure des dernières données de paiement. Vous pouvez utiliser data_load_time comme valeur dans vos requêtes pour représenter la date à laquelle les données ont été traitées en dernier lieu sur votre compte. Par exemple, si la mise à jour des tables des données de paiement a été effectuée pour la dernière fois le 14/12/2023, alors data_load_time est interprété comme le 2023-12-11 00:00:00 +0000. Parfois, Sigma peut rendre compte d’une activité plus récente que la date indiquée par data_load_time. Par exemple, un paiement autorisé juste avant minuit, mais capturé peu après, peut apparaître comme capturé.

La mise à disposition des données requiert un délai supplémentaire. Vous pouvez utiliser data_load_time comme valeur dans vos requêtes pour représenter la date à laquelle les données ont été traitées en dernier lieu sur votre compte. Utilisez cette valeur pour définir de façon dynamique une plage de dates dans vos requêtes planifiées.

Par exemple, examinez la requête planifiée suivante, qui renvoie la liste des opérations sur solde créées un mois avant la date indiquée par data_load_time.

select
  id,
  amount,
  fee,
  currency
from balance_transactions -- this table is the canonical record of changes to your Stripe balance
where
  created < data_load_time and
  created >= data_load_time - interval '1' month
order by created desc
limit 10

Voici un exemple de chronologie de disponibilité des données.

Date	Chronologie des résultats
2023-12-11	`data_load_time` est interprété comme `2023-12-11` La requête planifiée inclut les données de transaction au 2023-12-10, fin de journée Les résultats de la requête sont disponibles le 2023-12-11 à 14 h 00 UTC

Examinez à présent la requête planifiée suivante, qui renvoie la liste des charge_ids et des montants de facturation d’interchange associés à chaque débit du solde des frais créé un mois avant la date indiquée par data_load_time.

select
  ic.charge_id,
  ic.billing_currency,
  ic.billing_amount,
  ic.balance_transaction_id,
  ic.balance_transaction_created_at
from icplus_fees as ic
join balance_transactions as bt
  on ic.balance_transaction_id = bt.id
where bt.created >= data_load_time - interval '1' month
  and bt.created < data_load_time

Si cette requête se répète quotidiennement, la chronologie suivante indique le moment auquel vous recevrez les résultats.

Date	Chronologie des résultats
2023-12-14	`data_load_time` est interprété comme `2023-12-11 00:00:00 +0000` La requête planifiée inclut les données de transaction au 2023-12-10, fin de journée Les résultats de la requête sont disponibles le 2023-12-14 à 02 h 00 UTC

Actualisation des données des jeux de données

Référez-vous au tableau ci-dessous pour obtenir des informations concernant l’actualisation des données pour des jeux de données spécifiques.

Jeu de données	Exemples de tables	Actualisation de Sigma	Actualisation de Data Pipeline
Tables des API principales (y compris les versions Connect)	`balance_transactions`, `charges`, `connected_account_balance_transactions`	24 heures	9 heures
Tables actualisées quotidiennement	`exchange_rates_from_usd`, `radar_rules`	24 heures	28 heures

À propos du schéma

Notre documentation des schémas présente les schémas dans un format d’affichage fractionné et donne plus d’informations sur les liaisons de tables.

Le schéma suit autant que possible les conventions de notre API. De nombreuses tables correspondent à des objets d’API spécifiques et chaque colonne représente un attribut particulier faisant l’objet d’une requête. Par exemple, la table charges représente les informations des objets Charge, qui sont affichées dans la section Paiements du Dashboard.

Lorsque vous écrivez des requêtes, consultez la documentation de l’API pour obtenir plus de contenu et de valeurs.

Onglet Schéma de Sigma

L’onglet Schéma dans Sigma affiche toutes les données disponibles que vous pouvez utiliser dans vos requêtes, organisées par catégorie. Chaque catégorie contient un ensemble de tables qui représente les données disponibles.

Vous pouvez sélectionner une table pour la développer et afficher ses colonnes disponibles ainsi qu’une description du type de données qu’elle contient (par exemple : Boolean, Varchar, Foreign key, etc.). Survolez une colonne avec le curseur pour afficher sa description. Utilisez le champ de recherche disponible en haut du schéma pour rechercher des tables et des colonnes spécifiques.