Caricare dati Stripe in BigQuery

Puoi caricare i dati da Stripe a BigQuery utilizzando il connettore Stripe con il BigQuery Data Transfer Service. Utilizzando il connettore Stripe, puoi pianificare job di trasferimento ricorrenti che aggiungono i dati più recenti da Stripe a BigQuery.

Limitazioni

I trasferimenti di dati Stripe sono soggetti alle seguenti limitazioni:

  • Un trasferimento di dati Stripe carica le valute in base alle unità minime di Stripe. Per ulteriori informazioni, consulta Unità minime negli importi delle API.
  • Il connettore Stripe trasferisce solo i report pregenerati per ogni account Stripe. Il connettore Stripe non genera nuovi report in base ai nuovi dati Stripe.
    • Per trasferire report aggiornati, generali manualmente nella dashboard di Stripe prima di avviare il trasferimento dei dati Stripe.
    • Per ulteriori informazioni, consulta Report di Stripe.
  • Il connettore Stripe non supporta gli eventi basati su webhook, gli aggiornamenti in tempo reale o Stripe Sigma.
  • I trasferimenti di dati Stripe dalle regioni Stripe in anteprima potrebbero riscontrare problemi con i trasferimenti di dati:
    • Le opzioni di filtro sono limitate o non disponibili nelle regioni di anteprima di Stripe.
    • I trasferimenti e le query di dati condizionali non sono supportati nelle regioni di anteprima di Stripe.
    • Potresti riscontrare tempi di esecuzione lunghi per il trasferimento dei dati quando trasferisci dati dalle regioni di anteprima di Stripe.
  • Il connettore Stripe supporta alcuni oggetti con il filtro StartDate.
    • Il formato richiesto per il filtro StartDate è YYYY-MM-DD. Se non viene fornita una data di inizio, il connettore utilizza per impostazione predefinita tre anni prima della data corrente. Se viene fornita una data precedente al 1° gennaio 2011, il connettore utilizza automaticamente il 1° gennaio 2011.
    • Per un elenco degli oggetti supportati, consulta Oggetti con supporto del filtro StartDate.
  • Una singola configurazione di trasferimento può supportare solo un'esecuzione di trasferimento di dati alla volta. Se è pianificata l'esecuzione di un secondo trasferimento di dati prima del completamento del primo, viene completato solo il primo trasferimento di dati, mentre gli altri trasferimenti di dati che si sovrappongono al primo vengono ignorati.
    • Per evitare trasferimenti ignorati all'interno di una singola configurazione di trasferimento, ti consigliamo di aumentare la durata del tempo tra i trasferimenti di dati di grandi dimensioni configurando la Frequenza di ripetizione.

Prima di iniziare

Le sezioni seguenti descrivono i passaggi da seguire prima di creare un trasferimento di dati Stripe.

Prerequisiti di Stripe

  • Devi disporre di un account sviluppatore Stripe per autorizzare un trasferimento di dati Stripe. Per registrare un account Stripe, consulta Registrazione di Stripe.
  • Configura l'applicazione della piattaforma Stripe seguendo questi passaggi:
    1. Vai alla sezione Sviluppatori nella dashboard di Stripe.
    2. In Connect, configura la piattaforma in modo che supporti gli account Standard ed Express.
  • Per creare un trasferimento di dati Stripe, sono necessarie le seguenti informazioni:
    • Prendi nota dell'ID account Stripe. Per ulteriori informazioni, consulta Creare un account.
    • Prendi nota della chiave segreta o della chiave limitata. Per ulteriori informazioni, consulta Chiavi API.
  • Se prevedi di trasferire dati da account collegati, assicurati che la tua piattaforma sia configurata per Stripe Connect e che abbia accesso alle funzionalità dell'account necessarie. Per ulteriori informazioni su Stripe Connect, consulta Piattaforme e marketplace con Stripe Connect.

Ruoli BigQuery richiesti

Per ottenere le autorizzazioni necessarie per creare un trasferimento, chiedi all'amministratore di concederti il ruolo IAM BigQuery Admin (roles/bigquery.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito include le autorizzazioni necessarie per creare un trasferimento. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

  • bigquery.transfers.update sull'utente
  • bigquery.datasets.get sul set di dati di destinazione
  • bigquery.datasets.update sul set di dati di destinazione

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Prerequisiti di BigQuery

Tipi di account Stripe

Il connettore Stripe supporta sia gli account della piattaforma Stripe sia gli account Stripe collegati. Per ulteriori informazioni, consulta Tipi di account Connect.

Connettersi agli account della piattaforma

Per eseguire un trasferimento di dati Stripe da un solo account della piattaforma, procedi nel seguente modo quando configuri il trasferimento:

  • Inserisci l'ID account della piattaforma nel campo ID account.
  • Inserisci la chiave segreta o limitata per l'account della piattaforma nel campo Chiave segreta/API.
  • Per SyncAllConnectedAccounts, seleziona False.

Per eseguire un trasferimento di dati Stripe per più account, ad esempio per un account della piattaforma collegato ad account collegati, procedi nel seguente modo quando configuri il trasferimento:

  • Inserisci l'ID account della piattaforma nel campo ID account.
  • Inserisci la chiave segreta o limitata per l'account della piattaforma nel campo Chiave segreta/API.
  • Per SyncAllConnectedAccounts, seleziona True.

Connettersi agli account collegati

Gli account collegati sono account Stripe collegati a Stripe tramite Stripe Connect.

Per eseguire un trasferimento di dati Stripe da un account collegato, procedi nel seguente modo quando configuri il trasferimento:

  • Inserisci l'ID account della piattaforma per l'account collegato nel campo ID account.
  • Inserisci la chiave segreta o limitata per l'account della piattaforma a cui è collegato l'account collegato nel campo Chiave segreta/API.
  • Per SyncAllConnectedAccounts, seleziona False.

