การใช้ Jinja ขั้นสูงกับ dbt

กรณีศึกษา: การสร้าง Data Model สำหรับ E-Commerce ด้วย dbt

Susan Sun

Freelance Data Scientist

คำสั่ง Jinja: loop

คำสั่ง Jinja อยู่ใน {% %}:

การวนซ้ำ ผ่านรายการ

เทมเพลต:
```
{% for ... %} ... {% endfor %}
```

ตัวอย่าง:

{% for order_status in order_statuses %}
  SUM(
      CASE WHEN status = '{{ order_status }}' 
        THEN order_id 
      END)
{% endfor %}

คำสั่ง Jinja: loop

SQL ที่มีโค้ดซ้ำ:

SELECT 
    user_id,
    SUM(CASE WHEN status = 'Shipped' THEN 1 ELSE 0 END) 
        AS num_orders_Shipped,
    SUM(CASE WHEN status = 'Complete' THEN 1 ELSE 0 END) 
        AS num_orders_Complete,
    SUM(CASE WHEN status = 'Processing' THEN 1 ELSE 0 END) 
        AS num_orders_Processing,        
FROM {{ ref('stg_looker__orders') }}
GROUP BY 1

คำสั่ง Jinja: loop

{% set order_statuses = ['Shipped', 'Complete', 'Processing'] %}

SELECT 
    user_id,
    -- Jinja loop
    {% for order_status in order_statuses %}
        SUM(CASE WHEN status = '{{ order_status }}' THEN 1 ELSE 0 END) 
        -- Parametrized column name
        AS num_orders_{{ order_status }}
    {% endfor %}
FROM {{ ref('stg_looker__orders') }}
GROUP BY 1

คำสั่ง Jinja: loop

ผลลัพธ์จาก dbt compile:

SELECT 
    user_id,
    SUM(CASE WHEN status = 'Shipped' THEN 1 ELSE 0 END) 
        AS num_orders_Shipped,
    SUM(CASE WHEN status = 'Complete' THEN 1 ELSE 0 END) 
        AS num_orders_Complete,
    SUM(CASE WHEN status = 'Processing' THEN 1 ELSE 0 END) 
        AS num_orders_Processing,        
FROM "dbt"."main"."stg_looker__orders"
GROUP BY 1

คำสั่ง Jinja: macros

Jinja macro คือ:

ฟังก์ชันที่เขียนด้วย Jinja
นำกลับมาใช้ซ้ำได้
เก็บไว้ในโฟลเดอร์ /macros

COALESCE():

คืนค่าแรกที่ไม่ใช่ null
ไวยากรณ์: COALESCE(value1, value2, ...)
เช่น COALESCE(nickname, first_name)

ตัวอย่างฟังก์ชัน macro:

ภาพหน้าจอ IDE ที่เปิดไฟล์ `coalesce_and_round.sql` แสดงโลจิก macro ของไฟล์

คำสั่ง Jinja: macros

คำสั่ง Jinja อยู่ใน {% %}:

ฟังก์ชัน macro ที่นำกลับมาใช้ซ้ำได้:

เทมเพลต:
```
{% macro ... %} ... {% endmacro %}
```

ตัวอย่าง:

{% macro coalesce_and_round(column_name, decimal_places = 2) %}
      ROUND(COALESCE({{ column_name }}, 0), {{ decimal_places }})
{% endmacro %}

คำสั่ง Jinja: macros

SQL ที่มีโค้ดซ้ำ

ROUND(COALESCE(sales_amount, 0), 2) AS sales_amount,
ROUND(COALESCE(cost_of_goods_sold, 0), 2) AS cost_of_goods_sold,

DRY (Don't Repeat Yourself)
- สร้าง macro ชื่อ coalesce_and_round.sql
- เก็บไว้ใน /macros
- เรียกใช้:
```
{{ coalesce_and_round('sales_amount', 2) }} AS sales_amount,
{{ coalesce_and_round('cost_of_goods_sold', 2) }} AS cost_of_goods_sold,
```

การจัดการ whitespace ใน Jinja

โค้ดที่เขียน:

{% set traffic_source_values = ['Adwords', 'Email', 'Facebook'] %}
{% set browser_values = ['Chrome', 'Firefox', 'Safari', 'IE', 'Other'] %}

SELECT 
    user_id,
    COUNT(DISTINCT session_id) AS num_web_sessions,
...

การจัดการ whitespace ใน Jinja

หลัง compile:




SELECT 
    user_id,
    COUNT(DISTINCT session_id) AS num_web_sessions,
...

การจัดการ whitespace ใน Jinja

{%- ... %} ตัด whitespace ก่อน
{% ... -%} ตัด whitespace หลัง
{%- ... -%} ตัดทั้งสองด้าน
ตัวอย่าง:

{%- set traffic_source_values = ['Adwords', 'Email', 'Facebook'] -%}
{%- set browser_values = ['Chrome', 'Firefox', 'Safari', 'IE', 'Other'] -%}

SELECT 
    user_id,
    COUNT(DISTINCT session_id) AS num_web_sessions,
...

มาฝึกกันเถอะ!

กรณีศึกษา: การสร้าง Data Model สำหรับ E-Commerce ด้วย dbt