データの鮮度

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

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

ダッシュボードのインターフェイスには、最後の支払いデータの日時が表示されます。クエリの値として data_load_time を使用すると、アカウントでデータが最後に処理された日時を表すことができます。たとえば、支払いテーブルが最後に更新されたのが 2025/3/29 の場合、data_load_time は 2025-03-26 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

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

次に、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

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