정적 분석

정적 분석 (Static analysis)

--static-analysis 플래그는 단일 실행에 대한 모델 레벨 static_analysis 동작을 덮어써요. 이 플래그는 dbt v2에만 적용되며 dbt v1에서는 무시돼요.

출처: 문서

본문

--static-analysis 플래그를 사용해 단일 실행에 대한 모델 레벨 static_analysis 동작을 덮어써요. 이 플래그는 dbt v2에만 적용되며 dbt v1에서는 무시돼요.

값:

  • baseline (기본값): 실행에서 모든 모델의 SQL을 정적으로 분석해요. dbt v1에서 전환하는 사용자에게 권장되는 시작점이에요.
  • strict (이전의 on): 실행이 시작되기 전에 모든 SQL을 정적으로 분석해요. 최대 검증 보장을 제공해요 — 전체 프로젝트가 유효함이 입증될 때까지 아무것도 실행되지 않아요.
  • off: 실행에서 모든 모델의 정적 분석을 비활성화해요.

Deprecated 값 — on과 unsafe 값은 deprecated 되었으며 2026년 5월에 제거될 예정이에요. 대신 strict를 사용하세요.

설정하지 않으면 dbt v2는 baseline 모드를 기본값으로 사용하며, 대부분의 SQL 오류를 잡으면서도 dbt v1에서 부드럽게 전환할 수 있게 해줘요. 더 엄격한 분석을 점진적으로 선택하는 방법은 static_analysis 구성 문서를 참고하세요.

Usage

dbt run --static-analysis strict
dbt run --static-analysis baseline
dbt run --static-analysis off

더 알아보기 (Learn more)