コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース
概要
Billing
概要Billing API について
サブスクリプション
Invoicing
従量課金
見積もり
顧客管理
Billing と他のプロダクトの連携
売上回収
オートメーション
実装内容をテストする
税金
概要
Stripe tax を使用
法規制の遵守・対応管理
レポート機能
概要
レポートの選択
レポートを設定
Reports API
複数のアカウントのレポート
収益認識
データ
概要スキーマ
カスタムレポート
Data Pipeline
データ管理
    概要
    ビジネスと商品データのユースケース
    外部データをインポート
ホーム売上Data management

データの鮮度

Sigma と Data Pipeline を利用したデータ処理についてご紹介します。

Sigma と Data Pipeline を使用すると、Stripe API を介してアクセスできますが、インターフェイスが異なる同じ基になるデータを分析およびエクスポートできます。Stripe API では、データへのプログラムによるアクセスを提供しますが、Sigma は SQL ベースのインターフェイスを提供し、カスタムクエリと分析に利用できます。また、Data Pipeline はデータの一括エクスポートを行えます。

さらに、Sigma と Data Pipeline は、レポートなど、Stripe API では利用できない特定のデータへのアクセスを提供します。

データの鮮度

Sigma と Data Pipeline を使用すると、ほとんどの取引データを 1 日以内にクエリできるようになります。

Sigma では、Stripe 取引データのほとんどを 3 時間以内にクエリできるようになります。すべての API アクティビティは、発生から約 3 時間後にクエリに使用できます。たとえば、午前 12:00 UTC のデータは、同日の午前 3:00 UTC までに利用できます。

クエリデータの読み込み時間

ダッシュボードのインターフェイスには、最後の支払いデータの日時が表示されます。クエリの値として data_load_time を使用すると、アカウントでデータが最後に処理された日時を表すことができます。たとえば、支払いテーブルが最後に更新されたのが 2025/8/17 の場合、data_load_time は 2025-08-14 00:00:00 +0000 と解釈されます。場合により、Sigma は data_load_time よりも最近のアクティビティーを反映していることがあります。たとえば、午前 0 時 (UTC) 直前にオーソリされ、その直後にキャプチャーされた支払いが、キャプチャー済みと表示される場合があります。

データを使用できるようにするには、さらに時間が必要です。data_load_time は、ご利用のアカウントで最後にデータが処理された日付を表すクエリの値として使用できます。この値を使用して、スケジュール済みのクエリの日付の範囲を動的に設定します。

たとえば、data_load_time の 1 カ月前に作成された取引残高のリストを返す以下のスケジュール済みのクエリについて考えてみます。

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

次のタイムラインは、データの可用性に基づいてこれがどのように機能するかを表します。

日付結果のタイムライン
2025-08-14
  • data_load_time は 2025-08-14 として解釈されます
  • スケジュール済みのクエリには、2025-08-13 の終わりまでの取引データが含まれます
  • クエリ結果は、2025-08-14 の 2pm UTC までに利用可能になります

次に、data_load_time の 1 カ月前に作成された各手数料の残高引き落としに関連付けられた charge_ids とインターチェンジ請求額のリストを返す、以下のスケジュール済みのクエリについて考えます。

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

このクエリが毎日反復的に実行されるようにスケジュールされている場合、結果を取得できるタイミングは、次のタイムラインのようになります。

日付結果のタイムライン
2025-08-17
  • data_load_time は 2025-08-14 00:00:00 +0000 として解釈されます
  • スケジュール済みのクエリには、2025-08-13 の終わりまでの取引データが含まれます
  • クエリ結果は、2025-08-17 の 2am UTC までに利用可能になります

データスキーマ

API 規則に厳密に従った完全な スキーマを、テーブル関係性の詳細を示す分割ビュー形式で表示することができます。クエリで使用できるすべてのデータが、カテゴリー別に整理されて表示されます。各カテゴリーには、使用可能なデータを表す一連のテーブルが含まれています。多くのテーブルは、特定の API オブジェクトに対応しており、各列は報告された属性を表します。たとえば、charges テーブルは、Chargeオブジェクトに関する情報を表示します。また、ダッシュボードの支払いセクションに表示されます。

