# Отладка ошибок

[Назад к гайдам](https://docs.getdbt.tech/guides.md)

[Menu ]()



## Общий процесс отладки

Умение отлаживать код — это навык, который поможет вам стать отличным специалистом!

1. Прочитайте сообщение об ошибке — при разработке dbt мы стараемся сделать сообщения об ошибках как можно более полезными. Сообщение об ошибке, которое выдает dbt, обычно содержит тип ошибки (подробнее о типах ошибок ниже) и имя файла, в котором она возникла.

2. Изучите файл, вызвавший проблему, и посмотрите, нет ли очевидного способа ее исправить.

3. Изолируйте проблему — например, запускайте по одной модели за раз или отмените изменения в коде, которые привели к сбою.

4. Освойте работу со скомпилированными файлами и логами.

   * Каталог `target/compiled` содержит операторы `select`, которые можно выполнить в любом редакторе запросов.
   * Каталог `target/run` содержит SQL-код, который dbt выполняет для построения ваших моделей.
   * Файл `logs/dbt.log` содержит все запросы, которые выполняет dbt, и дополнительные записи логов. Последние ошибки находятся в конце файла.
   * **Пользователи dbt**: используйте перечисленные выше файлы и каталоги или вкладку `Details` в выводе команды.
   * **Пользователи dbt v1**: обратите внимание, что ваш редактор кода *может* скрывать эти файлы в дереве представление [Справка по VSCode](https://stackoverflow.com/questions/42891463/how-can-i-show-ignored-files-in-visual-studio-code)).

5. Если вы никак не можете решить проблему, попробуйте [обратиться за помощью](https://docs.getdbt.tech/community/resources/getting-help.md). Прежде чем это сделать, уделите время грамотной формулировке вопроса, чтобы другие могли быстро разобраться в проблеме.

## Типы ошибок

Ниже мы перечислили некоторые из наиболее распространенных ошибок. Полезно понимать, что именно dbt делает «за кулисами», когда вы выполняете команду вроде `dbt run`.

| Этап            | Описание                                                                       | Тип ошибки          |
| --------------- | ------------------------------------------------------------------------------ | ------------------- |
| Инициализация   | Проверьте, что это проект dbt, и что dbt может подключиться к хранилищу данных | `Runtime Error`     |
| Парсинг         | Проверьте, что фрагменты Jinja в файлах `.sql` и файлы `.yml` валидны.         | `Compilation Error` |
| Валидация графа | Скомпилируйте зависимости в граф. Проверьте, что он ацикличен.                 | `Dependency Error`  |
| Выполнение SQL  | Запустите модели                                                               | `Database Error`    |

Давайте углубимся в некоторые из этих ошибок и как их отлаживать 👇. Примечание: не все ошибки здесь охвачены!

## Ошибки времени выполнения

*Примечание: если вы используете Studio IDE для работы над проектом, вы вряд ли столкнётесь с этими ошибками.*

### Не проект dbt

```text
Running with dbt=1.7.1
Encountered an error:
Runtime Error
  fatal: Not a dbt project (or any of the parent directories). Missing dbt_project.yml file
```

Отладка

* Используйте `pwd`, чтобы проверить, находитесь ли вы в правильной директории. Если нет, используйте `cd`, чтобы перейти туда!
* Проверьте, есть ли у вас файл с именем `dbt_project.yml` в корневой директории вашего проекта. Вы можете использовать `ls`, чтобы перечислить файлы в директории, или также открыть директорию в редакторе кода и увидеть файлы в "дереве".

### Не удалось найти профиль

```text
Running with dbt=1.7.1

Encountered an error:
Runtime Error
  Could not run dbt
  Could not find profile named 'jaffle_shops'
```

Отладка

* Проверьте ключ `profile:` в вашем `dbt_project.yml`. Например, этот проект использует профиль `jaffle_shops` (обратите внимание на множественное число):

dbt\_project.yml

```yml
profile: jaffle_shops # обратите внимание на множественное число
```

* Проверьте профили, которые у вас есть в файле `profiles.yml`. Например, этот профиль называется `jaffle_shop` (обратите внимание на единственное число).

profiles.yml

```yaml
jaffle_shop: # это не соответствует ключу profile:
  target: dev

  outputs:
    dev:
      type: postgres
      schema: dbt_alice
      ... # другие детали подключения
```

* Обновите их так, чтобы они совпадали.
* Если вы не можете найти свой файл `profiles.yml`, выполните `dbt debug --config-dir` для помощи:

```text
$ dbt debug --config-dir
Running with dbt=1.7.1
To view your profiles.yml file, run:

open /Users/alice/.dbt
```

* Затем выполните `open /Users/alice/.dbt` (при необходимости изменив путь) и убедитесь, что у вас есть файл `profiles.yml`. Если его нет, создайте его, следуя [этой документации](https://docs.getdbt.tech/docs/local/profiles.yml.md).

### Не удалось подключиться

```text
Encountered an error:
Runtime Error
  Database error while listing schemas in database "analytics"
  Database Error
    250001 (08001): Failed to connect to DB: your_db.snowflakecomputing.com:443. Incorrect username or password was specified.
```

Отладка

* Откройте ваш файл `profiles.yml` (если вы не уверены, где он находится, выполните `dbt debug --config-dir`)
* Подтвердите, что ваши учетные данные верны — возможно, вам потребуется работать с администратором базы данных, чтобы подтвердить это.
* После обновления учетных данных выполните `dbt debug`, чтобы проверить, можете ли вы подключиться

```text
$ dbt debug
Running with dbt=1.7.1
Using profiles.yml file at /Users/alice/.dbt/profiles.yml
Using dbt_project.yml file at /Users/alice/jaffle-shop-dbt/dbt_project.yml

Configuration:
  profiles.yml file [OK found and valid]
  dbt_project.yml file [OK found and valid]

Required dependencies:
 - git [OK found]

Connection:
  ...
  Connection test: OK connection ok
```

### Неверный файл `dbt_project.yml`

```text
Encountered an error while reading the project:
  ERROR: Runtime Error
  at path []: Additional properties are not allowed ('hello' was unexpected)

Error encountered in /Users/alice/jaffle-shop-dbt/dbt_project.yml
Encountered an error:
Runtime Error
  Could not run dbt
```

Отладка

* Откройте ваш файл `dbt_project.yml`.
* Найдите ошибочный ключ (например, `hello`, как указано в "'hello' was unexpected")

dbt\_project.yml

```yml
name: jaffle_shop
hello: world # это не разрешено
```

* Используйте справочный раздел для файлов [`dbt_project.yml`](https://docs.getdbt.tech/reference/dbt_project.yml.md), чтобы исправить эту проблему.
* Если вы используете ключ, который является допустимым согласно документации, проверьте, что вы используете последнюю версию dbt с помощью `dbt --version`.

## Ошибки компиляции

*Примечание: если вы используете Studio IDE для работы над проектом dbt, эта ошибка часто отображается в виде красной полосы в командной строке во время работы над проектом. Для пользователей dbt v1 такие ошибки обнаруживаются только при выполнении `dbt run` или `dbt compile`.*

### Неверная функция `ref`

```text
$ dbt run -s customers
Running with dbt=1.1.0

Encountered an error:
Compilation Error in model customers (models/customers.sql)
  Model 'model.jaffle_shop.customers' (models/customers.sql) depends on a node named 'stg_customer' which was not found
```

Отладка

* Откройте файл `models/customers.sql`.
* Используйте `cmd + f` (или эквивалент) для поиска `stg_customer`. Для этого должна существовать файл с именем `stg_customer.sql`.
* Замените эту ссылку на ссылку на другую модель (т.е. имя файла другой модели), в данном случае `stg_customers`. ИЛИ переименуйте вашу модель в `stg_customer`.

### Неверный Jinja

```text
$ dbt run
Running with dbt=1.7.1
Compilation Error in macro (macros/cents_to_dollars.sql)
  Reached EOF without finding a close tag for macro (searched from line 1)
```

Отладка

Здесь мы полагаемся на библиотеку Jinja, чтобы передать ошибку, а затем просто передаем ее вам.

Этот конкретный пример связан с забытым тегом `{% endmacro %}`, но вы также можете получить такие ошибки за:

* Забытую закрывающую `}`
* Закрытие цикла `for` перед закрытием оператора `if`

Чтобы исправить это:

* Перейдите к ошибочному файлу (например, `macros/cents_to_dollars.sql`), указанному в сообщении об ошибке
* Используйте сообщение об ошибке, чтобы найти свою ошибку

Чтобы этого избежать:

* *(dbt v1 only)* Используйте сниппеты для автодополнения фрагментов Jinja ([пакет atom-dbt](https://github.com/dbt-labs/atom-dbt))

### Неверный YAML

dbt не смог преобразовать ваш YAML в допустимый словарь.

```text
$ dbt run
Running with dbt=1.7.1

Encountered an error:
Compilation Error
  Error reading jaffle_shop: schema.yml - Runtime Error
    Syntax error near line 5
    ------------------------------
    2  |
    3  | models:
    4  | - name: customers
    5  |     columns:
    6  |       - name: customer_id
    7  |         data_tests:
    8  |           - unique

    Raw Error:
    ------------------------------
    mapping values are not allowed in this context
      in "<unicode string>", line 5, column 12
```

Отладка

Обычно это связано с отступами — вот ошибочный YAML, который вызвал эту ошибку:

```yaml

models:
  - name: customers
      columns: # этот отступ слишком большой!
      - name: customer_id
        data_tests:
          - unique
          - not_null
```

Чтобы исправить это:

* Откройте ошибочный файл (например, `schema.yml`)
* Проверьте строку в сообщении об ошибке (например, `line 5`)
* Найдите ошибку и исправьте ее

Чтобы предотвратить это:

* (dbt v1 users) Включите направляющие отступов в вашем редакторе кода, чтобы было проще проверять структуру файлов
* Используйте валидатор YAML ([пример](http://www.yamllint.com/)) для отладки любых проблем

### Неправильная спецификация YAML

Несколько другая ошибка — структура YAML правильная (т.е. парсер YAML может преобразовать это в словарь Python), *но* есть ключ, который dbt не распознает.

```text
$ dbt run
Running with dbt=1.7.1

Encountered an error:
Compilation Error
  Invalid models config given in models/schema.yml @ models: {'name': 'customers', 'hello': 'world', 'columns': [{'name': 'customer_id', 'tests': ['unique', 'not_null']}], 'original_file_path': 'models/schema.yml', 'yaml_key': 'models', 'package_name': 'jaffle_shop'} - at path []: Additional properties are not allowed ('hello' was unexpected)
```

Отладка

* Откройте файл (например, `models/schema.yml`), как указано в сообщении об ошибке
* Найдите ошибочный ключ (например, `hello`, как указано в "**'hello'** was unexpected")
* Исправьте это. Используйте документы [свойств модели](https://docs.getdbt.tech/reference/model-properties.md), чтобы найти допустимые ключи
* Если вы используете допустимый ключ, проверьте, что вы используете последнюю версию dbt с помощью `dbt --version`

## Ошибки зависимостей

```text
$ dbt run
Running with dbt=1.7.1-rc

Encountered an error:
Found a cycle: model.jaffle_shop.customers --> model.jaffle_shop.stg_customers --> model.jaffle_shop.customers
```

Ваш DAG в dbt не является ациклическим, и его необходимо исправить!

* Обновите вызовы функции `ref`, чтобы разорвать цикл.
* Если вам нужно сослаться на текущую модель, используйте переменную [`{{ this }}`](https://docs.getdbt.tech/reference/dbt-jinja-functions/this.md) вместо этого.

## Ошибки базы данных

Самые сложные ошибки из всех! Эти ошибки исходят из вашего data warehouse, и dbt передает сообщение. Возможно, вам потребуется использовать документацию вашего хранилища данных (т.е. документацию Snowflake или BigQuery), чтобы отладить их.

```text
$ dbt run
...
Completed with 1 error and 0 warnings:

Database Error in model customers (models/customers.sql)
  001003 (42000): SQL compilation error:
  syntax error line 14 at position 4 unexpected 'from'.
  compiled SQL at target/run/jaffle_shop/models/customers.sql
```

В 90% случаев причина — ошибка в SQL-коде вашей модели. Чтобы исправить её:

1. Откройте файл с ошибкой:

   * **dbt:** Откройте модель (в данном случае `models/customers.sql`, как указано в сообщении об ошибке)
   * **dbt v1:** Откройте модель, как описано выше. Также откройте скомпилированный SQL (в данном случае `target/run/jaffle_shop/models/customers.sql`, как указано в сообщении об ошибке) — может быть полезно расположить эти файлы рядом в редакторе кода.

2. Попробуйте повторно выполнить SQL, чтобы локализовать ошибку:

   * **dbt:** Используйте кнопку `Preview` в файле модели
   * **dbt v1:** Скопируйте и вставьте скомпилированный запрос в инструмент для выполнения запросов (например, веб-интерфейс Snowflake или настольное приложение, такое как DataGrip / TablePlus) и выполните его

3. Исправьте ошибку.

4. Повторно запустите модель, выполнение которой завершилось с ошибкой.

Иногда причиной становятся служебные запросы, которые dbt выполняет автоматически:

* Запросы списка объектов в базе данных.
* Запросы на создание схем.
* Хуки `pre-hook`, `post-hook`, `on-run-end` и `on-run-start`.
* Операции слияния, обновления и вставки для инкрементальных моделей и снимков.

В таких случаях следует проверить журналы — в них содержатся *все* запросы, выполненные dbt.

* **dbt**: Чтобы просмотреть журналы, откройте `Details` в выводе команды или проверьте файл `logs/dbt.log`
* **dbt v1**: Откройте файл `logs/dbt.log`.

Изоляция ошибок в журналах

Если вы сталкиваетесь с странной `Database Error`, может быть хорошей идеей очистить ваши журналы, открыв файл и удалив содержимое. Затем повторно выполните `dbt run` только для *проблемной* модели. Журналы будут содержать *только* нужный вам вывод.

## Распространённые ошибки

### `Preview` и `dbt run`: в чём разница

*(Только для пользователей Studio IDE)*

* **Preview** выполняет SQL из активной вкладки. Это аналог запуска скомпилированного `select` из `target/compiled` в редакторе запросов.
* **dbt run** создаёт объекты в базе данных.

Использование кнопки `Preview` полезно при разработке моделей, когда вы хотите визуально проверить результаты запроса. Однако вам нужно убедиться, что вы выполнили `dbt run` для всех вышестоящих моделей — в противном случае dbt попытается выбрать `from` таблицы и представления, которые не были построены.

### Забыли сохранить файлы перед запуском

С этим сталкивались все. dbt использует последнюю **сохранённую** версию файла при выполнении команды. В большинстве редакторов кода, а также в , точка рядом с именем файла означает, что в нём есть несохранённые изменения. Перед запуском любых команд dbt убедитесь, что вы нажали `cmd + s` (или аналогичную комбинацию) — со временем это становится привычкой.

### Редактирование скомпилированных файлов

*(Прежде всего для пользователей dbt v1.)*

Если вы открыли SQL-файл из каталога `target/` для отладки, легко случайно внести правку в скомпилированный файл. Настройте редактор так, чтобы файлы в `target/` отображались серым. Так проще отличить их от исходных файлов модели.

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

Вот некоторые полезные часто задаваемые вопросы, которые помогут вам отладить ваш проект dbt:

* Как создать HAR файлы

  Файлы HTTP Archive (HAR) используются для сбора данных из браузера пользователя, которые поддержка dbt использует для устранения проблем с сетью или ресурсами. Эта информация включает в себя детальную информацию о времени запросов, сделанных между браузером и сервером.

  Следующие разделы описывают, как создать HAR файлы, используя распространенные браузеры, такие как [Google Chrome](#google-chrome), [Mozilla Firefox](#mozilla-firefox), [Apple Safari](#apple-safari) и [Microsoft Edge](#microsoft-edge).

  к сведению

  Удалите или скройте любую конфиденциальную или личную информацию, прежде чем отправлять файл HAR в dbt Labs. Вы можете отредактировать файл, используя текстовый редактор.

  ### Google Chrome

  1. Откройте Google Chrome.
  2. Нажмите **Вид** --> **Инструменты разработчика**.
  3. Выберите вкладку **Сеть**.
  4. Убедитесь, что Google Chrome записывает. Красная кнопка (🔴) указывает на то, что запись уже идет. В противном случае нажмите **Записать сетевой журнал**.
  5. Выберите **Сохранить журнал**.
  6. Очистите существующие логи, нажав **Очистить сетевой журнал** (🚫).
  7. Перейдите на страницу, где возникла проблема, и воспроизведите ее.
  8. Нажмите **Экспорт HAR** (значок стрелки вниз), чтобы экспортировать файл в формате HAR. Значок находится на той же строке, что и кнопка **Очистить сетевой журнал**.
  9. Сохраните файл HAR.
  10. Загрузите файл HAR в поток тикета поддержки dbt.

  ### Mozilla Firefox

  1. Откройте Firefox.
  2. Нажмите меню приложения, затем **Дополнительные инструменты** --> **Инструменты веб-разработчика**.
  3. В закрепленной вкладке инструментов разработчика выберите **Сеть**.
  4. Перейдите на страницу, где возникла проблема, и воспроизведите ее. Страница автоматически начинает запись при навигации.
  5. Когда закончите, нажмите **Пауза/Возобновить запись сетевого журнала**.
  6. Щелкните правой кнопкой мыши в любом месте столбца **Файл** и выберите **Сохранить все как HAR**.
  7. Сохраните файл HAR.
  8. Загрузите файл HAR в поток тикета поддержки dbt.

  ### Apple Safari

  1. Откройте Safari.
  2. Если меню **Разработка** не отображается в строке меню, перейдите в **Safari**, затем **Настройки**.
  3. Нажмите **Дополнительно**.
  4. Установите флажок **Показать функции для веб-разработчиков**.
  5. В меню **Разработка** выберите **Показать веб-инспектор**.
  6. Нажмите вкладку **Сеть**.
  7. Перейдите на страницу, где возникла проблема, и воспроизведите ее.
  8. Когда закончите, нажмите **Экспорт**.
  9. Сохраните файл.
  10. Загрузите файл HAR в поток тикета поддержки dbt.

  ### Microsoft Edge

  1. Откройте Microsoft Edge.
  2. Нажмите меню **Настройки и другое** (...) справа от панели инструментов, затем выберите **Дополнительные инструменты** --> **Инструменты разработчика**.
  3. Нажмите **Сеть**.
  4. Убедитесь, что Microsoft Edge записывает. Красная кнопка (🔴) указывает на то, что запись уже идет. В противном случае нажмите **Записать сетевой журнал**.
  5. Перейдите на страницу, где возникла проблема, и воспроизведите ее.
  6. Когда закончите, нажмите **Остановить запись сетевого журнала**.
  7. Нажмите **Экспорт HAR** (значок стрелки вниз) или нажмите **Ctrl + S**, чтобы экспортировать файл в формате HAR.
  8. Сохраните файл HAR.
  9. Загрузите файл HAR в поток тикета поддержки dbt.

  ### Дополнительные ресурсы

  Посмотрите [видео о том, как создать файл HAR в Chrome](https://www.loom.com/share/cabdb7be338243f188eb619b4d1d79ca) для визуального руководства по созданию HAR файлов в Chrome.

* Повторное подключение к Snowflake через OAuth после истечения срока действия аутентификации

  При подключении Snowflake к dbt platform с помощью [OAuth](https://docs.getdbt.tech/docs/platform/manage-access/set-up-snowflake-oauth.md) dbt сохраняет токен обновления. Это позволяет повторно использовать ваши учетные данные в таких инструментах, как Studio IDE и dbt Semantic Layer, без необходимости каждый раз проходить аутентификацию заново.

  Если при попытке выполнить запросы вы видите ошибку `authentication has expired`, необходимо обновить подключение между Snowflake и dbt platform.

  Чтобы устранить проблему, выполните следующие действия:

  1. Перейдите в раздел **Your profile**, доступный в меню навигации.
  2. Откройте раздел **Credentials** и выберите проект, в котором возникла проблема.
  3. В разделе **User credentials** нажмите кнопку **Reconnect Snowflake Account**. Затем следуйте инструкциям, чтобы повторно пройти аутентификацию с помощью единого входа (SSO).

  Администратор Snowflake может [настроить срок действия токена обновления](https://docs.getdbt.tech/docs/platform/manage-access/set-up-snowflake-oauth.md#create-a-security-integration), но он не может превышать 90 дней.

  Если вы выполнили эти действия, но ошибка по-прежнему возникает, обратитесь в службу поддержки по адресу <support@getdbt.com> за дополнительной помощью.

* Почему задание dbt выдаёт ошибку «Could not parse dbt\_project.yml»?

  Сообщение об ошибке `Could not parse dbt_project.yml: while scanning for...` при запуске задания или во время разработки в dbt обычно возникает по нескольким причинам:

  * Ошибка разбора в YAML файле (например, табуляция или символы Unicode).
  * В вашем файле `dbt_project.yml` отсутствуют поля или он имеет неправильное форматирование.
  * Файл `dbt_project.yml` отсутствует в репозитории вашего dbt проекта.

  Чтобы решить эту проблему, рассмотрите следующие шаги:

  * Используйте онлайн-парсер или валидатор YAML, чтобы проверить наличие ошибок разбора в вашем YAML файле. Известные ошибки разбора включают отсутствующие поля, неправильное форматирование или табуляцию.
  * Или убедитесь, что ваш файл `dbt_project.yml` существует.

  Определив причину проблемы, вы можете исправить ошибку и повторно запустить задание dbt.

* Как исправить мой файл .gitignore?

  Файл gitignore определяет, какие файлы Git должен намеренно игнорировать. В вашем проекте такие файлы можно распознать по их курсивному оформлению.

  Если вы не можете отменить изменения, переключиться на ветку или нажать на commit — это обычно происходит из-за отсутствия файла [.gitignore](https://github.com/dbt-labs/dbt-starter-project/blob/main/.gitignore) в вашем проекте ИЛИ ваш файл gitignore не содержит необходимого содержимого внутри папки.

  Чтобы исправить это, выполните следующие шаги:

  1. В Studio IDE добавьте следующее [содержимое .gitignore](https://github.com/dbt-labs/dbt-starter-project/blob/main/.gitignore) в файл `.gitignore` вашего проекта dbt:

  ```bash
  target/
  dbt_packages/
  logs/
  # legacy -- переименовано в dbt_packages в dbt v1
  dbt_modules/
  ```

  2. Сохраните изменения, но *не создавайте коммит*
  3. Перезапустите Studio IDE, нажав на три точки рядом с **кнопкой статуса Studio IDE** в правом нижнем углу Studio IDE.

  [![Перезапустите IDE, нажав на три точки в правом нижнем углу или на строку состояния](/img/docs/dbt-platform/platform-ide/restart-ide.png?v=2 "Перезапустите IDE, нажав на три точки в правом нижнем углу или на строку состояния")](#)Перезапустите IDE, нажав на три точки в правом нижнем углу или на строку состояния

  4. Выберите **Restart Studio IDE**.
  5. Вернитесь в **File explorer** в IDE и удалите следующие файлы или папки, если они у вас есть:
     * `target`, `dbt_modules`, `dbt_packages`, `logs`
  6. Нажмите **Save**, а затем **Commit and sync**, чтобы сохранить изменения, создать коммит и синхронизировать их.
  7. Снова перезапустите Studio IDE.
  8. Создайте запрос на слияние (PR) в меню **Version Control**, чтобы включить новые изменения.
  9. Выполните слияние PR на странице вашего Git-провайдера.
  10. Переключитесь на основную ветку и нажмите **Pull from remote**, чтобы получить все изменения, внесённые в основную ветку. Чтобы проверить изменения, убедитесь, что файлы и папки, указанные в файле .gitignore, отображаются курсивом.

  [![Проект dbt в основной ветке с правильно настроенными в gitignore папками (выделены курсивом).](/img/docs/dbt-platform/platform-ide/gitignore-italics.png?v=2 "Проект dbt в основной ветке с правильно настроенными в gitignore папками (выделены курсивом).")](#)Проект dbt в основной ветке с правильно настроенными в gitignore папками (выделены курсивом).

  Для получения дополнительной информации, обратитесь к этому [подробному видео](https://www.loom.com/share/9b3b8e2b617f41a8bad76ec7e42dd014) для дополнительной помощи.

* Я получаю ошибку 'Этот запуск превысил лимиты памяти вашего аккаунта' в моей неудавшейся задаче

  Если при неудачном выполнении задания вы получаете ошибку `This run exceeded your account's run memory limits`, это означает, что задание превысило [ограничения памяти](https://docs.getdbt.tech/docs/deploy/job-scheduler.md#job-memory), установленные для вашей учетной записи. Для всех учетных записей dbt объем памяти пода составляет 600 МиБ, а ограничения памяти применяются к каждому запуску отдельно. На потребление памяти обычно влияет объем результирующих данных, которые dbt должен загрузить и обработать. Как правило, этот объем невелик, но он может неожиданно вырасти из-за решений, принятых при проектировании проекта.

  ### Общие причины

  Некоторые общие причины повышенного использования памяти:

  * dbt run/build: Макросы, которые захватывают большие наборы результатов из выполняемого запроса, могут быть не все необходимы и могут быть неэффективны по памяти.
  * dbt docs generate: Источники или схемы моделей с большим количеством таблиц (даже если эти таблицы не все используются dbt) вызывают загрузку очень больших результатов для запросов каталога.

  ### Решение

  Существует множество причин, по которым вы можете сталкиваться с этой ошибкой, но в основном они связаны с извлечением слишком большого объема данных в dbt. Например, использование операций `run_query()` или подобных макросов, или даже использование баз данных/схем, которые содержат много других таблиц/представлений, не связанных с dbt. Попробуйте уменьшить объем данных/количество строк, извлекаемых в dbt, переработав SQL в вашей операции `run_query()` с использованием клауз `group`, `where` или `limit`. Кроме того, вы можете использовать базу данных/схему с меньшим количеством таблиц/представлений, не связанных с dbt.

  Видео пример

  В качестве дополнительного ресурса, посмотрите [это видео](https://www.youtube.com/watch?v=sTqzNaFXiZ8), которое демонстрирует, как переработать пример кода, уменьшая количество возвращаемых строк.

  Если вы попробовали предыдущие предложения и все еще сталкиваетесь с неудачными запусками задач с этой ошибкой о превышении лимитов памяти вашего аккаунта, пожалуйста, [обратитесь в поддержку](mailto:support@getdbt.com). Мы будем рады помочь!

  ### Дополнительные материалы

  * [Пост в блоге о том, как мы сократили время на 90 минут](https://docs.getdbt.tech/blog/how-we-shaved-90-minutes-off-model)

* Почему я получаю ошибку времени выполнения в моих пакетах?

  Если в вашем файле packages.yml возникает приведённая ниже ошибка времени выполнения, это может быть связано с устаревшей версией пакета dbt\_utils, несовместимой с текущей версией dbt.

  ```shell
  Running with dbt=xxx
  Runtime Error
    Failed to read package: Runtime Error
      Invalid config version: 1, expected 2  
    Error encountered in dbt_utils/dbt_project.yml
  ```

  Попробуйте обновить старую версию пакета dbt\_utils в вашем packages.yml до последней версии, доступной на [dbt hub](https://hub.getdbt.com/dbt-labs/dbt_utils/latest/):

  ```shell
  packages:
  - package: dbt-labs/dbt_utils

  version: xxx
  ```

  Если вы попробовали описанное выше решение и все еще сталкиваетесь с этой проблемой, свяжитесь с нашей службой поддержки по адресу <support@getdbt.com>, и мы будем рады помочь!

* \[Ошибка] Не удалось найти пакет my\_project

  Если имя пакета включено в `search_order` конфигурации `dispatch` на уровне проекта, dbt ожидает, что этот пакет будет содержать макросы, которые могут быть кандидатами для диспетчеризации. Если включенный пакет не содержит *никаких* макросов, dbt выдаст ошибку, подобную следующей:

  ```shell
  Compilation Error
    In dispatch: Could not find package 'my_project'
  ```

  Это не означает, что пакет или корневой проект отсутствует — это значит, что отсутствуют любые макросы из него, и поэтому он отсутствует в доступных для `dispatch` пространствах поиска.

  Если вы попробовали шаг выше и все еще сталкиваетесь с этой проблемой, свяжитесь с нашей службой поддержки по адресу <support@getdbt.com>, и мы будем рады помочь!

* Что произойдет, если в моем SQL-запросе ошибка или я получу ошибку базы данных?

  Если в вашем SQL есть ошибка, dbt вернет ошибку, которую возвращает ваша база данных.

  ```shell
  $ dbt run --select customers
  Running with dbt=1.9.0
  Found 3 models, 9 tests, 0 snapshots, 0 analyses, 133 macros, 0 operations, 0 seed files, 0 sources

  14:04:12 | Concurrency: 1 threads (target='dev')
  14:04:12 |
  14:04:12 | 1 of 1 START view model dbt_alice.customers.......................... [RUN]
  14:04:13 | 1 of 1 ERROR creating view model dbt_alice.customers................. [ERROR in 0.81s]
  14:04:13 |
  14:04:13 | Finished running 1 view model in 1.68s.

  Completed with 1 error and 0 warnings:

  Database Error in model customers (models/customers.sql)
    Syntax error: Expected ")" but got identifier `your-info-12345` at [13:15]
    compiled SQL at target/run/jaffle_shop/customers.sql

  Done. PASS=0 WARN=0 ERROR=1 SKIP=0 TOTAL=1
  ```

  Любые модели, зависящие от этой модели, также будут пропущены. Используйте сообщение об ошибке и [скомпилированный SQL](https://docs.getdbt.tech/faqs/Runs/checking-logs.md) для отладки любых ошибок.
