MetricFlow 시간 스파인 YAML
MetricFlow 시간 스파인 YAML (MetricFlow time spine YAML)
require_yaml_configuration_for_mf_time_spines 플래그는 MFTimespineWithoutYamlConfigurationDeprecation deprecation 경고를 억제해요. 기능적 영향은 없어요. 이 플래그는 v2에서 제거됐고 새 동작이 항상 활성화돼요.
출처: 문서
본문
이 플래그는 v2에서 제거됐어요. 새 동작이 항상 활성화돼요. 업그레이드한다면 dbt_project.yml에서 이 플래그를 제거해요.
| require_yaml_configuration_for_mf_time_spines | dbt v1 Latest | dbt v1 |
|---|---|---|
| Introduced | 2024.10 | 1.9.0 |
Matured (default → true) |
2026.09 | 1.12.0 |
| Removed | — | v2.0 |
이전 버전(dbt 1.8 이하)에서는 MetricFlow 시간 스파인 구성이 metricflow_time_spine.sql 파일에 저장됐어요.
dbt v1.12부터 이 플래그는 기본값이 true로, MFTimespineWithoutYamlConfigurationDeprecation deprecation 경고를 억제해요. 레거시 SQL 파일 구성은 두 경우 모두 계속 동작해요.
MetricFlow 속성 YAML 파일에는 time_spine: 필드가 있어야 해요. 자세한 내용은 MetricFlow 타임스파인을 참고하세요.
영향
이 플래그는 기능적 영향이 없어요; 레거시 타임스파인 모델은 두 경우 모두 계속 동작해요. 유일하게 보이는 변경은:
MFTimespineWithoutYamlConfigurationDeprecation경고가 더 이상 로그에 나타나지 않아요.--warn-error를 사용하면 그 경고가 더 이상 발생하지 않고 오류로 승격되지 않아요.
이 플래그 옵트아웃
대부분의 프로젝트에는 아무 조치가 필요 없어요. 레거시 metricflow_time_spine.sql 모델은 이 플래그 유무와 관계없이 계속 동작해요.
--warn-error 아래에서 MFTimespineWithoutYamlConfigurationDeprecation 경고가 발생하도록 의존해 YAML 마이그레이션을 강제한다면, dbt_project.yml에서 플래그를 false로 설정해 옵트아웃할 수 있어요:
dbt_project.yml
flags:
require_yaml_configuration_for_mf_time_spines: false
deprecation 경고를 영구히 제거하려면 metricflow_time_spine.sql을 models:의 모델 항목 아래 YAML time_spine 블록으로 마이그레이션해요. 현재 구문은 MetricFlow 타임스파인을 참고하세요.