Косвенный выбор
Косвенный выбор определяет, какие тесты запускать при выборе моделей или других ресурсов. Он применяется к тестам, связанным с выбранными ресурсами через зависимости в вашем DAG — например, к тестам для вышестоящих или нижестоящих моделей, а также к тестам, которые ссылаются на несколько моделей.
Используйте флаг --indirect-selection с dbt test или dbt build, чтобы настроить это поведение. Вы можете задать его как флаг CLI или переменную окружения. В dbt v1 также можно задать пользовательские настройки в YAML-селекторах или в блоке flags: файла dbt_project.yml, который задаёт флаги на уровне проекта.
Даже если вы явно не используете флаг --indirect-selection, dbt применяет косвенный выбор при выполнении таких команд, как dbt test --select "stg_model_a+". По умолчанию используется режим eager, который запускает все тесты, ссылающиеся на выбранные модели. Например, dbt test --select model_b запустит тесты, определённые для model_b, а также тесты, определённые для вышестоящих моделей, если эти тесты ссылаются на model_b.
Когда все флаги установлены, порядок приоритета следующий. Обратитесь к О глобальных конфигурациях для получения более подробной информации:
- Конфигурации командной строки
- Переменные окружения
- Пользовательские конфигурации
Вы можете задать для флага одно из значений: empty, buildable, cautious или eager (по умолчанию). Подробнее об этих вариантах см. в разделе «Косвенный выбор» в примерах выбора тестов.
Режимы косвенного выбора определяют, какие тесты запускаются в зависимости от выбранных моделей и их связей в вашем DAG. Эти режимы определяют, как dbt обрабатывает тесты, которые ссылаются на выбранные модели напрямую или через связи с вышестоящими и нижестоящими моделями.
Вы можете использовать следующие режимы (по умолчанию — eager). Исключение тестов всегда выполняется по жадному принципу: если ХОТЯ БЫ ОДИН родительский узел явно исключён, тест также будет исключён.
Режимы buildable и cautious могут быть полезны, когда вы строите только подмножество вашего DAG и хотите избежать сбоев тестов в режиме eager, вызванных не построенными ресурсами. Вы также можете достичь этого с помощью отложенного выполнения.
Режим 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 автоматически используется для интерактивной компиляции.
Ниже представлена визуализация влияния --indirect-selection и различных флагов с использованием трех моделей, трех тестов и dbt build в качестве примера:
Например, вы можете запустить тесты, которые относятся только к выбранным узлам, используя конфигурацию командной строки:
dbt test --indirect-selection cautious
Или вы можете запустить тесты, которые относятся только к выбранным узлам, используя переменную окружения:
$ export DBT_ENGINE_INDIRECT_SELECTION=cautious
dbt run
Вы также можете запустить тесты, которые относятся только к выбранным узлам, используя флаги на уровне проекта в dbt_project.yml:
flags:
indirect_selection: cautious




