macro-paths

macro-paths

매크로가 위치한 디렉터리 목록을 지정하는 설정이에요. 기본값은 macros 디렉터리예요. 모델과 매크로는 같은 디렉터리에 둘 수 없어요.

출처: 문서

본문

dbt_project.yml:

macro-paths: [directorypath]

정의 (Definition)

매크로가 위치한 디렉터리 목록을 선택 사항으로 지정해요. 모델과 매크로는 같은 위치에 둘 수 없다는 점을 참고하세요.

기본값 (Default)

기본적으로 dbt는 macros라는 디렉터리에서 매크로를 검색해요. 예를 들어 macro-paths: ["macros"]처럼요.

macro-paths에 지정하는 경로는 반드시 dbt_project.yml 파일의 위치를 기준으로 한 상대 경로여야 해요. /Users/username/project/macros 같은 절대 경로는 피하세요. 예상치 못한 동작과 결과를 초래할 수 있어요.

• ✅ Do · 상대 경로 사용: macro-paths: ["macros"]
• ❌ Don't · 절대 경로 피하기: macro-paths: ["/Users/username/project/macros"]

예시 (Examples)

macros 대신 custom_macros라는 하위 디렉터리 사용

dbt_project.yml:

macro-paths: ["custom_macros"]

더 알아보기 (Learn more)

• 프로젝트 설정(dbt_project.yml)의 전체 목록은 Project configurations 문서를 참고하세요.
• 매크로는 변수, 커스텀 함수, 후크(hook) 등 프로젝트 전반에서 재사용하는 Jinja 로직 조각이에요.