dbt clean 명령어
dbt clean 명령어
dbt clean은 dbt_project.yml 파일의 clean-targets 목록에 지정된 경로를 삭제하는 유틸리티 함수예요. 다른 dbt 명령어 실행 중 생성된 불필요한 파일·디렉터리를 제거해 프로젝트를 깨끗한 상태로 유지해 줘요.
출처: 문서
본문
dbt clean은 dbt_project.yml 파일의 clean-targets 목록에 지정된 경로를 삭제하는 유틸리티 함수예요. 다른 dbt 명령어 실행 중 생성된 불필요한 파일·디렉터리를 제거해 프로젝트의 깨끗한 상태를 보장해 줘요.
사용 예시
dbt clean
지원 플래그
이 섹션에서 다음 플래그를 간단히 설명할게요:
--clean-project-files-only(기본값)--no-clean-project-files-only
터미널에서 dbt clean 명령어가 지원하는 모든 플래그 목록을 보려면 --help 플래그를 사용하세요. 사용 가능한 플래그에 대한 상세 정보(설명과 사용법 포함)가 표시돼요:
dbt clean --help
--clean-project-files-only
기본적으로 dbt는 clean-targets에 지정된 프로젝트 디렉터리 내의 모든 경로를 삭제해요.
note dbt 프로젝트 밖의 경로는 사용하지 마세요. 그렇지 않으면 오류가 발생해요.
사용 예시
dbt clean --clean-project-files-only
--no-clean-project-files-only
dbt_project.yml의 clean-targets 목록에 지정된 모든 경로를 삭제해요. 현재 dbt 프로젝트 밖의 경로도 포함해요.
dbt clean --no-clean-project-files-only
(dbt v2.0 이상 적용)
에이전트 스킬 제거
ai_provider 플래그를 설정했다면 dbt clean은 dbt가 설치한 에이전트 스킬도 제거해요:
Removing add-a-data-test -> .claude/skills
Removing naming-conventions -> .claude/skills
dbt는 설치한 스킬만 제거하는데, 각 설치된 SKILL.md에 기록한 레코드로 인식해요. 직접 작성한 스킬은 같은 디렉터리에 있어도 그대로 남아요.
원격 파일 시스템에서의 dbt clean
복잡한 권한 문제와, 접근할 수 없는 원격 파일 시스템의 핵심 부분을 실수로 삭제할 위험을 피하기 위해, 이 명령어는 Studio IDE를 구동하는 RPC 서버와 연동할 때는 동작하지 않아요. 대신 dbt에서 작업할 때 dbt deps 명령어가 패키지를 설치하기 전에 자동으로 정리해요. target 폴더는 필요하면 사이드바 파일 트리에서 수동으로 삭제할 수 있어요.