全130検証項目を機能別・目的別に整理したクイックリファレンスです。
🔍 検索方法
1. 機能名で探す
2. 目的から探す
3. キーワードで検索
Ctrl+F (Windows) / Cmd+F (Mac) でページ内検索
📚 カテゴリ別検証項目一覧
プロジェクト基本設定 (15項目)
参照: プロジェクト基本設定
| # | 検証項目 | 内容 |
|---|
| 1 | name | プロジェクト名の設定 |
| 2 | version | バージョン管理 |
| 3 | config-version | 設定バージョン（2必須） |
| 4 | profile | profiles.yml との連携 |
| 5 | model-paths | モデルディレクトリ指定 |
| 6 | seed-paths | Seedsディレクトリ指定 |
| 7 | test-paths | テストディレクトリ指定 |
| 8 | analysis-paths | 分析クエリディレクトリ |
| 9 | macro-paths | マクロディレクトリ |
| 10 | snapshot-paths | スナップショットディレクトリ |
| 11 | target-path | ビルド成果物の出力先 |
| 12 | clean-targets | dbt clean で削除対象 |
| 13 | log-path | ログ出力先 |
| 14 | packages-install-path | パッケージインストール先 |
| 15 | vars | グローバル変数定義 |
BigQuery接続設定 (20項目)
参照: BigQuery接続設定
認証方法 (5種類)
| # | 認証方法 | 用途 |
|---|
| 1 | OAuth | 開発環境（個人認証） |
| 2 | Service Account (JSON) | 本番環境（推奨） |
| 3 | Service Account (JSON文字列) | CI/CD環境 |
| 4 | OAuth Token | 一時的な認証 |
| 5 | Application Default Credentials | GCP環境 |
接続設定項目
| # | 設定項目 | 内容 |
|---|
| 6 | project | BigQueryプロジェクトID |
| 7 | dataset | デフォルトデータセット |
| 8 | threads | 並列実行数（推奨: 4-24） |
| 9 | timeout_seconds | クエリタイムアウト |
| 10 | location | リージョン（例: asia-northeast1） |
| 11 | maximum_bytes_billed | クエリコスト上限 |
| 12 | priority | クエリ優先度（interactive/batch） |
| 13 | retries | リトライ回数 |
| 14 | job_execution_timeout_seconds | ジョブタイムアウト |
| 15 | job_retry_deadline_seconds | リトライ期限 |
| 16 | keyfile | Service Account JSONパス |
| 17 | keyfile_json | Service Account JSON文字列 |
| 18 | token | OAuth Token |
| 19 | refresh_token | リフレッシュトークン |
| 20 | client_id / client_secret | OAuth認証情報 |
Models (30項目)
参照: Models / パーティショニング＆クラスタリング
マテリアライゼーション (5種類)
パーティショニング (4種類)
クラスタリング
増分戦略 (3種類)
| # | 戦略 | 用途 | 参照 |
|---|
| 13 | merge | UPSERT処理（デフォルト） | Models |
| 14 | insert_overwrite | パーティション上書き | Models |
| 15 | microbatch | 小バッチ段階的処理 | Models |
その他のモデル設定
Tests (15項目)
参照: Tests / Unit Tests
Schema Tests (4種類)
| # | テストタイプ | 内容 | 参照 |
|---|
| 1 | unique | 一意性チェック | Tests |
| 2 | not_null | NULL値チェック | Tests |
| 3 | accepted_values | 許可値チェック | Tests |
| 4 | relationships | 外部キー整合性 | Tests |
Singular Tests
| # | 検証項目 | 内容 | 参照 |
|---|
| 5 | カスタムSQLテスト | 独自ロジックの検証 | Tests |
Unit Tests (6種類のデータ形式)
テスト設定
| # | 設定項目 | 内容 | 参照 |
|---|
| 12 | severity | エラー/警告の切り替え | Tests |
| 13 | warn_if | 警告条件（閾値） | Tests |
| 14 | error_if | エラー条件（閾値） | Tests |
| 15 | store_failures | 失敗レコードの保存 | Tests |
Contracts (スキーマ保証) (5項目)
参照: Contract設定
| # | 検証項目 | 内容 |
|---|
| 1 | データ型チェック | カラムの型安全性 |
| 2 | NOT NULL制約 | NULL許可/禁止 |
| 3 | 破壊的変更検出 | スキーマ変更時のエラー |
| 4 | Unit Testsとの組み合わせ | 型保証+ロジック検証 |
| 5 | CI/CD統合 | コンパイル時の型チェック |
Snapshots (12項目)
参照: Snapshots
戦略
| # | 戦略 | 用途 |
|---|
| 1 | timestamp 戦略 | updated_at カラムで変更検知 |
| 2 | check 戦略 | 複数カラムで変更検知 |
設定項目
| # | 設定項目 | 内容 |
|---|
| 3 | target_schema | スナップショット保存先 |
| 4 | unique_key | レコード識別キー |
| 5 | strategy | 変更検知戦略 |
| 6 | updated_at | 更新日時カラム（timestamp戦略） |
| 7 | check_cols | 監視カラム（check戦略） |
| 8 | invalidate_hard_deletes | 削除レコードの無効化 |
| 9 | dbt_valid_from | 有効開始日時 |
| 10 | dbt_valid_to | 有効終了日時 |
| 11 | dbt_scd_id | SCD Type 2 ID |
| 12 | dbt_updated_at | 更新タイムスタンプ |
Seeds (5項目)
参照: Seeds
| # | 検証項目 | 内容 |
|---|
| 1 | CSVファイルロード | 基本的なCSV読み込み |
| 2 | column_types | カラム型の明示的指定 |
| 3 | quote_columns | カラム名のクォート |
| 4 | delimiter | 区切り文字の変更 |
| 5 | full_refresh | 強制リロード |
Hooks (8項目)
参照: Hooks
| # | Hookタイプ | タイミング |
|---|
| 1 | on-run-start | dbt run 開始時 |
| 2 | on-run-end | dbt run 終了時 |
| 3 | pre-hook | モデル実行前 |
| 4 | post-hook | モデル実行後 |
| 5 | グローバルフック | 全モデル共通 |
| 6 | プロジェクトレベルフック | dbt_project.yml 定義 |
| 7 | モデルレベルフック | モデル個別定義 |
| 8 | トランザクション制御 | BEGIN/COMMIT |
ドキュメント設定 (5項目)
参照: ドキュメント設定
| # | 検証項目 | 内容 |
|---|
| 1 | dbt docs generate | ドキュメント生成 |
| 2 | dbt docs serve | ローカルサーバー起動 |
| 3 | descriptions | モデル・カラムの説明 |
| 4 | doc blocks | 再利用可能なドキュメント |
| 5 | meta | カスタムメタデータ |
パフォーマンス最適化 (10項目)
参照: パフォーマンス最適化
| # | 最適化項目 | 内容 |
|---|
| 1 | スロット最適化 | クエリスロット数の調整 |
| 2 | 並列実行 | threads 設定 |
| 3 | クエリキャッシュ | BigQueryキャッシュ活用 |
| 4 | マテリアライゼーション選択 | table vs view の使い分け |
| 5 | パーティション活用 | スキャン範囲削減 |
| 6 | クラスタリング活用 | フィルタ効率化 |
| 7 | 増分処理 | incremental モデル |
| 8 | maximum_bytes_billed | コスト上限設定 |
| 9 | priority 設定 | interactive vs batch |
| 10 | クエリ統計分析 | INFORMATION_SCHEMA 活用 |
その他の設定 (10項目)
参照: その他の設定
| # | 設定項目 | 内容 |
|---|
| 1 | vars | 変数定義 |
| 2 | packages | 外部パッケージ管理 |
| 3 | dispatch | マクロディスパッチ |
| 4 | analysis | 分析クエリ |
| 5 | macros | カスタムマクロ |
| 6 | quoting | クォート設定 |
| 7 | query-comment | クエリコメント |
| 8 | require-dbt-version | dbtバージョン制約 |
| 9 | on-schema-change | スキーマ変更時の挙動 |
| 10 | cache | キャッシュ設定 |
BigQuery高度な機能 (10項目)
参照: BigQuery設定リファレンス / Python UDF
🎯 目的別逆引き
コスト削減
データ品質
パフォーマンス
履歴管理
CI/CD
📊 検証済み環境
検証日: 2026-02-17
dbt: 1.11.5
dbt-bigquery: 1.11.0
BigQuery: asia-northeast1
すべての検証項目は実際に動作確認済みです。
🔗 関連ドキュメント
最終更新: 2026-02-17