Конфигурации проверок

Связанная документация

• Проверки
• Свойства проверок
• Команда dbt check

Доступные конфигурации

YAML-файл проекта

dbt_project.yml

checks:
  <resource-path>:
    +severity: error | warn
    +enabled: true | false
    +selection_filter_on: column_name | [column_names] | none
    +tags: string | [string]
    +meta: {dictionary}

Сообщить об ошибке в коде

YAML-файл свойств

checks/_checks.yml

version: 2

checks:
  - name: check-name
    config:
      severity: error | warn
      enabled: true | false
      selection_filter_on: column_name | [column_names] | none
      tags: string | [string]
      meta: {dictionary}

Сообщить об ошибке в коде

Конфигурация в SQL

checks/<check_name>.sql

{{ config(
    severity = "error" | "warn",
    enabled = true | false,
    selection_filter_on = "column_name" | ["column_names"] | "none",
    tags = ["string"],
    meta = {"key": "value"}
) }}

select ...
from {{ info_schema('models') }}
where ...

Сообщить об ошибке в коде

Примеры

Следующие примеры показывают распространённые способы настройки проверок.

Предупреждение при неуспешной проверке

Вы можете использовать severity: warn при постепенном внедрении нового правила. Проблемы записываются в журнал, но не приводят к ошибке сборки.

checks/_public_models_have_owners.yml

checks:
  - name: public_models_have_owners
    config:
      severity: warn  # по умолчанию — error

Сообщить об ошибке в коде

Фильтрация по определённому столбцу

В таблице edges нет столбца unique_id, поэтому проверки, которые обращаются к ней, не возвращают этот столбец. При использовании --select dbt ищет столбец unique_id, чтобы ограничить результаты, но не находит его, поэтому проверка выполняется для всего проекта независимо от селектора. Укажите в selection_filter_on столбцы, содержащие идентификаторы ресурсов, чтобы --select фильтровал строки по этим столбцам. Например, проверка multiple_sources_joined выполняет агрегацию по child_unique_id, поэтому достаточно указать только этот столбец:

checks/_multiple_sources_joined.yml

checks:
  - name: multiple_sources_joined
    config:
      selection_filter_on: child_unique_id

Сообщить об ошибке в коде

Нашли ошибку?

Создать GitHub Issue