quote_columns

quote_columns (시드 컬럼 따옴표 처리)

quote_columns은 선택적 시드 설정으로, 테이블을 만들 때 시드 파일의 컬럼 이름을 따옴표로 감쌀지 여부를 정해요. 대소문자 보존이 필요할 때 유용해요.

출처: dbt 공식 문서

본문

정의

선택적 시드 설정으로, 테이블을 만들 때 시드 파일의 컬럼 이름을 따옴표로 감쌀지 여부를 정해요.

  • True일 때, dbt는 시드용 테이블을 만들 때 시드 파일에 정의된 컬럼 이름을 따옴표로 감싸 대소문자를 보존해요.
  • False일 때, dbt는 시드 파일에 정의된 컬럼 이름을 따옴표로 감싸지 않아요.
  • 설정하지 않으면 컬럼 이름을 따옴표로 감쌀지 여부는 어댑터에 따라 달라요.

사용법

모든 시드 컬럼을 전역으로 따옴표 처리

dbt_project.yml

seeds:
  +quote_columns: true

seeds/mappings 디렉터리의 시드만 따옴표 처리

다음을 가진 프로젝트의 경우:

  • dbt_project.yml 파일에 name: jaffle_shop
  • dbt_project.yml 파일에 seed-paths: ["seeds"]

dbt_project.yml

seeds:
  jaffle_shop:
    mappings:
      +quote_columns: true

또는:

seeds/properties.yml


seeds:
  - name: mappings
    config:
      quote_columns: true

권장 설정

  • 시드 파일을 쓴다면 이 값을 명시적으로 설정해요.
  • 개별 프로젝트/시드가 아니라 전역으로 설정을 적용해요.
  • 컬럼 이름에 특수 문자가 있거나 대소문자를 보존해야 하는 경우가 아니라면 quote_columns: false로 설정해요. 그런 경우에는 시드 컬럼 이름을 바꾸는 걸 고려해요(이러면 다운스트림 코드가 단순해져요).

더 알아보기 (Learn more)