제네릭 테스트 인자 속성

제네릭 테스트 인자 속성 (Generic test arguments property)

require_generic_test_arguments_property 플래그는 제네릭 테스트의 입력을 arguments 속성 아래에 지정하도록 해요. 기본값은 이제 true예요. 이전 동작을 유지하려면 dbt_project.yml에서 이 플래그를 false로 설정해요.

출처: 문서

본문

기본값은 이제 true예요. 이전 동작을 유지하려면 dbt_project.yml에서 이 플래그를 false로 설정해요.

require_generic_test_arguments_property dbt v1 Latest dbt v1
Introduced 2025.07 1.10.5
Matured (default → true) 2025.08 1.10.8
Removed — —

dbt는 arguments 속성 아래에 지정된, 제네릭 테스트 입력인 키-값 인자를 파싱하도록 지원해요. 과거에는 제네릭 테스트의 입력인 속성과 프레임워크 구성을 명확히 구분하는 방법이 없었고, 인자는 최상위 속성으로만 받았어요.

플래그가 false인 오래된 dbt v1 버전을 사용 중이라면, dbt는 arguments 속성을 인식하되 ArgumentsPropertyInGenericTestDeprecation 경고를 발생시켜요.

새 arguments 속성을 사용하는 예시:

model.yml

models:
  - name: my_model_with_generic_test
    data_tests:
      - dbt_utils.expression_is_true:
          arguments:
            expression: "order_items_subtotal = subtotal"

대안 test_name 형식을 사용하는 예시:

model.yml

models:
  - name: my_model_with_generic_test
    data_tests:
    - name: arbitrary_name
      test_name: dbt_utils.expression_is_true
      arguments:
         expression: "order_items_subtotal = subtotal"
      config:
        where: "1=1"

이 플래그가 활성화되면 dbt는:

  • 제네릭 테스트의 arguments 아래의 키-값 쌍을 제네릭 테스트 매크로의 입력으로 파싱해요.
  • arguments 속성 밖에 추가적인 비구성 인자가 지정되면 MissingArgumentsPropertyInGenericTestDeprecation 경고를 발생시켜요.

이전 동작을 유지하려면:

dbt_project.yml

flags:
  require_generic_test_arguments_property: false

더 알아보기 (Learn more)