Конфигурации семантического слоя
Спецификация YAML для Semantic Layer определяет все свойства и параметры семантических моделей, метрик и измерений. Используйте её, когда нужен полный и достоверный перечень доступных настроек. Например, при определении новых объектов, проверке YAML или устранении ошибок конфигурации.
Поскольку этот справочник содержит информацию как об актуальной спецификации (встроенной в модель), так и об устаревшей спецификации (в отдельном YAML-файле), вам нужно выбрать соответствующую версию с помощью переключателя версий. Прочитайте документацию по созданию семантических моделей, чтобы узнать, какая спецификация применима к вашей среде. Для перехода с устаревшей спецификации см. Переход на актуальную спецификацию YAML.
Последняя версия спецификации YAML поддерживается в следующих средах:
- dbt platform (v1, канал выпусков Latest)
- dbt v2
- dbt v1.12
Справочник свойств
Страницы справочника свойств подробно описывают каждый тип ресурсов, позволяя узнать допустимые значения, синтаксис и поведение каждого свойства в полной спецификации YAML. Используйте переключатель версий на каждой странице, чтобы просмотреть содержимое для актуальной спецификации (YAML модели) или устаревшей спецификации (отдельный YAML-файл):
- Свойства семантических моделей
- Свойства метрик
- Свойства измерений — для актуальной спецификации здесь разграничены ключи уровня столбца (
dimension:,granularity:) и свойства внутри блокаdimension:; используйте переключатель версий на этой странице, чтобы просмотреть поляdimensions:устаревшей спецификации в отдельном YAML-файле.
Где определять объекты Semantic Layer
| Объект | Актуальная спецификация (YAML модели) | Устаревшая спецификация (отдельный YAML-файл) |
|---|---|---|
| Семантические модели | Блок semantic_model: верхнего уровня внутри models. | Список semantic_models: верхнего уровня. |
| Метрики | Метрики, которые зависят только от той же семантической модели, размещайте непосредственно внутри каждой модели в models: (но не внутри semantic_model). Метрики, которые зависят от метрик или измерений из другой семантической модели, определяйте в блоке metrics: верхнего уровня (например, вне models:). Он может находиться в том же YAML-файле или в отдельном. | Ключ metrics: верхнего уровня в отдельном YAML-файле. |
| Измерения | Блоки dimension: в столбцах модели (и необязательный derived_semantics.dimensions). Определяются в конфигурации семантического слоя модели. | Список dimensions: в семантической модели. Определяется в конфигурации семантического слоя модели. |
Связанная документация
Полную структуру и примеры см. в следующих руководствах по созданию:
- Создание метрик: Обзор концепций Semantic Layer, типов метрик и первых шагов.
- Семантические модели: Как определять семантические модели (в модели или отдельно), их структура и примеры.
- Создание и настройка метрик: Как создавать и настраивать метрики; ссылки на руководства по отдельным типам (simple, cumulative, ratio, derived, conversion).
- Измерения: Как определять временные и категориальные измерения в семантических моделях.
- Переход на актуальную спецификацию YAML: Как перейти с устаревшей спецификации YAML для метрик на актуальную.
