Jinja 파일 확장자

Jinja 파일 확장자 (Jinja file extensions)

allow_jinja_file_extensions 플래그는 .sql과 .md 파일에 붙은 Jinja 스타일 확장자 접미사를 dbt가 인식하게 만들어 줘요. 기본값은 false예요.

출처: 문서

본문

allow_jinja_file_extensions dbt v1 Latest dbt v1
Introduced 2026.5 1.12.0
Matured (default → true) — —
Removed — —

allow_jinja_file_extensions 플래그는 기본값이 false예요.

true로 설정하면 dbt가 .sql과 .md 파일에 붙은 Jinja 스타일 확장자 접미사(예: .j2, .jinja, .jinja2)를 인식해요. 이렇게 하면 IDE에서 이러한 접미사를 Jinja 템플릿과 연결해 Jinja 인식 문법 하이라이팅을 사용할 수 있어요.

dbt는 노드 이름을 결정할 때 Jinja 접미사를 제거해요; Jinja 접미사 존재 여부와 관계없이 리소스 이름은 그대로 유지돼요. 예를 들어 my_docs.md.j2라는 docs 블록 파일은 my_docs.md와 동일하게 파싱되고, my_model.sql.j2라는 모델 파일은 모델 my_model로 파싱돼요.

이 플래그가 false이거나 설정되지 않으면 dbt는 경고를 로그하지 않고 이 접미사가 있는 파일을 무시해요. 그 파일에 이미 스키마 속성을 추가했다면 "Did not find matching node for patch warning on schema.yml" 경고가 보일 거예요.

더 알아보기 (Learn more)