Файл Manifest JSON
| Версия dbt | Версия Manifest |
|---|---|
| dbt v2.0 | v12 |
| dbt v1.11 | v12 |
| dbt v1.10 | v12 |
| dbt v1.9 | v12 |
| dbt v1.8 | v12 |
| dbt v1.7 | v11 |
| dbt v1.6 | v10 |
| dbt v1.5 | v9 |
| dbt v1.4 | v8 |
| dbt v1.3 | v7 |
Создаётся командами: Любая команда dbt, которая выполняет разбор проекта. Сюда входят все команды, кроме deps, clean, debug и init.
После выполнения команды dbt файл manifest.json можно найти в каталоге target/ проекта:
- При локальной разработке: откройте каталог
target/в папке проекта - В Studio IDE: откройте каталог
target/в дереве файлов - В заданиях dbt platform: скачайте
manifest.jsonс вкладки артефактов для конкретного запуска задания
Этот файл содержит полное представление ресурсов вашего проекта dbt (моделей, тестов, макросов и многого другого), включая все конфигурации узлов и свойства ресурсов. Даже если вы запускаете лишь некоторые модели или тесты, в манифесте будут представлены все ресурсы (если они не отключены) с большинством их свойств. Некоторые свойства, такие как compiled_sql, включаются только для выполненных узлов.
В настоящее время dbt использует этот файл для наполнения сайта документации и для сравнения состояний. Участники сообщества также используют его для анализа состояния проекта, например для проверки наличия описаний или тестов.
Ключи верхнего уровня
metadatanodes: Словарь всех анализов, моделей, seed-файлов, снимков и тестов.sources: Словарь источниковmetrics: Словарь метрикexposures: Словарь экспозицийgroups: Словарь групп (Примечание: добавлено в v1.5)macros: Словарь макросовdocs: Словарь блоковdocsparent_map: Словарь, содержащий непосредственных родителей каждого ресурсаchild_map: Словарь, содержащий непосредственных потомков каждого ресурсаgroup_map: Словарь, сопоставляющий имена групп с узлами их ресурсовselectors: Развёрнутое представление YAML-селекторовselectorsв виде словаряdisabled: Массив ресурсов сenabled: false
Детали ресурсов
Все ресурсы, вложенные в nodes, sources, metrics, exposures, macros и docs, имеют следующие базовые свойства:
name: Имя ресурсаunique_id:<resource_type>.<package>.<resource_name>, совпадает с ключом словаряpackage_name: Имя пакета, в котором определён этот ресурсroot_path: Абсолютный путь к пакету этого ресурса. (Примечание: Это поле было удалено для большинства типов узлов в dbt v1.4 / manifest v8, чтобы сократить дублирование информации между узлами, но оно по-прежнему присутствует для seeds.)path: Относительный путь к файлу, в котором определён этот ресурс, в пределах соответствующего «пути к ресурсам» (model-paths,seed-pathsи других).original_file_path: Относительный путь к файлу, в котором определён этот ресурс, включая путь к ресурсам.
Каждый из них имеет несколько дополнительных свойств, связанных с его типом ресурса.
JSON-схема dbt
Сведения об описании и использовании артефактов, созданных dbt, можно найти в JSON-схеме dbt.
Примечание: Номер версии manifest.json связан с (но не равен) вашей версии dbt, поэтому вы должны использовать правильную версию manifest.json для вашей версии dbt. Чтобы найти правильную версию manifest.json, выберите версию dbt в верхней навигации (например, v1.5).
См. таблицу в начале этой страницы, чтобы понять, как версия манифеста соотносится с версией dbt.