dbt macro 说明

macro是SQL的片段，可以像模型中的函数一样调用。macro可以在模型之间重复使用SQL，以符合DRY（不要重复自己）的工程原理。
此外，共享包可以公开您可以在自己的dbt项目中使用的macro。
要使用macro，macro-paths请在dbt_project.yml文件中添加配置条目。macro文件必须使用.sql文件扩展名。

macro 的使用

• 配置位置

  配置 dbt_project.yml

macro-paths: ['macros'] # look for macros in ./macros directory

• 定义macro

{% macro group_by(n) %}
  GROUP BY
   {% for i in range(1, n + 1) %}
     {{ i }}
     {% if not loop.last %} , {% endif %}
   {% endfor %}
{% endmacro %}

• 调用

select
  field_1,
  field_2,
  field_3,
  field_4,
  field_5,
  count(*)
from my_table
{{ group_by(5) }}

合格的macro

上面的macro 是在自己的项目中，但是如何是三方应用的需要使用完全限定名 （加上项目名称）

• 完全限定名

select
  field_1,
  field_2,
  field_3,
  field_4,
  field_5,
  count(*)
from my_table
{{ this_project.group_by(5) }}

• 三方导入macro使用

packages:
  - git: "https://github.com/fishtown-analytics/snowplow.git"
select
  {{ snowplow.get_utm_parameter('url_parameters', 'utm_medium') }}
from snowplow.event

参考资料

https://docs.getdbt.com/docs/macros