Découvrez comment Sigma et Data Pipeline traitent les données.
Sigma et Data Pipeline vous permettent d’analyser et d’exporter les mêmes données sous-jacentes que celles accessibles via l’API Stripe, mais via des interfaces différentes. Alors que l’API Stripe fournit un accès programmatique à vos données, Sigma offre une interface SQL qui permet d’effectuer des requêtes et analyses personnalisées, et Data Pipeline permet d’exporter des données en masse.
De plus, Sigma et Data Pipeline permettent d’accéder à certaines données qui ne sont pas disponibles via l’API Stripe, notamment les rapports.
Actualisation des données
Sigma et Data Pipeline vous permettent d’interroger la plupart de vos données sous 24 h.
Sigma met à votre disposition la plupart de vos données de transaction Stripe sous trois heures. Toutes les activités de l’API peuvent faire l’objet d’une requête environ trois heures après qu’elles se soient produites. Par exemple, les données datées de 0h00 UTC seront disponibles à 3h00 UTC le même jour.
Temps de chargement des données de requête
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 , alors data_load_time est interprété comme le 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 balancewhere
created < data_load_time and
created >= data_load_time - interval '1' month
orderby created desclimit10
La chronologie suivante illustre comment cela fonctionne en fonction de la disponibilité des données :
Date
Chronologie des résultats
data_load_time est interprété comme
La requête planifiée inclut les données de transaction au , fin de journée
Les résultats de la requête sont disponibles le à 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 est quotidienne, la chronologie suivante illustre le moment où vous pourrez obtenir des résultats :
Date
Chronologie des résultats
data_load_time est interprété comme 00:00:00 +0000
La requête planifiée inclut les données de transaction au , fin de journée
Les résultats de la requête sont disponibles le à 02 h 00 UTC
Actualisation des jeux de données
Pour plus d’informations sur l’actualisation de jeux de données spécifiques, consultez les tableaux suivants :
Jeu de données
Nom du tableau
Actualisation de Sigma
Actualisation de SDP
billing
bons de réduction
3
9
billing
coupons_currency_options
3
9
billing
coupons_metadata
3
9
billing
credit_note_discount_amounts
3
9
billing
credit_note_line_item_discount_amounts
3
9
billing
credit_note_line_item_tax_amounts
3
9
billing
credit_note_line_items
3
9
billing
credit_note_tax_amounts
3
9
billing
credit_notes
3
9
billing
credit_notes_metadata
3
9
billing
réductions
3
9
billing
invoice_custom_fields
3
9
billing
invoice_customer_tax_ids
3
9
billing
invoice_items
3
9
billing
invoice_items_metadata
3
9
billing
invoice_line_item_discount_amounts
3
9
billing
invoice_line_item_tax_amounts
3
9
billing
invoice_line_items
3
9
billing
invoice_payments
3
9
billing
invoice_shipping_cost_taxes
3
9
billing
factures
3
9
billing
invoices_metadata
3
9
billing
offres
3
9
billing
plans_metadata
3
9
billing
price_tiers
3
9
billing
prices
3
9
billing
prices_currency_options
3
9
billing
prices_metadata
3
9
billing
products
3
9
billing
products_metadata
3
9
billing
promotion_codes
3
9
billing
devis
3
9
billing
subscription_items
3
9
billing
subscription_items_metadata
3
9
billing
subscription_schedule_phase_add_invoice_items
3
9
billing
subscription_schedule_phase_configuration_items
3
9
billing
subscription_schedule_phases
3
9
billing
subscription_schedule_phases_metadata
3
9
billing
subscription_schedules
3
9
billing
subscription_schedules_metadata
3
9
billing
subscriptions
3
9
billing
subscriptions_metadata
3
9
billing
tax_rates
3
9
billing
tax_rates_metadata
3
9
billing
usage_records
3
9
paiement
checkout_custom_fields
3
9
paiement
checkout_line_items
3
9
paiement
checkout_sessions
3
9
paiement
payment_links
3
9
connect
comptes
3
9
connect
accounts_metadata
3
9
connect-fees
application_fee_refunds
3
9
connect-fees
application_fee_refunds_metadata
3
9
connect-fees
application_fees
3
9
cryptomonnaie
crypto_onramp_sessions
3
9
clients
customer_balance_transactions
3
9
clients
customer_balance_transactions_metadata
3
9
clients
customer_cash_balance_transactions
3
9
clients
customer_tax_ids
3
9
clients
clients
3
9
clients
customers_metadata
3
9
issuing
issuing_authorizations
3
9
issuing
issuing_authorizations_metadata
3
9
issuing
issuing_cardholders
3
9
issuing
issuing_cardholders_metadata
3
9
issuing
issuing_cards
3
9
issuing
issuing_cards_metadata
3
9
issuing
issuing_disputes
3
9
issuing
issuing_network_tokens
3
9
issuing
issuing_transactions
3
9
issuing
issuing_transactions_metadata
3
9
paiements
balance_transaction_fee_details
3
9
paiements
balance_transactions
3
9
paiements
charges
3
9
paiements
charges_metadata
3
9
paiements
litiges
3
9
paiements
disputes_enhanced_eligibility
3
9
paiements
disputes_metadata
3
9
paiements
payment_intents
3
9
paiements
payment_intents_metadata
3
9
paiements
payment_method_details
3
9
paiements
payment_methods
3
9
paiements
payment_methods_metadata
3
9
paiements
payment_reviews
3
9
paiements
remboursements
3
9
paiements
refunds_metadata
3
9
paiements
rule_decisions
3
9
paiements
setup_attempts
3
9
paiements
setup_intents
3
9
paiements
setup_intents_metadata
3
9
paiements
sources
3
9
paiements
sources_metadata
3
9
Schéma de données
Vous pouvez afficher le schema complet, qui suit de près nos conventions d’API, dans un format de vue partagée qui montre les détails sur les relations entre les tableaux. Il affiche toutes les données disponibles que vous pouvez utiliser dans vos requêtes, classées par catégorie. Chaque catégorie contient un ensemble de tableaux qui représentent les données disponibles. De nombreuses tableaux correspondent à des objets API spécifiques, chaque colonne représentant un attribut rapporté. Par exemple, le tableau charges représente des informations sur les objets Débiter, qui apparaissent dans la section Paiements du Dashboard.
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 et Foreign key). Placez le curseur sur n’importe quelle colonne pour afficher une description. Utilisez le champ de recherche en haut du schéma pour trouver des tables ou colonnes spécifiques. Lorsque vous rédigez des requêtes, reportez-vous à la documentation de l’API, où vous trouverez davantage de contexte et de valeurs.