<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__6faaaae30626b" src="https://embed.zenn.studio/card#zenn-embedded__6faaaae30626b" data-content="https%3A%2F%2Fdiscourse.getdbt.com%2Ft%2Fhow-we-structure-our-dbt-projects%2F355" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://discourse.getdbt.com/t/how-we-structure-our-dbt-projects/355" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://discourse.getdbt.com/t/how-we-structure-our-dbt-projects/355</a></p>
<h1 id="%E6%A6%82%E8%A6%81">
<a class="header-anchor-link" href="#%E6%A6%82%E8%A6%81" aria-hidden="true"></a> 概要</h1>
<ul>
<li>
<a href="https://github.com/dbt-labs/corp/blob/master/dbt_style_guide.md" target="_blank" rel="nofollow noopener noreferrer">dbt style guide</a>を読んでいたら、このポストを参照していて、とても内容が濃かったので別でまとめました</li>
<li>同僚に読んでもらうために、僕なりに翻訳、噛み砕いたものなのとなっています</li>
<li>原文と若干ニュアンスが違うかもしれません、Single Source of Truthの精神でぜひ原文も読んでみてください</li>
</ul>
<h1 id="tenajima%E3%81%AE%E6%84%9F%E6%83%B3">
<a class="header-anchor-link" href="#tenajima%E3%81%AE%E6%84%9F%E6%83%B3" aria-hidden="true"></a> tenajimaの感想</h1>
<ul>
<li>dbtのプロジェクトをどのように構築していくべきか学ぶ中で、データをどのように捉えるべきか(dimensionとfactなど)も同時に学べてすごく良かった</li>
<li>僕も型として「このパターンはこのようにプロジェクトを作っていく」というのを何個か持てるようになりたい</li>
</ul>
<h1 id="how-we-structure-our-dbt-projects">
<a class="header-anchor-link" href="#how-we-structure-our-dbt-projects" aria-hidden="true"></a> How we structure our dbt projects</h1>
<p>前提としてここで示す方法は、dbtとしてはベストだと思うが、自分自身のプロジェクトにとって最適かどうかは自分で判断してね(より深くディスカッションして使ってね)って言ってる</p>
<h2 id="data-transformation-101">
<a class="header-anchor-link" href="#data-transformation-101" aria-hidden="true"></a> Data transformation 101</h2>
<ul>
<li>プロジェクトのデータは3つのチェックポイントで分けている</li>
<li>
<ol>
<li>ソース</li>
</ol>
<ul>
<li>データソースに準拠した構造(例えばテーブルやカラム)をサードバーティーツールで読み込んだもの</li>
</ul>
</li>
<li>
<ol start="2">
<li>ステージングモデル</li>
</ol>
<ul>
<li>データモデリングの最小単位</li>
<li>各モデルはソースデータテーブルと一対一の関係を持つ</li>
<li>ソースデータテーブルと粒度は同じだが、カラムはリネーム、リキャストなど有用なものに整えられている状態にする</li>
</ul>
</li>
<li>
<ol start="3">
<li>マートモデル</li>
</ol>
<ul>
<li>ビジネスプロセスやエンティティを表現するモデルで、ベースとなるデータソースから抽象化されている</li>
</ul>
</li>
<li>ここで注目すべきなのはソースとステージングモデルはデータソースが基点なのに対して、マートモデルはビジネスが基点であること</li>
<li>dbtおすすめのプロジェクトではまずmodelsディレクトリをを以下のように構成することから始めるべき</li>
</ul>
<div class="code-block-container"><pre><code>├── dbt_project.yml
└── models
    ├── marts
    └── staging
