데이터 테스트의 sql_header
데이터 테스트의 sql_header (sql_header in data tests)
require_sql_header_in_test_configs 플래그는 제네릭 데이터 테스트에 대한 sql_header 구성 지원을 활성화해요. 테스트가 실행되기 전에 실행할 SQL을 정의할 수 있어요.
출처: 문서
본문
| require_sql_header_in_test_configs | dbt v1 Latest | dbt v1 |
|---|---|---|
| Introduced | 2026.3 | 1.12.0 |
Matured (default → true) |
— | — |
| Removed | — | — |
require_sql_header_in_test_configs 플래그를 true로 설정하면 제네릭 데이터 테스트에 대한 sql_header 구성 지원이 활성화돼요. 활성화하면 properties.yml 파일의 모델 또는 컬럼 레벨에서 제네릭 데이터 테스트의 config에 sql_header를 설정할 수 있어요. sql_header로 테스트 실행 전에 실행할 SQL을 정의할 수 있어요 (예: 임시 함수 생성, 세션 파라미터 설정, 테스트 쿼리에 필요한 변수 선언). dbt는 테스트 실행 전에 이 SQL을 실행해요.
예를 들어:
models/properties.yml
models:
- name: orders
columns:
- name: order_id
data_tests:
- not_null:
name: not_null_orders_order_id
config:
sql_header: "-- SQL_HEADER_TEST_MARKER"
자세한 내용은 데이터 테스트 구성을 참고하세요.