분석(analysis) 속성

분석(analysis)은 dbt 프로젝트에서 쿼리로만 활용되고 테이블·뷰로 구체화되지 않는 리소스예요. 이런 분석의 속성은 analyses/ 디렉터리의 .yml 파일에서 선언할 수 있어요.

출처: 문서

본문

(dbt v1.12 이상 적용)

분석 속성은 analysis-paths 설정에 나와 있는 것처럼 analyses/ 디렉터리에서 정의하는 걸 권장해요. 파일 이름은 whatever_you_want.yml처럼 원하는 대로 짓고, analyses/ 또는 models/ 디렉터리 안의 하위 폴더에 원하는 깊이로 중첩해 둘 수 있어요.

analyses/.yml


analyses:
  - name: <analysis_name> # required
    description: <markdown_string>
    config:
      enabled: true | false
      docs: # changed to config in v1.10
        show: true | false
        node_color: <color_id> # Use name (such as node_color: purple) or hex code with quotes (such as node_color: "#cd7f32")
      tags: <string> | [<string>]
    columns:
      - name: <column_name>
        description: <markdown_string>
      - name: ... # declare properties of additional columns

  - name: ... # declare properties of additional analyses

(dbt v1.12 이상 적용)

분석을 프로젝트 레벨에서 설정하려면 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