Перейти к основному содержимому

О команде 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, включающая узел снапшота, выполняет его в обычном режиме — таблица снапшота не удаляется и не создаётся заново, поэтому существующая история снапшота сохраняется.

Скомпилированный SQL для снимков

Начиная с dbt v1.12, вы можете просмотреть SQL, сгенерированный для этого снимка, выполнив dbt compile или dbt compile --select orders_snapshot.

Откройте скомпилированный SQL в target/compiled/, чтобы изучить сгенерированные запросы или выполнить их отладку. Каждый снимок компилируется в отдельный SQL-файл, даже если в одном исходном файле определено несколько снимков.

Нашли ошибку?

0
Loading