test-paths

test-paths

singular 테스트와 사용자 정의 generic 테스트가 위치한 디렉터리 목록을 지정하는 설정이에요. 기본값은 tests 디렉터리예요.

출처: 문서

본문

dbt_project.yml:

test-paths: [directorypath]

정의 (Definition)

singular 테스트와 사용자 정의 generic 테스트가 위치한 디렉터리 목록을 선택 사항으로 지정해요.

기본값 (Default)

이 설정을 지정하지 않으면 dbt는 tests 디렉터리에서 테스트를 검색해요. 즉 test-paths: ["tests"]예요. 구체적으로 다음을 담은 .sql 파일을 찾아요:

  • tests/generic 하위 디렉터리의 generic 테스트 정의
  • Singular 테스트 (그 외 모든 파일)

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

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

예시 (Examples)

데이터 테스트용으로 tests 대신 custom_tests라는 하위 디렉터리 사용

dbt_project.yml:

test-paths: ["custom_tests"]

더 알아보기 (Learn more)

  • 프로젝트 설정(dbt_project.yml)의 전체 목록은 Project configurations 문서를 참고하세요.
  • singular 테스트는 특정 조건을 확인하는 한 개의 SQL 쿼리이고, generic 테스트는 여러 모델에 재사용할 수 있도록 정의한 테스트예요.