Accéder aux données de votre entrepôt de données avec Data Pipeline

Data Pipeline est un produit sans code qui envoie l’ensemble de vos données et rapports Stripe à Snowflake ou Amazon Redshift. Cela vous permet de centraliser vos données Stripe avec d’autres données commerciales pour clôturer vos comptes plus rapidement et bénéficier d’informations plus détaillées.

Grâce à Data Pipeline, vous pouvez :

• Exporter automatiquement la totalité de vos données Stripe en toute sécurité et rapidité.
• Cesser de vous appuyer sur des pipelines d’extraction, de transformation et de chargement (ETL) tiers ou sur des intégrations d’API préconfigurées.
• Combiner les données de tous vos comptes Stripe dans un seul entrepôt de données.
• Intégrer les données Stripe aux autres données de votre entreprise pour obtenir des analyses commerciales plus complètes.

Prise en charge des bases de données

À l’heure actuelle, Data Pipeline prend en charge les régions de données de Snowflake (déployé sur AWS) et Amazon Redshift. Référez-vous au tableau ci-dessous pour obtenir plus d’informations sur les instances prises en charge.

Data Pipeline ne prend pas encore en charge les instances non-AWS, telles que Google Cloud Storage (GCS) ou Microsoft Azure.

Stripe ne propose pas les services de Data Pipeline aux clients, marchands et utilisateurs en Inde en raison des exigences de localisation des données.

Démarrer

Lors de votre inscription à Data Pipeline, Stripe envoie un partage de données à votre compte Snowflake ou Amazon Redshift. Une fois que vous avez accepté le partage de données, vous pouvez accéder à vos données Stripe principales dans Snowflake ou Amazon Redshift sous 12 heures. Après le chargement initial, vos données Stripe s’actualisent régulièrement.

Modifier le compte d’entrepôt

Pour modifier le compte d’entrepôt auquel votre ompte Stripe est connecté :

1. Désactivez Data Pipeline sur la page des paramètres du Dashboard.
2. Réinscrivez-vous à Data Pipeline en suivant les étapes décrites ci-dessus pour le nouveau compte d’entrepôt auquel vous souhaitez vous connecter.

Pour ajouter un autre compte Stripe à votre compte d’entrepôt :

1. Suivez les étapes d’inscription ci-dessous pour créer votre compte Stripe.
2. Utilisez le même identifiant de compte que ci-dessus pour l’entrepôt correspondant. Pour trouver l’ID de votre compte, accédez à la page des paramètres du Dashboard et localisez le champ ID sous Entrepôt de données connecté.

Interroger des données Stripe dans votre entrepôt de données

Dans Snowflake et Amazon Redshift, vos données sont disponibles sous forme de vues sécurisées. Suivez les étapes ci-dessous afin d’interroger vos données.

Schémas de base de données

Les données de votre entrepôt sont divisées en deux schémas de base de données, en fonction du mode d’API utilisé pour créer les données.

Entrepôt de données utilisé par plusieurs comptes Stripe

Si vous partagez les données de plusieurs comptes Stripe avec un même entrepôt de données, vous pouvez les identifier séparément. Chaque tableau comporte une colonne merchant_id, qui vous permet de filtrer les données par marchand et par compte.

Exemple de cas d’usage

Dans certains cas, vous pouvez souhaiter regrouper les informations issues de vos données propriétaires avec les données de Stripe. Le schéma qui suit expose une table orders qui liste les informations à propos d’une commande pour une entreprise :

Le tableau ci-dessus ne contient pas les données relatives aux frais de transaction ou aux virements, car ces données ne sont disponibles que dans Stripe. Dans Stripe, le tableau balance_transactions contient les informations suivantes, mais les données propriétaires concernant les noms des clients et les articles achetés n’y figurent pas :

Pour accéder à vos données propriétaires en même temps qu’à vos données Stripe, associez le tableau orders au tableau balance_transactions de Stripe :

select
  orders.date,
  orders.order_no,
  orders.stripe_txn_no,
  bts.amount,
  bts.fee,
  bts.automatic_transfer_id
from mycompany.orders join stripe.balance_transactions bts
on orders.stripe_txn_no = bts.id;

Une fois l’opération terminée, les informations suivantes sont disponibles :

Jeux de données

Vous pouvez consulter la liste des ensembles de données disponibles dans la section **Ensembles de données ** de la documentation consacrée aux schémas du Dashboard. Les ensembles de données disponibles peuvent varier en fonction de la région, et dépendent de la disponibilité et des réglementations locales. Chaque ensemble de données contient une ou plusieurs tables d’entrepôt de données, et est partagé par Data Pipeline séparément chaque fois que de nouvelles données sont disponibles. Data Pipeline met à jour différentes tables à différentes fréquences, en fonction de la disponibilité des nouvelles données. Pour en savoir plus sur les ensembles de données disponibles et les fréquences d’actualisation, consultez la documentation consacrée à l’actualisation des données.

Notifications par e-mail

Vous pouvez également vous abonner pour recevoir des notifications par e-mail pour les mises à jour importantes dans le Dashboard.

Rapports financiers dans Data Pipeline

Pour accélérer votre clôture financière, vous pouvez accéder aux rapports financiers de Stripe directement dans votre entrepôt de données.

Les modèles de rapport financier possèdent le préfixe FINANCIAL_REPORT et sont disponibles sous forme de vues dans votre entrepôt de données.

Générer des rapports financiers dans Snowflake

Pour générer des rapports financiers depuis Data Pipeline, vous devez définir quelques variables personnalisées. Il s’agit des mêmes que celles nécessaires pour générer le rapport via le Dashboard ou l’API :

• START_DATE (varchar) : date de début du rapport (incluse).
• END_DATE (varchar) : date de fin du rapport (exclue).
• TIMEZONE (varchar) : fuseau horaire des colonnes d’horodatage non UTC.

Pour définir ces variables et exécuter la requête de rapport :

1. Créez une nouvelle feuille de calcul.

2. Définissez le schéma de la base de données et les variables exigées pour les valeurs souhaitées.

   -- set schema based on the name you gave your Stripe database
   use schema db_name.stripe;
   -- set financial report template variables
   set (TIMEZONE, START_DATE, END_DATE) = ('UTC', '2021-09-01', '2021-10-01');

   Mise en garde

   Exécutez ces lignes de code séparément avant toute tentative d’interrogation des tables qui en ont besoin. Sinon, un message d’erreur risque de s’afficher pour vous avertir qu’une variable de session n’existe pas.

   Si vous utilisez le connecteur Snowflake pour Python, définissez le paramètre de session TIMEZONE à l’aide de la commande ALTER SESSION SET TIMEZONE = 'UTC'.

3. Après l’exécution du code qui définit les variables nécessaires, exécutez une requête pour la vue du rapport que vous souhaitez générer. Par exemple :

   select * from FINANCIAL_REPORT_BALANCE_CHANGE_FROM_ACTIVITY_ITEMIZED;

   Renvoie les mêmes résultats que ceux qui sont affichés par le rapport de modification du solde par catégories selon l’activité dans le Dashboard ou via l’API :

   

Désactiver Data Pipeline

Vous pouvez désactiver Data Pipeline sur la page des paramètres du Dashboard en cliquant sur Désactiver. Après la déconnexion, vous perdrez immédiatement l’accès à vos données partagées.