snapshots と exposures：履歴化と下流利用者管理

Stage 5 — 第2章 | dbt入門カリキュラム 推定学習時間：40〜50分 | 難易度：★★★★☆

この章で学ぶこと

mart は 現時点の SSOT ですが、運用には 「いつ変わったか」 と 「誰がどの表を使うか」 も必要です。

まず dbt snapshot と exposure の作法を整理し、続けて DS Playground の snapshot_user_learning_preferences と models/exposures.yml を読み解きます。

この章を終えると、こんなことができるようになります：

• timestamp strategy snapshot の config を読める
• snapshot が mart に未接続でも価値がある理由を説明できる
• exposure が メタデータとリネージ をどう伸ばすか説明できる
• 2 つの Metabase exposure の depends_on 差を説明できる

snapshot とは何か

ソースが current-state（最新状態だけを保持）のとき、mart は build 時点のスナップショットしか見えません。 ユーザー属性が変わっても、過去の mart 行は 遡及更新されません。

将来「月次で構成がどう変わったか」を見るには 履歴テーブル が必要です。

dbt snapshot は SCD（Slowly Changing Dimension） を warehouse 上に作る機能です。 strategy='timestamp' では、変更検知列（例: updated_at）の変化で新しい履歴行を追加します。

データマネジメント入門 の「保存期間と改訂履歴」が snapshot に相当します。

exposure とは何か

dbt の exposure は、プロジェクト外の 利用面（ダッシュボード、Notebook、逆 ETL）を lineage グラフに載せる機能です。

dbt docs generate の lineage 上で mart → exposure の矢印が見えます。

Harness Engineering と DM の「外部利用面のハーネス」に近い考え方です。

snapshot 運用上の注意

1. snapshot も build 対象 — 日次 workflow で増える
2. PII — ユーザー ID を含む場合は内部 schema のみ
3. mart との二重 SSOT — 現在値は mart、履歴は snapshot と 役割分担 を YAML に書く
4. full-refresh — snapshot 再構築は慎重に（履歴消失リスク）

snapshot と current-state mart は 役割が異なります。 snapshot は履歴 as-of 用、mart は build 時点の集計用——混同しないことが重要です。

snapshot_user_learning_preferences

fct_learning_goal_share は 現在の primary_goal だけを見ます。 ユーザーが goal を変更しても、過去の構成比 mart は遡及更新されません。

教学例として、学習目的の履歴化 snapshot を置いています。

{% snapshot snapshot_user_learning_preferences %}

          {{
            config(
              target_schema=target.schema,
              strategy='timestamp',
              unique_key='user_id',
              updated_at='updated_at',
              invalidate_hard_deletes=True
            )
          }}

          select
            user_id,
            primary_goal,
            preference_source,
            created_at,
            updated_at
          from {{ ref('stg_supabase__user_learning_preferences') }}

          {% endsnapshot %}
          

config の読み方

snapshot を将来 mart に接続するか、教学例のままにするかはプロジェクト方針で決めます。 mart に未接続でも、履歴テーブルとしての価値（将来の as-of 分析の土台）はあります。

exposures.yml

Metabase ダッシュボード想定ごとに どの mart を読むか を宣言しています。

exposures:
            - name: metabase_product_health_dashboard
              type: dashboard
              depends_on:
                - ref('fct_membership_daily')
                - ref('fct_active_users_daily')
                # ...
              owner:
                name: "BlueBayes / DS Playground"
                email: "analytics@bluebayes.jp"
          

2 つの dashboard exposure

metabase_product_health_dashboard — 有料化前プロダクトヘルス

metabase_pre_monetization_research_dashboard — 学習目的・調査・教材品質

exposure の maturity は medium です。 ダッシュボード URL は作成後に YAML へ追記する運用です。

体系コラム：カリキュラム上の位置づけ

まとめ

dbt は warehouse 内の transform だけでなく、履歴（snapshot）と利用面（exposure） までモデルグラフに載せられます。

DS Playground では、current-state mart と snapshot の役割分担、ヘルス vs リサーチの exposure 分割——という運用設計がコード上で可視化されています。

関連教材

• 前章: safe_ratio マクロ
• 次章: CI / docs / Capstone
• 関連（DM）: メタデータとリネージ

確認問題

問題 1

strategy='timestamp' の snapshot で、新しい snapshot 行が作られる典型トリガーはどれですか。

A. 毎日 0 時に無条件
B. ソースの updated_at（等の変更検知列）が変わったとき
C. BI ツールが更新されたとき
D. seed が変わったとき

正解: B

問題 2

exposure を _exposures.yml に定義する 主な目的 として最も近いのはどれですか。

A. SQL を短くする
B. mart 変更の影響がダッシュボード等に及ぶことを lineage で可視化する
C. OLTP の RLS を設定する
D. incremental lookback を決める

正解: B

問題 3

snapshot と current-state mart の関係について 正しい 説明はどれですか。

A. snapshot は mart の代替で、current-state mart は不要
B. snapshot は履歴 as-of 用、current-state mart は build 時点のスナップショット用
C. どちらも BI から直接 source() を読む
D. snapshot は seed の別名

正解: B

用語メモ（この章）