表を選択して展開し、利用可能な列とそれに含まれるデータ型の説明を表示できます (Boolean、Varchar、Foreign key など)。任意の列の上にカーソルを合わせると、その説明が表示されます。スキーマの上部に表示される検索フィールドを使用して、特定のテーブルと列を検索することもできます。クエリを記述する際は、追加のコンテキストと値については、API リファレンスを参照してください。

データセットの鮮度

データセットのデータ鮮度については、次の表を参照してください。

データセットテーブル名Sigma の鮮度SDP の鮮度
billingクーポン39
billingcoupons_currency_options39
billingcoupons_metadata39
billingcredit_note_discount_amounts39
billingcredit_note_line_item_discount_amounts39
billingcredit_note_line_item_tax_amounts39
billingcredit_note_line_items39
billingcredit_note_tax_amounts39
billingcredit_notes39
billingcredit_notes_metadata39
billingdiscounts39
billinginvoice_custom_fields39
billinginvoice_customer_tax_ids39
billinginvoice_items39
billinginvoice_items_metadata39
billinginvoice_line_item_discount_amounts39
billinginvoice_line_item_tax_amounts39
billinginvoice_line_items39
billinginvoice_payments39
billinginvoice_shipping_cost_taxes39
billing請求書39
billinginvoices_metadata39
billingplans39
billingplans_metadata39
billingprice_tiers39
billing料金39
billingprices_currency_options39
billingprices_metadata39
billing商品39
billingproducts_metadata39
billingpromotion_codes39
billing見積もり39
billingsubscription_items39
billingsubscription_items_metadata39
billingsubscription_schedule_phase_add_invoice_items39
billingsubscription_schedule_phase_configuration_items39
billingsubscription_schedule_phases39
billingsubscription_schedule_phases_metadata39
billingsubscription_schedules39
billingsubscription_schedules_metadata39
billingサブスクリプション39
billingsubscriptions_metadata39
billingtax_rates39
billingtax_rates_metadata39
billingusage_records39
checkoutcheckout_custom_fields39
checkoutcheckout_line_items39
checkoutcheckout_sessions39
checkoutpayment_links39
connect口座39
connectaccounts_metadata39
connect-feesapplication_fee_refunds39
connect-feesapplication_fee_refunds_metadata39
connect-feesapplication_fees39
cryptocrypto_onramp_sessions39
customerscustomer_balance_transactions39
customerscustomer_balance_transactions_metadata39
customerscustomer_cash_balance_transactions39
customerscustomer_tax_ids39
customerscustomers39
customerscustomers_metadata39
issuingissuing_authorizations39
issuingissuing_authorizations_metadata39
issuingissuing_cardholders39
issuingissuing_cardholders_metadata39
issuingissuing_cards39
issuingissuing_cards_metadata39
issuingissuing_disputes39
issuingissuing_network_tokens39
issuingissuing_transactions39
issuingissuing_transactions_metadata39
paymentsbalance_transaction_fee_details39
paymentsbalance_transactions39
payments支払い39
paymentscharges_metadata39
payments不審請求申請39
paymentsdisputes_enhanced_eligibility39
paymentsdisputes_metadata39
paymentsexternal_account_bank_accounts39
paymentsexternal_account_cards39
paymentspayment_intents39
paymentspayment_intents_metadata39
paymentspayment_method_details39
paymentspayment_methods39
paymentspayment_methods_metadata39
paymentspayment_reviews39
payments返金39
paymentsrefunds_metadata39
paymentsrule_decisions39
paymentssetup_attempts39
paymentssetup_intents39
paymentssetup_intents_metadata39
paymentssources39
paymentssources_metadata39
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 早期アクセスプログラムにご参加ください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc