# О команде dbt snapshot

Команда `dbt snapshot` выполняет [снимки](https://docs.getdbt.tech/docs/build/snapshots.md), определённые в вашем проекте. Снимки фиксируют изменения исходных данных с течением времени, реализуя [медленно изменяющиеся измерения типа 2](https://en.wikipedia.org/wiki/Slowly_changing_dimension#Type_2:_add_new_row). Запускайте `dbt snapshot` по расписанию (например, ежедневно), чтобы фиксировать изменения в исходных таблицах.

Определяйте снимки в YAML, указывая стратегию и `unique_key`; подробности настройки см. в разделе [Конфигурации снимков](https://docs.getdbt.tech/reference/snapshot-configs.md). Вы также можете запускать снимки в составе [dbt build](https://docs.getdbt.tech/reference/commands/build.md).

dbt ищет снимки в каталогах, перечисленных в `snapshot-paths` в файле `dbt_project.yml`. По умолчанию dbt использует каталог `snapshots/`. Если вы храните снимки в нескольких папках, можно указать несколько путей.

## Использование

Чтобы просмотреть полный список поддерживаемых параметров в терминале, выполните:

```shell
dbt snapshot --help
```

Флаги `--select` и `--exclude` определяют, какие снимки выполнить. См. [Синтаксис выбора узлов](https://docs.getdbt.tech/reference/node-selection/syntax.md). Команда `dbt snapshot` также принимает общие параметры, например `--target` и `--threads`. Подробности, включая настройки журналов, приведены в разделе [Глобальные флаги](https://docs.getdbt.tech/reference/global-configs/about-global-configs.md).

Используйте `--vars`, если SQL-код вашего снимка обращается к значениям с помощью функции `var()`. Синтаксис, правила приоритета и дополнительные примеры приведены в разделе [Определение переменных в командной строке](https://docs.getdbt.tech/docs/build/project-variables.md#defining-variables-on-the-command-line).

```shell
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`](https://docs.getdbt.tech/reference/commands/compile.md) или `dbt compile --select orders_snapshot`.

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