분석(analyses)의 프로젝트 레벨 구성

분석(analyses)의 프로젝트 레벨 구성

require_corrected_analysis_fqns 플래그는 dbt_project.yml의 analyses 블록의 구성을 실제로 라우팅하고, 분석(analysis) FQN의 불필요한 analyses 경로 세그먼트를 제거해요.

출처: 문서

본문

require_corrected_analysis_fqns dbt v1 Latest dbt v1
Introduced 2026.3 1.12.0
Matured (default → true) — —
Removed — —

이전에는 dbt_project.yml의 분석(analyses)에 대한 프로젝트 레벨 구성이 조용히 무시됐어요. 분석의 정규화된 이름(FQN)에도 다른 리소스 타입과 일치하지 않는 불필요한 analyses 경로 세그먼트가 포함돼 있었어요.

require_corrected_analysis_fqns를 true로 설정하면 dbt는:

  • dbt_project.yml의 analyses 블록에서 분석 구성을 라우팅해 프로젝트 레벨 구성이 적용되게 해요.
  • 불필요한 FQN 세그먼트를 제거해 분석 FQN이 다른 리소스 타입과 일치하게 해요 (예: your_project.analyses.my_analysis 대신 your_project.my_analysis).

프로젝트 레벨에서 분석을 구성하려면 require_corrected_analysis_fqns 플래그를 true로 설정하고 dbt_project.yml에 analyses 블록을 추가해요. 프로젝트 레벨 구성은 analyses/ 폴더의 기존 분석에 적용돼요 — 예를 들어 +enabled: false를 설정하면 전부 비활성화돼요.

dbt_project.yml

flags:
  require_corrected_analysis_fqns: true

analyses:
  +enabled: true | false

자세한 내용은 Analyses와 Analysis properties를 참고하세요.

더 알아보기 (Learn more)