# target\_database

примечание

Начиная с dbt v1.9 эта функциональность больше не используется. Вместо неё используйте конфигурацию [database](https://docs.getdbt.tech/reference/resource-configs/database.md), чтобы задать пользовательскую базу данных, сохранив при этом применение макроса `generate_database_name`.

Попробуйте прямо сейчас в [канале релизов dbt **v1 Latest**](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md).

dbt\_project.yml

```yml
snapshots:
  <resource-path>:
    +target_database: string
```

snapshots/\<filename>.sql

```jinja2
{{ config(
  target_database="string"
) }}
```

## Описание

База данных, в которую dbt должен построить [снимок](https://docs.getdbt.tech/docs/build/snapshots.md) таблица.

Примечания:

* Указанная база данных должна уже существовать
* В **BigQuery** это аналогично `проекту`.
* В **Redshift** кросс-базовые запросы невозможны. Если вы используете этот параметр, вы получите следующую ошибку. Таким образом, **не используйте** этот параметр в Redshift:

```text
Обнаружена ошибка:
Ошибка выполнения
  Кросс-базовые ссылки не разрешены в redshift (raw vs analytics)
```

## По умолчанию

По умолчанию dbt будет использовать [target](https://docs.getdbt.tech/reference/dbt-jinja-functions/target.md) базу данных, связанную с вашим профилем/соединением.

## Примеры

### Построение всех снимков в базе данных с именем `snapshots`

dbt\_project.yml

```yml
snapshots:
  +target_database: snapshots
```

### Использование базы данных с учетом цели

Используйте переменную [`{{ target }}`](https://docs.getdbt.tech/reference/dbt-jinja-functions/target.md), чтобы изменить, в какой базе данных будет построена таблица снимков.

Примечание: подумайте, подходит ли вам этот вариант использования, так как последующие `refs` будут выбирать из `dev` версии снимка, что может затруднить проверку моделей, зависящих от снимков.

dbt\_project.yml

```yml
snapshots:
  +target_database: "{% if target.name == 'dev' %}dev{% else %}{{ target.database }}{% endif %}"
```

### Использование того же поведения именования баз данных, что и у моделей

Используйте макрос [`generate_database_name`](https://docs.getdbt.tech/docs/build/custom-databases.md), чтобы строить снимки в базах данных, которые следуют тому же поведению именования, что и ваши модели.

Примечания:

* Этот макрос недоступен при настройке из файла `dbt_project.yml`, поэтому его необходимо указывать в конфигурации snapshot SQL-файла.
* Стоит заранее подумать, подходит ли вам такой сценарий использования, так как downstream `refs` будут выбирать данные из версии snapshot для `dev`, что может усложнить проверку моделей, зависящих от snapshots.

snapshots/orders\_snaphot.sql

```sql
{{
    config(
      target_database=generate_database_name('snapshots')
    )
}}
```
