# О переменных target

Переменная `target` содержит информацию о вашем подключении к хранилищу.

* **dbt v1:** Эти значения определяются на основе целевого окружения, заданного в файле [profiles.yml](https://docs.getdbt.tech/docs/local/profiles.yml.md). Обратите внимание: для некоторых адаптеров могут потребоваться дополнительные шаги настройки. См. [страницу настройки](https://docs.getdbt.tech/docs/local/connect-data-platform/about-dbt-connections.md) для вашей платформы данных.

* **dbt** Подробнее о настройке адаптера в dbt см. в разделе [О подключениях к платформам данных](https://docs.getdbt.tech/docs/platform/connect-data-platform/about-connections.md).

  * **[Orchestrator](https://docs.getdbt.tech/docs/deploy/job-scheduler.md)**: `target.name` задаётся для каждого задания, как описано в разделе [Пользовательские имена целевых окружений](https://docs.getdbt.tech/docs/build/custom-target-names.md). Значения остальных атрибутов определяются подключением среды развёртывания. Чтобы проверить эти значения, нажмите **Deploy** и выберите **Environments**. Затем выберите нужную среду развёртывания и нажмите **Settings**.
  * **[Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md)**: Эти значения определяются вашим подключением и учётными данными. Чтобы изменить эти значения, нажмите на имя своей учётной записи в левом боковом меню и выберите **Account settings**. Затем нажмите **Credentials**. Выберите проект и отредактируйте его настройки, чтобы задать учётные данные и имя целевого окружения.

Некоторые настройки общие для всех адаптеров, а другие зависят от адаптера. Вы также можете использовать [флаг `--target`](#%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D1%84%D0%BB%D0%B0%D0%B3%D0%B0---target), чтобы задать активное целевое окружение при выполнении команд dbt.

## Общие

| Переменная            | Пример       | Описание                                                                                             |
| --------------------- | ------------ | ---------------------------------------------------------------------------------------------------- |
| `target.profile_name` | jaffle\_shop | Имя активного профиля                                                                                |
| `target.name`         | dev          | Имя активной цели                                                                                    |
| `target.schema`       | dbt\_alice   | Имя схемы dbt (или, набора данных в BigQuery)                                                        |
| `target.type`         | postgres     | Активный используемый адаптер. Один из "postgres", "snowflake", "bigquery", "redshift", "databricks" |
| `target.threads`      | 4            | Количество потоков, используемых dbt                                                                 |

## Специфичные для адаптера

### Snowflake

| Переменная         | Пример          | Описание                                    |
| ------------------ | --------------- | ------------------------------------------- |
| `target.database`  | RAW             | Имя базы данных, указанное в активной цели. |
| `target.warehouse` | TRANSFORM       | Имя виртуального склада Snowflake           |
| `target.user`      | TRANSFORM\_USER | Пользователь, указанный в активной цели     |
| `target.role`      | TRANSFORM\_ROLE | Роль, указанная в активной цели             |
| `target.account`   | abc123          | Учетная запись, указанная в активной цели   |

### Postgres/Redshift

| Переменная      | Пример                                  | Описание                                    |
| --------------- | --------------------------------------- | ------------------------------------------- |
| `target.dbname` | analytics                               | Имя базы данных, указанное в активной цели. |
| `target.host`   | abc123.us-west-2.redshift.amazonaws.com | Хост, указанный в активной цели             |
| `target.user`   | dbt\_user                               | Пользователь, указанный в активной цели     |
| `target.port`   | 5439                                    | Порт, указанный в активном профиле          |

### BigQuery

| Переменная       | Пример     | Описание                             |
| ---------------- | ---------- | ------------------------------------ |
| `target.project` | abc-123    | Проект, указанный в активном профиле |
| `target.dataset` | dbt\_alice | Набор данных активного профиля       |

## Использование флага --target

Используйте флаг `--target` при выполнении команд dbt, чтобы задать активную целевую конфигурацию и связанное с ней значение `target.name`:

```bash
dbt run --target dev
```

```bash
dbt run --target prod
```

Вы можете использовать флаг `--target` с любой командой dbt, чтобы переопределить целевую конфигурацию по умолчанию, указанную в файле `profiles.yml`. Это удобно для запуска одного и того же проекта dbt в разных средах (например, dev, staging или prod) без изменения файлов конфигурации.

## Примеры

### Использование `target.name` для ограничения данных в dev

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

```sql
select
  *
from source('web_events', 'page_views')
{% if target.name == 'dev' %}
where created_at >= dateadd('day', -3, current_date)
{% endif %}
```

### Использование `target.name` для изменения вашей исходной базы данных

Если у вас настроены определенные базы данных Snowflake для ваших сред dev/qa/prod, вы можете настроить ваши источники для компиляции в разные базы данных в зависимости от вашей среды.

```yml
 
sources:
  - name: source_name 
    database: |
      {%- if  target.name == "dev" -%} raw_dev
      {%- elif target.name == "qa"  -%} raw_qa
      {%- elif target.name == "prod"  -%} raw_prod
      {%- else -%} invalid_database
      {%- endif -%}
    schema: source_schema
```
