■ はじめに

dbt で macro を修正する必要があり、
jinja2の基本的な文法事項が分かっていなかったので
まとめておく。

【１】基本

* 以下、公式ドキュメント。

https://jinja.palletsprojects.com/en/3.1.x/

Express	Explanations	Memo
{# … #}	Comments	「【２】コメント文」参照
{% … %}	Statements	「【３】変数」参照
{{ … }}	Expressions	「【４】if文」「【５】for文」参照

【２】コメント文

{# コメント文 #}

{#
コメント文１
コメント文２
#}

https://tekunabe.hatenablog.jp/entry/2021/12/03/jinja2_comment

１）使用上の注意

* コメント文だけの話ではないが出力すると
　空白行ができるので「Whitespace Control」を使うといい
 => 詳細は、以下の関連記事を参照の事

Jinja2 ～ Whitespace Control ～
https://dk521123.hatenablog.com/entry/2024/10/29/151203

【３】変数

* 詳細は、以下の関連記事を参照の事

Jinja2 ～変数～
https://dk521123.hatenablog.com/entry/2025/04/05/131421

１）変数定義

{% set 変数名 = 変数の値 %}

{% set 変数名 %}
変数の値
{% endset %}

２）変数参照

{{ 変数名 }}

【４】if文

* 詳細は以下の関連記事を参照のこと

Jinja2 ～条件分岐～
https://dk521123.hatenablog.com/entry/2025/04/06/001255

{% if 条件式1 %}
  {# 条件式1が true なら実行される #}
{% elif 条件式2 %}
  {# 条件式2が true なら実行される #}
{% else %}
  {# 条件式1も2 false なら実行される #}
{% endif %}

サンプル

{% if name_val %}
  <h1>Hello, {{ name_val }}</h1>
{% else %}
  <p>Hello World!</p>
{% endif %}

１）論理演算子

* and / or は普通に使える

サンプル

{%- if flg1 and flg2 %}
flg1とflg2の値が存在する場合に出力する
{%- elif flg1 or flg2 %}
flg1またはflg2の値が存在する場合に出力する
{%- endif %}

【５】for文

* 詳細は、以下の関連記事を参照の事

Jinja2 ～繰り返し～
https://dk521123.hatenablog.com/entry/2025/04/07/000220

サンプル

{% for name in name_vals: %}
  <p>Hello, {{ name + " from USA" }}!!!</p>
{% endfor %}

１）break / continue文

* if文と組み合わせて使える

break文

{% for item in items %}
  {% if item == 'TheEnd' %}
    {% break %} {# ! 注目 ! #}
  {% endif %}
  <li>{{ item }}</li>
{% endfor %}

continue文

{% for item in items %}
  {% if item == 'TheSkip' %}
    {% continue %} {# ! 注目 ! #}
  {% endif %}
  <li>{{ item }}</li>
{% endfor %}

２）loop

* ループを制御するために用意されている loop が便利。

https://techblog.recochoku.jp/3422

主なメソッド

* 以下の公式ドキュメントに全てのメソッドが載っている

https://jinja.palletsprojects.com/en/3.0.x/templates/#for

Express	Explanations
loop.index	ループのインデックスを返す
loop.first	最初のループの場合 True, それ以外は False
loop.last	最後のループの場合 True, それ以外は False
loop.length	ループの回数を返す

サンプル

{# ループの最後は「,」は要らないので、それを制御する #}
CREATE TABLE demo_table
{% for column in columns %}
{{ column  }} TEXT{% "," if not loop.last else "" %} {# ! 注目 ! #}
{% endfor %}