# Косвенный выбор

Косвенный выбор определяет, какие тесты запускать при выборе моделей или других ресурсов. Он применяется к тестам, связанным с выбранными ресурсами через зависимости в вашем DAG — например, к тестам для вышестоящих или нижестоящих моделей, а также к тестам, которые ссылаются на несколько моделей.

Используйте флаг `--indirect-selection` с `dbt test` или `dbt build`, чтобы настроить это поведение. Вы можете задать его как флаг CLI или переменную окружения. В dbt v1 также можно задать пользовательские настройки в [YAML-селекторах](https://docs.getdbt.tech/reference/node-selection/yaml-selectors.md) или в блоке `flags:` файла `dbt_project.yml`, который задаёт флаги на уровне проекта.

Косвенный выбор применяется по умолчанию

Даже если вы явно не используете [флаг `--indirect-selection`](https://docs.getdbt.tech/reference/node-selection/test-selection-examples.md?indirect-selection-mode=eager#indirect-selection), dbt применяет косвенный выбор при выполнении таких команд, как `dbt test --select "stg_model_a+"`. По умолчанию используется режим `eager`, который запускает все тесты, ссылающиеся на выбранные модели. Например, `dbt test --select model_b` запустит тесты, определённые для `model_b`, а также тесты, определённые для вышестоящих моделей, если эти тесты ссылаются на `model_b`.

Когда все флаги установлены, порядок приоритета следующий. Обратитесь к [О глобальных конфигурациях](https://docs.getdbt.tech/reference/global-configs/about-global-configs.md) для получения более подробной информации:

1. Конфигурации командной строки
2. Переменные окружения
3. Пользовательские конфигурации

Вы можете задать для флага одно из значений: `empty`, `buildable`, `cautious` или `eager` (по умолчанию). Подробнее об этих вариантах см. в разделе [«Косвенный выбор» в примерах выбора тестов](https://docs.getdbt.tech/reference/node-selection/test-selection-examples.md?indirect-selection-mode=eager#indirect-selection).

Режимы косвенного выбора определяют, какие тесты запускаются в зависимости от выбранных моделей и их связей в вашем DAG. Эти режимы определяют, как dbt обрабатывает тесты, которые ссылаются на выбранные модели напрямую или через связи с вышестоящими и нижестоящими моделями.

Вы можете использовать следующие режимы (по умолчанию — `eager`). Исключение тестов всегда выполняется по жадному принципу: если ХОТЯ БЫ ОДИН родительский узел явно исключён, тест также будет исключён.

Создание подмножеств DAG

Режимы `buildable` и `cautious` могут быть полезны, когда вы строите только подмножество вашего DAG и хотите избежать сбоев тестов в режиме `eager`, вызванных не построенными ресурсами. Вы также можете достичь этого с помощью [отложенного выполнения](https://docs.getdbt.tech/reference/node-selection/defer.md).

#### Режим eager (по умолчанию)

Этот режим охватывает наибольшее количество тестов и запускает их, если выбран *хотя бы один* из родительских узлов, независимо от того, удовлетворены ли все зависимости. Сюда входят *любые* тесты, которые ссылаются на выбранные узлы, даже если они также ссылаются на другие, невыбранные узлы.

Например, если вы выполните `dbt test --select model_b`, в режиме eager будут запущены:

* Тесты непосредственно для `model_b`
* Тесты в вышестоящих моделях (таких как `model_a`), которые ссылаются на `model_b`
* Тесты в нижестоящих моделях, которые ссылаются на `model_b`

dbt строит модели, которые зависят от выбранной модели. В этом режиме любые тесты, зависящие от ресурсов, которые не были построены, приведут к ошибке.

#### Режим Buildable

Режим Buildable — это промежуточный вариант между `cautious` и `eager`: в нём запускаются только тесты, ссылающиеся на выбранные узлы (или их предков). Этот режим немного менее строгий, чем `cautious`: он включает тесты, каждая ссылка которых указывает на выбранный узел или его предка. Этот режим полезен, когда тест зависит от модели *и* её непосредственного предка, например при проверке того, что итоговые значения после агрегации совпадают с итоговыми значениями входных данных.

#### Режим Cautious

Cautious — самый строгий режим: он гарантирует, что тесты выполняются, а модели строятся только при соблюдении всех необходимых зависимостей выбранных моделей. Он ограничивает набор тестов теми, которые ссылаются исключительно на выбранные узлы. Тесты выполняются только в том случае, если выбраны все узлы, от которых они зависят. Это предотвращает запуск тестов, если один или несколько их родительских узлов не выбраны и, следовательно, не построены.

#### Режим Empty

В режиме Empty тесты не запускаются, а построение ограничивается выбранным узлом: все косвенные зависимости игнорируются. В этом режиме не выполняются никакие тесты, независимо от того, привязаны ли они непосредственно к выбранному узлу. Режим Empty автоматически используется для [интерактивной компиляции](https://docs.getdbt.tech/reference/commands/compile.md#interactive-compile).

Ниже представлена визуализация влияния `--indirect-selection` и различных флагов с использованием трех моделей, трех тестов и `dbt build` в качестве примера:

[![dbt build](/img/docs/reference/indirect-selection-dbt-build.png?v=2 "dbt build")](#)dbt build

[![Eager (по умолчанию)](/img/docs/reference/indirect-selection-eager.png?v=2 "Eager (по умолчанию)")](#)Eager (по умолчанию)

[![Buildable](/img/docs/reference/indirect-selection-buildable.png?v=2 "Buildable")](#)Buildable

[![Cautious](/img/docs/reference/indirect-selection-cautious.png?v=2 "Cautious")](#)Cautious

[![Empty](/img/docs/reference/indirect-selection-empty.png?v=2 "Empty")](#)Empty

Например, вы можете запустить тесты, которые относятся только к выбранным узлам, используя конфигурацию командной строки:

Usage

```shell
dbt test --indirect-selection cautious
```

Или вы можете запустить тесты, которые относятся только к выбранным узлам, используя переменную окружения:

Env var

(Версии dbt: v1.11 и новее)

```text

$ export DBT_ENGINE_INDIRECT_SELECTION=cautious
dbt run
```

Вы также можете запустить тесты, которые относятся только к выбранным узлам, используя флаги на уровне проекта в `dbt_project.yml`:

dbt\_project.yml

```yaml

flags:
  indirect_selection: cautious
```
