asset-paths

asset-paths

dbt docs generate의 일부로 target 디렉터리에 복사할 디렉터리 목록을 지정하는 설정이에요. 주로 프로젝트 문서에 이미지를 렌더링할 때 유용해요.

출처: 문서

본문

dbt_project.yml:

asset-paths: [directorypath]

정의 (Definition)

docs generate 명령의 일부로 target 디렉터리에 복사할 디렉터리 목록을 선택 사항으로 지정해요. 저장소에 있는 이미지를 프로젝트 문서에서 렌더링할 때 유용해요.

기본값 (Default)

기본적으로 dbt는 docs generate의 일부로 추가 파일을 복사하지 않아요. 예를 들어 asset-paths: []처럼요.

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

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

예시 (Examples)

docs generate의 일부로 assets 하위 디렉터리의 파일을 컴파일

dbt_project.yml:

asset-paths: ["assets"]

이 디렉터리에 포함된 파일은 dbt docs generate의 일부로 target/ 디렉터리에 복사되어, 프로젝트 문서에서 이미지로 접근할 수 있게 돼요.

더 알아보기 (Learn more)

• 프로젝트 설정(dbt_project.yml)의 전체 목록은 Project configurations 문서를 참고하세요.
• 설명(descriptions)에 이미지를 포함하는 방법의 전체 가이드는 공식 dbt 문서의 관련 항목을 참고하세요.