Configurare un trasferimento di dati Stripe

Aggiungi i dati Stripe a BigQuery configurando un trasferimento utilizzando una delle seguenti opzioni:

Console

  1. Vai alla pagina Trasferimenti di dati nella Google Cloud console.

    Vai a Trasferimenti di dati

  2. Fai clic su Crea trasferimento.

  3. Nella sezione Tipo di origine, per Origine, seleziona Stripe.

  4. Nella sezione Dettagli origine dati, segui questi passaggi:

    • In ID account piattaforma/collegato, inserisci l'ID account Stripe. Per ulteriori informazioni, consulta Prerequisiti di Stripe.
    • In Chiave segreta Stripe, inserisci la chiave API per l'account Stripe. Per ulteriori informazioni, consulta Prerequisiti di Stripe.
    • In Data di inizio, inserisci una data nel formato YYYY-MM-DD. Il trasferimento di dati carica i dati Stripe a partire da questa data.
    • Seleziona Sincronizza tutti gli account collegati per sincronizzare tutti gli account collegati.
    • In Oggetti Stripe da trasferire, inserisci i nomi degli oggetti Stripe da trasferire oppure fai clic su Sfoglia e seleziona gli oggetti da trasferire.

  5. Nella sezione Impostazioni destinazione, per Set di dati, seleziona il set di dati che hai creato per archiviare i dati.

  6. Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome per il trasferimento di dati.

  7. Nella sezione Opzioni di pianificazione, segui questi passaggi:

    • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza con cui viene eseguito questo trasferimento di dati. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, l'esecuzione avviene quando attivi manualmente il trasferimento.
    • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.

  8. (Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:

  9. Fai clic su Salva.

bq

Inserisci il bq mk comando e fornisci il flag di creazione del trasferimento --transfer_config:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=DISPLAY_NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

Dove:

  • PROJECT_ID (facoltativo): il tuo Google Cloud ID progetto. Se non viene fornito --project_id per specificare un progetto particolare, viene utilizzato il progetto predefinito.
  • DATA_SOURCE: l'origine dati: stripe.
  • DISPLAY_NAME: il nome visualizzato per la configurazione del trasferimento di dati. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
  • DATASET: il set di dati di destinazione per la configurazione del trasferimento.

  • PARAMETERS: i parametri per la configurazione del trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per un trasferimento di dati Stripe:

    • assets: un elenco di oggetti Stripe da includere in questo trasferimento.
    • connector.accountId: l'ID account Stripe.
    • connector.secretKey: la chiave API per l'account Stripe.
    • connector.syncAllConnectedAccounts: specifica true per sincronizzare tutti gli account collegati.
    • connector.startDate: inserisci una data nel formato YYYY-MM-DD. Il trasferimento di dati carica i dati Stripe a partire da questa data.

Ad esempio, il comando seguente crea un trasferimento di dati Stripe nel progetto predefinito con tutti i parametri obbligatori:

  bq mk \
      --transfer_config \
      --target_dataset=mydataset \
      --data_source=stripe \
      --display_name='My Transfer' \
      --params= ' {
  "assets" : [ "Customers" , "Accounts", "BalanceSummaryReport"] ,
  "connector.accountId" : "acct_000000000000",
  "connector.secretKey" : "sk_test_000000000",
  "connector.syncAllConnectedAccounts" : "true",
  "connector.startDate": "2025-05-20"
  }'

API

Utilizza il projects.locations.transferConfigs.create metodo e fornisci un'istanza della TransferConfig risorsa.

Quando salvi la configurazione del trasferimento, il connettore Stripe attiva automaticamente un'esecuzione del trasferimento in base all'opzione di pianificazione. A ogni esecuzione del trasferimento, il connettore Stripe trasferisce tutti i dati disponibili da Stripe a BigQuery.

Per eseguire manualmente un trasferimento di dati al di fuori della pianificazione regolare, puoi avviare un'esecuzione di backfill.

Mappatura dei tipi di dati

La tabella seguente mappa i tipi di dati Stripe ai tipi di dati BigQuery corrispondenti.

Tipo di dati Stripe Tipo di dati BigQuery Note
String STRING
Dictionary STRING Quando un oggetto nidificato viene caricato in BigQuery, viene convertito in un oggetto appiattito. Questo oggetto appiattito viene quindi salvato come una singola stringa letterale all'interno della tabella.
Integer INT64
Double DOUBLE
Float FLOAT
Decimal BIGNUMERIC
BigInt (long) BIGNUMERIC
Boolean BOOL
Datetime TIMESTAMP
Unix timestamp TIMESTAMP

Oggetti con supporto del filtro StartDate

I seguenti oggetti Stripe supportano il filtro StartDate , che consente di caricare i dati basati sul tempo:

  • Accounts
  • ApplicationFees
  • BalanceTransactions
  • Cardholders
  • Charges
  • Coupons
  • Customers
  • Disputes
  • EarlyFraudWarnings
  • Events
  • FileLinks
  • Files
  • InvoiceItems
  • Invoices
  • IssuingCards
  • IssuingDisputes
  • PaymentIntent
  • Payouts
  • Plans
  • Prices
  • Products
  • PromotionCodes
  • Refunds
  • Reviews
  • ShippingRates
  • Subscriptions
  • TaxRates
  • TopUps
  • Transfers
  • ValueListItems
  • ValueLists

Risolvere i problemi di configurazione del trasferimento

Se riscontri problemi durante la configurazione del trasferimento di dati, consulta Problemi di trasferimento di Stripe.

Prezzi

Il trasferimento di dati Stripe in BigQuery non prevede costi durante l'anteprima di questa funzionalità .

Passaggi successivi