Получение помощи
Помощь сообщества
dbt развивается как open source и source-available программное обеспечение и опирается на большое и активное сообщество. Грамотно сформулированные вопросы помогают всему сообществу, расширяя нашу общую базу знаний. Следуя этим шагам, вы с большей вероятностью получите помощь от других участников сообщества.
1. Попробуйте решить проблему самостоятельно, прежде чем просить о помощи
Поищите в существующей документации
Сайт документации, на котором вы сейчас находитесь, хорошо индексируется и поддерживает поиск — в первую очередь попробуйте найти ответ здесь. Если вы новичок в dbt, начните с quickstart guide, чтобы заложить прочную основу ключевых концепций.
Попробуйте самостоятельно разобраться с ошибкой
У нас есть удобное руководство по debugging errors, которое может помочь! В нём также объясняется, почему возникают ошибки и в какой документации стоит искать помощь.
Поищите ответы с помощью вашего любимого поисковика
Мы стараемся делать всё больше ошибок доступными для поиска, поэтому имеет смысл проверить, не существует ли уже готового решения. Кроме того, некоторые ошибки, связанные с установкой dbt, SQL в ваших моделях или корректным оформлением YAML, не являются специфичными для dbt — в таких случаях могут помочь и другие источники.
Экспериментируйте!
Если ваш вопрос звучит как «Что произойдёт, если я сделаю X», попробуйте сделать X и посмотрите на результат! При условии, что у вас настроено корректное dev-окружение, ошибки на этапе разработки не повлияют на конечных пользователей.
2. Потратьте несколько минут, чтобы хорошо сформулировать вопрос
Чёткое описание проблемы значительно упрощает задачу тем, кто хочет вам помочь.
Включите в вопрос релевантные детали
Опишите, что именно идёт не так. Задавая вопрос, постарайтесь:
- Вставлять сообщение об ошибке или релевантный код в тройные бэктики, а не делиться скриншотом
- Указать версию dbt, которую вы используете (её можно посмотреть с помощью
dbt --version) - Сообщить, какое хранилище данных (warehouse) вы используете
Избегайте чрезмерного обобщения кода
Мы понимаем, что вы можете хотеть обобщить проблему или скрыть чувствительную информацию, однако замена имён и ссылок в SQL часто приводит к невалидному коду и ошибкам, отличным от исходной. Это затрудняет понимание вашей проблемы. По возможности делитесь тем кодом, который вы действительно пытаетесь выполнить.
Сообщите, что вы уже пробовали
Как правило, люди гораздо охотнее помогают, когда видят, что вы уже приложили усилия и попробовали решить проблему самостоятельно.
Опишите контекст задачи, которую вы пытаетесь решить
Иногда вы можете упереться в ограничения dbt из‑за того, что пытаетесь использовать его не так, как задумано в заложенных в него принципах. Поделившись контекстом задачи, вы поможете понять, есть ли альтернативный способ взглянуть на решение.
Публикуйте одно сообщение и используйте треды
Культура dbt Slack во многом строится вокруг тредов. Перед отправкой сообщения попробуйте сначала набросать его для себя, чтобы убедиться, что вы включили весь необходимый контекст. Большие блоки кода размещайте в тредах, чтобы не перегружать канал.
Не отмечайте конкретных людей, требуя помощи
Если кто‑то захочет ответить на ваш вопрос, он это сделает. Мы — сообщество волонтёров, и обычно мы довольно отзывчивы и готовы помочь. Если на ваш вопрос никто не ответил, подумайте, достаточно ли он помогает понять вашу проблему. Если вам требуется углублённая и постоянная поддержка, в нашей экосистеме есть замечательная группа опытных dbt‑консультантов. Полный список вы найдёте ниже.
3. Выберите подходящую площадку для вопроса
Мы используем разные каналы для обмена информацией:
- Если ваш вопрос в духе «Я столкнулся с этой ошибкой и застрял», задайте его на dbt Community Forum.
- Если вы считаете, что нашли баг, пожалуйста, сообщите о нём в соответствующем GitHub‑репозитории (например, dbt repo, dbt-utils repo).
- Если вам нужен более широкий разговор (например, «Какой лучший подход к X?», «Почему Y сделано именно так?»), присоединяйтесь к нашему Slack community. Каналы последовательно именуются с префиксами для удобства навигации.
Получение выделенной поддержки
Если вам нужна выделенная поддержка для построения dbt‑проекта, рассмотрите возможность обращения за professional services или сотрудничества с одним из наших consulting partners.
Обучение dbt
Если вы хотите пройти обучение по dbt, ознакомьтесь с нашей программой dbt Learn.
Поддержка dbt
Примечание: Если вы являетесь пользователем dbt и вам нужна помощь по одному из следующих вопросов, пожалуйста, свяжитесь с нами, нажав Create a support ticket через навигацию dbt или написав на support@getdbt.com:
- Настройка аккаунта (например, проблемы с подключением, подключение репозитория)
- Биллинг
- Сообщения о багах, связанных с веб‑интерфейсом
В качестве общего правила: если вы используете dbt, но ваша проблема связана с кодом внутри dbt‑проекта, пожалуйста, следуйте описанному выше процессу или ознакомьтесь с FAQs, а не обращайтесь напрямую в поддержку. Подробнее см. в разделе dbt support.
