Складне використання Jinja з dbt

Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Susan Sun

Freelance Data Scientist

Оператор Jinja: цикл

Оператори Jinja беруться в {% %}:

  • Цикл за елементами
    • Шаблон:
      {% for ... %} ... {% endfor %}
      
    • Приклад:
      {% for order_status in order_statuses %}
        SUM(
            CASE WHEN status = '{{ order_status }}' 
              THEN order_id 
            END)
      {% endfor %}
      
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Оператор Jinja: цикл

Повторюваний 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
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Оператор Jinja: цикл

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

SELECT 
    user_id,
    -- Цикл Jinja
    {% for order_status in order_statuses %}
        SUM(CASE WHEN status = '{{ order_status }}' THEN 1 ELSE 0 END) 
        -- Параметризована назва стовпця
        AS num_orders_{{ order_status }}
    {% endfor %}
FROM {{ ref('stg_looker__orders') }}
GROUP BY 1
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Оператор Jinja: цикл

Результат 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
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Оператор Jinja: макроси

Макрос Jinja:

  • Це функція, написана в Jinja
  • Можна перевикористовувати
  • Зберігається в папці /macros

COALESCE():

  • повертає перше не-NULL значення
  • синтаксис: COALESCE(value1, value2, ...)
  • напр., COALESCE(nickname, first_name)

Приклад макрофункції:

Знімок екрана IDE з відкритим файлом `coalesce_and_round.sql` в редакторі, де показано логіку макросу.

Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Оператор Jinja: макроси

Оператори Jinja беруться в {% %}:

  • Повторно використовувана функція-макрос:
    • Шаблон:
      {% macro ... %} ... {% endmacro %}
      
    • Приклад:
      {% macro coalesce_and_round(column_name, decimal_places = 2) %}
            ROUND(COALESCE({{ column_name }}, 0), {{ decimal_places }})
      {% endmacro %}
      
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Оператор Jinja: макроси

  • Повторюваний 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)
    • Створіть макрос 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,
      
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Керування пробілами в 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,
...
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Керування пробілами в Jinja

Скомпільовано:




SELECT 
    user_id,
    COUNT(DISTINCT session_id) AS num_web_sessions,
... 
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Керування пробілами в 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,
...
Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Давайте потренуємось!

Кейс-стаді: створення моделей даних для e-commerce за допомогою dbt

Preparing Video For Download...