О команде dbt snapshot
Команда dbt snapshot выполняет снимки, определённые в вашем проекте. Снимки фиксируют изменения исходных данных с течением времени, реализуя медленно изменяющиеся измерения типа 2. Запускайте dbt snapshot по расписанию (например, ежедневно), чтобы фиксировать изменения в исходных таблицах.
Определяйте снимки в YAML, указывая стратегию и unique_key; подробности настройки см. в разделе Конфигурации снимков. Вы также можете запускать снимки в составе dbt build.
dbt ищет снимки в каталогах, перечисленных в snapshot-paths в файле dbt_project.yml. По умолчанию dbt использует каталог snapshots/. Если вы храните снимки в нескольких папках, можно указать несколько путей.
Использование
Чтобы просмотреть полный список поддерживаемых параметров в терминале, выполните:
dbt snapshot --help
Флаги --select и --exclude определяют, какие снимки выполнить. См. Синтаксис выбора узлов. Команда dbt snapshot также принимает общие параметры, например --target и --threads. Подробности, включая настройки журналов, приведены в разделе Глобальные флаги.
Используйте --vars, если SQL-код вашего снимка обращается к значениям с помощью функции var(). Синтаксис, правила приоритета и дополнительные примеры приведены в разделе Определение переменных в командной строке.
dbt snapshot --select my_snapshot --vars '{"cutoff_date": "2026-01-01"}'
Снапшоты игнорируют как параметр конфигурации full_refresh, так и флаг --full-refresh. Команда, например dbt build --full-refresh или dbt snapshot --full-refresh, включающая узел снапшота, выполняет его в обычном режиме — таблица снапшота не удаляется и не создаётся заново, поэтому существующая история снапшота сохраняется.
Начиная с dbt v1.12, вы можете просмотреть SQL, сгенерированный для этого снимка, выполнив dbt compile или dbt compile --select orders_snapshot.
Откройте скомпилированный SQL в target/compiled/, чтобы изучить сгенерированные запросы или выполнить их отладку. Каждый снимок компилируется в отдельный SQL-файл, даже если в одном исходном файле определено несколько снимков.