データの鮮度

Sigma では、お客様の Stripe 取引データの大半が 1 日以内にクエリで利用できるようになります。特定の日 (午前 12:00 から午後 11:59 UTC) のすべての API アクティビティーは、翌日の正午 (UTC) までにクエリで利用可能になります。たとえば、日曜日の終わり (UTC) 時点のデータは、月曜日の正午 (UTC) までに利用可能になります。同様に、月末時点のデータは、翌月 1 日に利用できるようになります。

Sigma でデータ読み込み時間をクエリする

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

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