변경(Deprecation) 및 경고 개요

변경(Deprecation) 및 경고 개요

dbt를 사용하다 보면 주의가 필요한 경고나 변경 사항을 볼 수 있어요. 이런 변화는 dbt가 최신 버전으로 발전하고 모든 사용자의 경험을 개선하기 위한 것이에요. 이 페이지에서 변경 유형별 의미와 대처 방법, 그리고 자세한 정보를 찾을 위치를 정리했어요.

출처: 문서

본문

폐기 예정(Deprecation)

프로젝트 코드(모델, YAML, 매크로)에 있는 기능 중 아직은 동작하지만 곧 제거될 기능이에요.

영향: 현재는 경고로 표시되지만, 향후 버전에서는 오류로 처리돼요.

대처: 프로젝트 코드를 새 문법을 사용하도록 업데이트하세요.

동작 변경 플래그(Behavior change flags)

마이그레이션 기간 동안 새 동작에 옵트인(opt in)/옵트아웃(opt out)할 수 있게 해주는 dbt_project.yml 파일의 설정이에요.

영향: dbt가 이전 동작을 쓸지 새 동작을 쓸지 제어하며, 기본값은 시간이 지나며 바뀌어요.

대처: 채택 시점을 제어할 수 있도록 플래그를 설정하세요.

폐기 예정 CLI 플래그(Deprecated CLI flags)

dbt v2에서 제거될 예정인 dbt 명령에 전달되는 커맨드라인 플래그예요.

영향: 일부는 무시되고(경고와 함께), --models 플래그는 dbt v2에서 오류로 처리돼요.

대처: 작업 정의와 스크립트에서 이 플래그들을 제거하거나 다른 것으로 대체하세요.

dbt v2 준비하기

dbt v2로 업그레이드한다면 다음을 해야 해요:

  • 모든 폐기 예정 항목을 해결해서 dbt v2에서 오류가 발생하지 않게 하세요.
  • 동작 변경 플래그를 검토해서 dbt v2가 어떻게 동작할지 이해하세요(새 동작은 항상 활성화돼요).
  • 폐기 예정 CLI 플래그를 업데이트해서 dbt v2에서 오류가 없게 하세요.

더 알아보기 (Learn more)