</code></pre></div><h2 id="staging-raw-data">
<a class="header-anchor-link" href="#staging-raw-data" aria-hidden="true"></a> Staging raw data</h2>
<ul>
<li>ステージング層の目的は生データを受け取り、データクレンジングを行うことだ</li>
<li>
<code>stg_</code>というプレフィックスを持つことは次のことを示す
<ul>
<li>データ基盤のルールに従ってフィールドをリネーム、リキャストしている</li>
<li>タイムゾーンなどのデータ型が揃っている</li>
<li>空文字をnullに置き換えるなどの簡単なクレンジングが行われている</li>
<li>有用であればリストの展開(flattening)が行われている</li>
<li>ユニークかつ非null値であるプライマリキーがある</li>
</ul>
</li>
<li>ステージングモデルにはコンテキストの追加のために、追加カラムを結合が可能で、ユニオンによる行の追加やフィルタによる削除、ナチュラルキーの重複排除やサロゲートキーのハッシュ結合もできる</li>
<li>複数のデータソースを扱うことが多いので、ステージングディレクトリでは、ソースごとに1つのディレクトリを作成する</li>
</ul>
<div class="code-block-container"><pre><code>├── dbt_project.yml
└── models
    ├── marts
    └── staging
        ├── braintree
        └── stripe
</code></pre></div><ul>
<li>それぞれのstagingディレクトリは最低限次のものを含む
<ul>
<li>分析に有用な各オブジェクトに1つのステージングモデル
<ul>
<li>
<code>stg_&lt;source&gt;__&lt;object&gt;</code>というファイル名にする</li>
</ul>
</li>
<li>1つの<code>src_&lt;source&gt;.yml</code>ファイル
<ul>
<li>sourceの定義、テスト、ドキュメントを記述する</li>
</ul>
</li>
<li>1つの<code>stg_&lt;source&gt;.yml</code>ファイル
<ul>
<li>同じディレクトリのモデルのテストとドキュメントを書く</li>
</ul>
</li>
</ul>
</li>
</ul>
<div class="code-block-container"><pre><code>├── dbt_project.yml
└── models
    ├── marts
    └── staging
        └── braintree
            ├── src_braintree.yml
            ├── stg_braintree.yml
            ├── stg_braintree__customers.sql
            └── stg_braintree__payments.sql
</code></pre></div><ul>
<li>ymlファイルを1つにまとめたいという声も合理的だが、ymlが肥大化してきたらこの方法をお勧めする</li>
<li>ephemeral materializationをよく使うようになってきたらbaseディレクトリを使って作る</li>
</ul>
<h2 id="describing-a-business-through-marts">
<a class="header-anchor-link" href="#describing-a-business-through-marts" aria-hidden="true"></a> Describing a business through marts</h2>
<ul>
<li>martsはビジネスエンティティやビジネスロジックを含んだモデルを置くところ</li>
<li>ビジネスの単位でディレクトリを切るのが良い
<ul>
<li>マーケ、経理、プロダクト</li>
</ul>
</li>
</ul>
<div class="code-block-container"><pre><code>├── dbt_project.yml
└── models
    ├── marts
    |   ├── core
    |   ├── finance
    |   ├── marketing
    |   └── product
    └── staging        
