dbt 컨텍스트 변수

dbt 컨텍스트 변수 (Context variables)

dbt는 Jinja 템플릿 언어를 사용하는 dbt 프로젝트에서 사용할 수 있는 변수 세트를 제공해요. 이 변수들은 dbt 컨텍스트(context)의 일부예요. 프로젝트나 매크로 안에서 현재 실행 중인 dbt의 상태(버전, 대상, 스레드, 변수 등)를 참조할 수 있어요.

출처: 문서

본문

dbt 컨텍스트에 포함된 주요 변수는 다음과 같아요:

• this — 현재 노드(모델·스냅샷·시드·테스트 등)를 Relation 객체로 나타내요.
• target — 현재 대상(target) 구성(프로파일의 credentials 포함)에 접근해요.
• var — dbt_project.yml이나 --vars로 정의한 프로젝트 변수에 접근해요.
• dbt_version — 설치된 dbt의 버전을 반환해요.
• project_name — dbt_project.yml에 정의된 프로젝트 이름을 반환해요.
• invocation_id — 현재 실행(invocation)의 고유 식별자를 반환해요.
• thread_id — 현재 실행 스레드의 식별자를 반환해요.

이 외에도 config, env_var, adapter, doc, exceptions, debug, execute, flags 그리고 캐스팅 함수(as_bool, as_native, as_number)와 파싱 함수(fromjson, fromyaml) 등 여러 함수형 컨텍스트 객체가 있어요. 개별 함수는 각 항목 문서를 참고하세요.

더 알아보기 (Learn more)

• 전체 Jinja 함수·매크로 레퍼런스는 dbt Jinja functions를 참조하세요.
• target 세부 내용은 target 문서를 확인하세요.