Why One model per source table rule in dbt? - Purpose & Use Cases

The Big Idea

What if your data models were as simple and clear as separate folders instead of one messy drawer?

The Scenario

Imagine you have a big spreadsheet with many sheets, each sheet holding different data. You try to write one giant report by mixing all sheets manually in one place. It gets confusing fast.

The Problem

Manually combining data from many tables into one model is slow and messy. It's easy to make mistakes, hard to update, and difficult to understand what each part does.

The Solution

The "One model per source table" rule means you create a simple, clear model for each source table. This keeps things organized, easy to test, and easy to update without breaking everything.

Before vs After

✗ Before

select * from sales join customers on sales.customer_id = customers.id join products on sales.product_id = products.id

✓ After

model_sales as (select * from sales), model_customers as (select * from customers), model_products as (select * from products)

What It Enables

This rule lets you build clean, reusable data models that are easy to maintain and understand, making your data projects more reliable and faster to develop.

Real Life Example

In a company, each department's data is stored in separate tables. By modeling each table separately, analysts can quickly update or fix one without affecting others, speeding up reporting.

Key Takeaways

Manual mixing of tables leads to confusion and errors.

One model per source table keeps data organized and clear.

This approach makes data projects easier to maintain and faster to build.

Practice

1. What is the main reason for following the one model per source table rule in dbt?

easy

A. To avoid using source tables in models

B. To combine multiple source tables into one model

C. To write fewer SQL queries

D. To keep models simple and easy to understand

Solution

1. Step 1: Understand the rule and its benefits

   The rule encourages creating one dbt model for each source table to keep things simple and clear. This approach helps with clarity, debugging, and teamwork by avoiding complex combined models.

2. Final Answer:

   To keep models simple and easy to understand -> Option D

3. Quick Check:

   One model per source table = simplicity [OK]

Hint: One model per source table means simpler, clearer models [OK]

Common Mistakes:

• Thinking it means combining tables into one model
• Believing it reduces the number of models
• Assuming it avoids using source tables

2. Which of the following is the correct way to define a dbt model for a source table named customers?

easy

A. Create a model file named all_data.sql combining all source tables

B. Create a model file named customers.sql with a SELECT from the source table

C. Create a model file named customers.sql but do not select from the source table

D. Create a model file named source_customers.sql without referencing the source

Solution

1. Step 1: Match model name to source table and reference it

   Following the rule, the model file should be named after the source table, here customers.sql. The model should select data from the source table to represent it clearly.

2. Final Answer:

   Create a model file named customers.sql with a SELECT from the source table -> Option B

3. Quick Check:

   Model name = source table name + SELECT from source [OK]

Hint: Model file name matches source table name and selects from it [OK]

Common Mistakes:

• Naming model file unrelated to source table
• Not selecting from the source table
• Combining multiple tables in one model

3. Given this dbt model SQL for source table orders:

select * from {{ source('sales_db', 'orders') }}

What will be the output if the source table has 100 rows?

medium

A. The model will return 100 rows identical to the source table

B. The model will return zero rows

C. The model will return 1 row with aggregated data

D. The model will cause a syntax error

Solution

1. Step 1: Understand the SQL query and predict output

   The query selects all columns and rows from the source table orders. Since it selects all rows without filtering, the output will have the same 100 rows as the source.

2. Final Answer:

   The model will return 100 rows identical to the source table -> Option A

3. Quick Check:

   Select * from source = same rows [OK]

Hint: Select * from source returns all rows unchanged [OK]

Common Mistakes:

• Thinking it returns zero rows
• Assuming aggregation happens automatically
• Expecting syntax errors from correct source() usage

4. You wrote this dbt model for source table products:

select * from source('inventory', 'products')

But dbt throws an error. What is the problem?

medium

A. Model file name does not match source table

B. Wrong source table name

C. Missing double curly braces around the source function

D. Using select * is not allowed

Solution

1. Step 1: Check dbt source function syntax and identify issue

   The source function must be wrapped in double curly braces: {{ source(...) }}. The model uses source(...) without {{ }}, causing a syntax error.

2. Final Answer:

   Missing double curly braces around the source function -> Option C

3. Quick Check:

   dbt functions need {{ }} [OK]

Hint: Always wrap dbt functions in {{ }} [OK]

Common Mistakes:

• Forgetting {{ }} around source()
• Assuming select * is disallowed
• Ignoring model file naming conventions

5. You have two source tables: customers and orders. According to the one model per source table rule, how should you organize your dbt models if you want to create a report showing total orders per customer?

hard

A. Create separate base models for customers and orders, then create a third model joining them for the report

B. Create one model combining both source tables directly without base models

C. Create a single model selecting from both source tables with UNION

D. Create only one model for orders and ignore customers

Solution

1. Step 1: Follow one model per source table for base models and build report model

   Create one model for customers and one for orders separately to keep base models simple. Create a third model that joins these base models to calculate total orders per customer, keeping transformations clear and modular.

2. Final Answer:

   Create separate base models for customers and orders, then create a third model joining them for the report -> Option A

3. Quick Check:

   Base models per source + separate report model [OK]

Hint: Base models per source, then join in separate model [OK]

Common Mistakes:

• Combining sources in one base model
• Skipping base models and joining sources directly
• Ignoring one source table