Clarify statement blocks macro need ref

[mirnawong1]

@Tonayya raised that the example code for statement blocks here doesn't actually work. We should fix this up so users don't get confused:

So if you actually run this:

{%- call statement('states', fetch_result=True) -%}

select distinct state from {{ ref('users') }}

{%- endcall -%}
dbt won't know how to resolve the reference so it needs to be specified somewhere. So this can either be done using -- depends_on or doing a ref() function outside the statement block:

Option A:
-- depends_on: {{ ref('abc') }}

{% call statement('st') %}

select * from {{ ref('abc') }}

{% endcall %}

select 2 as id
Option B:
{%- call statement('st') -%}

select * from {{ ref('abc') }}

{%- endcall -%}

select id * 2 as id from {{ ref('abc') }}

Resolves #5087

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
docs-getdbt-com	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Mar 27, 2024 9:14pm

[mirnawong1]

thanks so much @joellabes ! folded in you suggs and the preview looks good i think!

[mirnawong1]

if you're ok with it, will merge it this week!