name 속성

name 속성

name 필드는 schema.yml 파일에서 모델 이름과 컬럼 이름을 모두 지정할 수 있는 기본 식별자 속성이에요. dbt가 리소스를 식별하고 참조(ref())를 해석하는 기준이 되는 핵심 값이라 정확히 맞춰 주는 게 중요해요.

출처: 문서

본문

name

name 필드는 schema.yml 파일에서 모델 이름과 컬럼 이름을 모두 지정하는 데 사용할 수 있어요. name으로 모델을 나타낼 때(예시의 4번째 줄처럼), dbt는 그 모델을 파일 이름으로 찾아요. 예를 들어 name: events라고 썼다면 dbt는 events.sql이라는 모델 파일을 찾게 돼요. 이 속성은 모델뿐 아니라 소스, 시드, 스냅샷, 분석, 매크로, 데이터 테스트, 유닛 테스트 등 dbt의 모든 리소스 타입에서 공통으로 쓰이는 기본 식별자예요. name 값은 해당 .yml 파일이 위치한 디렉터리에서 그 리소스를 유일하게 식별해야 하며, dbt는 이 이름을 로그, 메타데이터, 노드 참조에 그대로 사용해요. 대소문자와 철자를 정확히 맞추는 게 중요해요. 파일명과 일치하지 않으면 dbt가 속성을 적용하지 못하고, 참조하거나 선택할 때 "not found" 같은 에러가 날 수 있어요.

더 알아보기 (Learn more)