</code></pre></div><ul>
<li>ここではファクトモデルとディメンジョンモデルを構築し、そのモデルが依存するソースデータから抽象化することが目標である
<ul>
<li>
<code>fct_&lt;verb&gt;</code>
<ul>
<li>行数が多くて列数が少ないデータ</li>
<li>実世界で発生した、あるいは発生しているプロセス</li>
<li>セッション、トランザクション、オーダー、などイミュータブルなイベントストリーム</li>
</ul>
</li>
<li>
<code>dim_&lt;noun&gt;</code>
<ul>
<li>行数が少なくて列数が多いデータ</li>
<li>各レコードは人、場所、ものなどを表す</li>
<li>(人の属性情報など)劇的に変化するなどはないが、ミュータブルである</li>
</ul>
</li>
</ul>
</li>
<li>ステージングモデルの作業がクリーニングなどの前処理に限られているのに対し、ファクトテーブルはディメンジョンの選択(および削除)、日付の特定、ビジネスロジックの実行といっデータ変換を行う部分である</li>
<li>このレイヤーのモデリングはステージングモデルの作成よりもかなり複雑で、組織の分析ニーズに適合した形になる</li>
<li>ここでは便利なパターンをいくつか紹介する
<ul>
<li>パフォーマンスを上げるために<code>fct_</code>と<code>dim_</code>モデルをテーブルとして作る。基本的にはテーブルとして作るが、パフォーマンス懸念があるときのみインクリメンタルで作る</li>
<li>ファクトモデル、またはディメンジョンモデルを作る前に必要な途中での変換は<code>marts/&lt;mart&gt;/intermadiate</code>ディレクトリに配置する。<code>&lt;useful_name&gt;__&lt;transformation_in_past_tense&gt;.sql</code>という名前で格納する。二重アンダースコアが使われていることからこれらは中間モデルであることを示すようにする。</li>
<li>モデルは同一ディレクトリの<code>&lt;dir_name&gt;.yml</code>ファイルにてテストを行うようにする</li>
</ul>
<div class="code-block-container"><pre><code>├── dbt_project.yml
└── models
    ├── marts
    │   ├── core
    │   │   ├── core.md
    │   │   ├── core.yml
    │   │   ├── dim_customers.sql
    │   │   ├── fct_orders.sql
    │   │   └── intermediate
    │   │       ├── customer_orders__grouped.sql
    │   │       ├── customer_payments__grouped.sql
    │   │       ├── intermediate.yml
    │   │       └── order_payments__joined.sql
    │   ├── finance
    │   ├── marketing
    │   └── product
    └── staging
</code></pre></div>
<ul>
<li>DAGで表すとこのように表される<br>
<img src="https://res.cloudinary.com/zenn/image/fetch/s--1WA8vJad--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://aws1.discourse-cdn.com/business7/uploads/getdbt/original/1X/a5567e3711a30c72bbf9c117548452fac476d8c6.jpeg" alt loading="lazy" class="md-img">
</li>
</ul>
</li>
</ul>
<h2 id="accessories-to-data">
<a class="header-anchor-link" href="#accessories-to-data" aria-hidden="true"></a> Accessories to data</h2>
<p>ロバストなdbtプロジェクトで見かけるSQLファイルには、ステージングやマートに加えて次のようなモデルディレクトリがしばしば見られる</p>
<ul>
<li>
<code>utils</code>
<ul>
<li>
<code>all_days</code>テーブル、あらゆるところで役に立つ</li>
</ul>
</li>
<li>
<code>lookups</code>
<ul>
<li>zipcodeと国を紐づけるなどのマッピングテーブル</li>
<li>これらはcsvと<code>dbt seed</code>を使って用意するのが良い</li>
<li>これはいろんなところで参照するだけでなく、BIツールで使うこともある</li>
</ul>
</li>
<li>
<code>admin</code>
<ul>
<li>監査ログ、DWHの運用、メンテナンス情報、プロジェクトを進めるために実行した雑多なDDLのインクリメント記録など</li>
</ul>
</li>
<li>
<code>metrics</code>
<ul>
<li>ファクトテーブルから取得した測定値から正確に定義されたもの</li>
</ul>
</li>
</ul>
<h2 id="final-thoughts">
<a class="header-anchor-link" href="#final-thoughts" aria-hidden="true"></a> Final thoughts</h2>
<ul>
<li>この記事ではdbtによってDAGを構築することを説明した</li>
<li>それはソースモデルからマートモデルまで左から右に処理をすることを説明した</li>
<li>しかし、現実ではしばしば右から左へモデルを考えることが多い</li>
<li>ダッシュボードのアイデアや、作りたいレポートから考え始めて、ダッシュボードをワークさせるために必要なマートモデルの構造をホワイトボードに書き出す</li>
<li>実際にSQLを書き始める前に、同じホワイトボードにデータソースまで遡るように処理を書き出す</li>
<li>何度かモデリングを繰り返すうちに、DAGを左から右へどう構築していけば良いのか直感的にわかるようになってくる</li>
<li>目的地を考えてからモデリングの旅に出るようになってくるのだ</li>
</ul>


"How we structure our dbt projects"を読む

Discussion