Семантический манифест
Создается при выполнении: Любой команды, которая анализирует ваш проект. Это включает все команды, кроме deps, clean, debug и init.
dbt создает файл артефакта под названием Semantic Manifest (semantic_manifest.json), который необходим MetricFlow для правильного построения и выполнения запросов метрик для dbt Semantic Layer. Этот артефакт содержит полную информацию о вашем dbt Semantic Layer. Это внутренний файл, который служит точкой интеграции с MetricFlow.
Используя семантический манифест, созданный dbt Core, MetricFlow создаст план потока данных и сгенерирует SQL из запросов к Semantic Layer. Это ценный справочник, который вы можете использовать для понимания структуры и деталей ваших моделей данных.
Подобно файлу manifest.json, файл semantic_manifest.json также находится в целевой директории вашего dbt проекта, где dbt хранит различные артефакты (такие как скомпилированные модели и тесты), созданные во время выполнения вашего проекта.
Ключи верхнего уровня
Ключи верхнего уровня для семантического манифеста:
semantic_models— Начальные точки данных с сущностями, измерениями и мерами, соответствующие моделям в вашем dbt проекте.metrics— Функции, объединяющие меры, ограничения и т.д., для определения количественных показателей.project_configuration— Содержит информацию о конфигурациях вашего проекта.
Пример
{
"semantic_models": [
{
"name": "semantic model name",
"defaults": null,
"description": "semantic model description",
"node_relation": {
"alias": "model alias",
"schema_name": "model schema",
"database": "model db",
"relation_name": "Fully qualified relation name"
},
"entities": ["entities in the semantic model"],
"measures": ["measures in the semantic model"],
"dimensions": ["dimensions in the semantic model" ],
"metrics": [
{
"name": "name of the metric",
"description": "metric description",
"type": "metric type",
"type_params": {
"measure": {
"name": "name for measure",
"filter": "filter for measure",
"alias": "alias for measure"
},
"numerator": null,
"denominator": null,
"expr": null,
"window": null,
"grain_to_date": null,
"metrics": ["metrics used in defining the metric. this is used in derived metrics"],
"input_measures": []
},
"filter": null,
"metadata": null
}
],
"project_configuration": {
"time_spine_table_configurations": [
{
"location": "fully qualified table name for timespine",
"column_name": "date column",
"grain": "day"
}
],
"metadata": null,
"dsi_package_version": {}
},
"saved_queries": [
{
"name": "name of the saved query",
"query_params": {
"metrics": [
"metrics used in the saved query"
],
"group_by": [
"TimeDimension('model_primary_key__date_column', 'day')",
"Dimension('model_primary_key__metric_one')",
"Dimension('model__dimension')"
],
"where": null
},
"description": "Description of the saved query",
"metadata": null,
"label": null,
"exports": [
{
"name": "saved_query_name",
"config": {
"export_as": "view",
"schema_name": null,
"alias": null
}
}
]
}
]
}
]
}