プロジェクト情報

実測検証完了

検証日時: 2026-02-17
dbtバージョン: 1.11.5
dbt-bigqueryバージョン: 1.11.0
検証環境: macOS (Darwin 24.6.0)
BigQueryプロジェクト: sdp-sb-yada-29d2
データセット: dbt_sandbox
リージョン: asia-northeast1
並列スレッド数: 24
総検証項目数: 130項目
カテゴリ数: 10カテゴリ

このプロジェクトは、dbt core + BigQueryの全設定項目(130項目)を実際に検証し、実運用で使えるベストプラクティスをまとめたものです。

実測検証サマリー

  • Models実行: 27モデル(21成功、6エラー)、9.91秒
  • Seeds実行: 3ファイル、312行、約5秒
  • Tests実行: 31テスト(30 PASS、1 FAIL)、11.53秒
  • Unit Tests実行: 9テスト(全PASS)、10.76秒
  • Docs生成: catalog.json(28KB)、manifest.json(725KB)、約10秒

📚 カテゴリ別ガイド一覧

🔴 必須カテゴリ(本番運用に必須)

#カテゴリ検証項目数所要時間状態
プロジェクト基本設定15項目2時間✅ 完了
BigQuery接続設定20項目2時間✅ 完了
Models30項目4時間✅ 完了

カテゴリ1-3の主な内容:

  • dbt_project.yml の全設定項目
  • profiles.yml の5種類の認証方法(OAuth, Service Account等)
  • マテリアライゼーション(table, view, incremental, ephemeral, materialized_view)
  • パーティショニング(DATE, TIMESTAMP, INT64, time-ingestion)
  • クラスタリング(単一列、複数列、パーティションとの組み合わせ)
  • 増分戦略(merge, insert_overwrite, microbatch)

🟡 重要カテゴリ(データ品質・運用効率の向上)

#カテゴリ検証項目数所要時間状態
Tests15項目3時間✅ 完了
ドキュメント設定5項目1時間✅ 完了
パフォーマンス最適化10項目2時間✅ 完了

カテゴリ4-6の主な内容:

  • Schema Tests(unique, not_null, accepted_values, relationships)
  • Singular Tests(カスタムSQLテスト)
  • Unit Tests(モックデータでのロジック検証)
  • テスト設定(severity, warn_if, error_if, store_failures)
  • dbt docs generate / serve
  • descriptions、doc blocks、meta、exposures
  • スロット最適化、クエリパフォーマンス、並列実行
  • キャッシュ戦略、マテリアライゼーション選択

🟢 任意カテゴリ(高度な機能・特殊用途)

#カテゴリ検証項目数所要時間状態
Snapshots12項目2時間✅ 完了
Seeds5項目1時間✅ 完了
Hooks8項目1.5時間✅ 完了
その他の設定10項目1.5時間✅ 完了

カテゴリ7-10の主な内容:

  • SCD Type 2実装(timestamp戦略、check戦略)
  • dbt seed(CSVファイルのロード)
  • column_types、quote_columns、delimiter
  • on-run-start、on-run-end、pre-hook、post-hook
  • vars、packages、dispatch、analysis、macros、quoting

最終更新: 2026-02-17