store_failures

Настроенные тесты будут сохранять свои ошибки при вызове dbt test --store-failures. Если вы установите эту конфигурацию как false, но store_failures_as настроен, она будет переопределена.

Описание

Вы можете опционально настроить тест так, чтобы он всегда или никогда не сохранял свои ошибки в базе данных.

• Если указано как true или false, конфигурация store_failures будет иметь приоритет над наличием или отсутствием флага --store-failures.
• Если конфигурация store_failures не указана или отсутствует, ресурс будет использовать значение флага --store-failures.
• Если установлено в true, store_failures сохраняет все записи (до лимита), которые не прошли тест. Ошибки сохраняются в новой таблице с именем теста. По умолчанию, store_failures использует схему {{ profile.schema }}_dbt_test__audit, но вы можете настроить суффикс схемы на другое значение.
• Результаты теста всегда заменяют предыдущие ошибки для того же теста, даже если тест не привел к ошибкам.
• По умолчанию, store_failures использует схему с именем dbt_test__audit, но вы можете настроить схему на другое значение. Убедитесь, что у вас есть разрешение на создание или доступ к схемам для вашей работы. Для получения более подробной информации обратитесь к FAQ.

Эта логика закодирована в макросе should_store_failures().

Конкретный тест

Настройка конкретного экземпляра общего (схемного) теста:

models/<filename>.yml

version: 2

models:
  - name: my_model
    columns:
      - name: my_column
        tests:
          - unique:
              config:
                store_failures: true  # всегда сохранять ошибки
          - not_null:
              config:
                store_failures: false  # никогда не сохранять ошибки

Единичный тест

Настройка единичного (данного) теста:

tests/<filename>.sql

{{ config(store_failures = true) }}

select ...

Блок общего теста

Установка значения по умолчанию для всех экземпляров общего (схемного) теста, путем установки конфигурации внутри его блока теста (определения):

macros/<filename>.sql

{% test <testname>(model, column_name) %}

{{ config(store_failures = false) }}

select ...

{% endtest %}

Уровень проекта

Установка значения по умолчанию для всех тестов в пакете или проекте:

dbt_project.yml

tests:
  +store_failures: true  # все тесты
  
  <package_name>:
    +store_failures: false # тесты в <package_name>

Часто задаваемые вопросы

 Получение ошибки 'отказано в разрешении для схемы'

Если вы получаете ошибку Adapter name adapter: Adapter_name error: permission denied for schema dev_username_dbt_test__audit, это, скорее всего, связано с тем, что у вашего пользователя нет разрешения на создание новых схем, несмотря на наличие прав владельца на вашу собственную схему разработки.

Чтобы решить эту проблему, вам необходимо иметь соответствующие разрешения для создания или доступа к пользовательским схемам. Выполните следующую SQL-команду в вашей соответствующей среде платформы данных. Обратите внимание, что точный запрос на авторизацию может отличаться в зависимости от платформы данных:

create schema if not exists dev_username_dbt_test__audit authorization username;

Замените dev_username на имя вашей конкретной схемы разработки и username на соответствующего пользователя, которому должны быть предоставлены разрешения.

Эта команда предоставляет соответствующие разрешения для создания и доступа к схеме dbt_test__audit, которая часто используется с конфигурацией store_failures.