catalog.json 파일

catalog.json 파일

catalog.json은 프로젝트의 리소스로 생성·정의된 테이블과 뷰에 대한 데이터 웨어하우스 정보를 담고 있어요. dbt는 이 파일로 문서 사이트의 컬럼 타입·테이블 통계 같은 메타데이터를 채워요.

출처: 문서

본문

현재 스키마: v1

생성 주체: (dbt v2.0 이상 적용) --write-catalog 플래그

이 파일은 프로젝트의 리소스로 생성·정의된 테이블과 뷰에 대한 데이터 웨어하우스 정보를 담고 있어요. 현재 dbt는 이 파일을 사용해 문서 사이트에서 컬럼 타입과 테이블 통계 같은 메타데이터를 채워요.

최상위 키(Top-level keys)

  • metadata
  • nodes: dbt 모델·시드·스냅샷에 해당하는 데이터베이스 객체 정보가 담긴 사전(dictionary).
  • sources: dbt 소스에 해당하는 데이터베이스 객체 정보가 담긴 사전.
  • errors: (dbt v2.0 이상 적용) 카탈로그 생성(--write-catalog 플래그 경유) 중 메타데이터 쿼리를 실행할 때 받은 오류들.

리소스 상세

sourcesnodes 안에서 각 사전 키는 리소스의 unique_id예요. 각 중첩 리소스에는 다음이 포함돼요:

  • unique_id: <resource_type>.<package>.<resource_name>, 사전 키와 동일하며 manifest의 nodes·sources를 가리켜요.
  • metadata type: table, view 등. database schema name comment owner
  • columns (array) name type: 데이터 타입 comment index: 서수(ordinal)
  • stats: 데이터베이스와 관계(relation) 유형에 따라 달라져요.