Semantic Layer 구성

Semantic Layer 구성 (Semantic Layer configurations)

Semantic Layer YAML 스펙은 시맨틱 모델, 메트릭, 디멘전의 모든 속성과 옵션을 정의해요. 새 객체를 정의하거나 YAML을 검증하거나 구성 에러를 해결할 때 권위 있는 전체 목록이 필요하면 이 레퍼런스를 사용하면 돼요.

출처: 문서

본문

Semantic Layer YAML 스펙은 시맨틱 모델, 메트릭, 디멘전의 모든 속성과 옵션을 정의해요. 새 객체를 정의하거나 YAML을 검증하거나 구성 에러를 해결할 때 완전하고 권위 있는 구성 가능 목록이 필요하면 사용하세요. 이 레퍼런스는 최신 스펙(모델 내장)과 레거시 스펙(독립 YAML) 둘 다에 대한 정보를 제공하므로, 버전 피커에서 적절한 버전을 선택해야 해요. 어떤 것이 자신의 환경에 적용되는지 알아보려면 빌드 문서를 읽어 주세요. 레거시 스펙에서 변환하려면 Migrate to the latest YAML spec을 참고하세요. 가용성 — 최신 YAML 스펙은 다음 환경에서 지원돼요:

  • dbt 플랫폼(v1 Latest 릴리스 트랙)
  • dbt v2
  • dbt v1.12

Property reference

속성 레퍼런스 페이지는 각 리소스 타입을 자세히 문서화해서 전체 YAML 스펙의 모든 속성에 대한 허용 값·구문·동작을 조회할 수 있게 해 줘요. 각 페이지의 버전 피커로 최신 스펙(모델 YAML) 또는 레거시 스펙(독립 YAML) 콘텐츠를 볼 수 있어요:

Where to define Semantic Layer objects

Object Latest spec (model YAML) Legacy spec (standalone YAML)
Semantic models models: 아래의 최상위 semantic_model: 블록 최상위 semantic_models: 목록
Metrics 같은 시맨틱 모델에만 의존하는 메트릭은 models:에서 각 모델 바로 아래에 중첩(semantic_model 아래 중첩은 아님). 다른 시맨틱 모델의 메트릭·디멘전에 의존하는 메트릭은 최상위 metrics: 블록(예: models: 밖) 아래 정의. 같은 YAML 파일이거나 별도 파일일 수 있음 독립 YAML의 최상위 metrics: 키
Dimensions 모델 컬럼의 dimension: 블록(및 선택적 derived_semantics.dimensions). 모델의 시맨틱 레이어 구성 안에 정의 시맨틱 모델의 dimensions: 목록. 모델의 시맨틱 레이어 구성 안에 정의

전체 구조와 예시는 다음 빌드 문서를 참고해 주세요:

  • Build your metrics — Semantic Layer, 메트릭 유형, 시작 방법의 개념적 개요.
  • Semantic models — 시맨틱 모델을 (모델 또는 독립적으로) 정의하는 방법, 구조, 예시.
  • Creating metrics — 메트릭 생성·구성 방법; 타입별 가이드(simple, cumulative, ratio, derived, conversion)로 연결.
  • Dimensions — 시맨틱 모델 내 시간·범주형 디멘전 정의 방법.
  • Migrate to the latest YAML spec — 레거시 메트릭 YAML 스펙에서 최신 스펙으로 마이그레이션하는 방법.

더 알아보기 (Learn more)