Получение помощи
Помощь сообщества
dbt — это проект с открытым исходным кодом, за которым стоит щедрое сообщество. Задавая вопросы правильно, вы вносите вклад в сообщество, расширяя наше коллективное знание. Следуя этим шагам, вы с большей вероятностью получите помощь от другого участника сообщества.
1. Попробуйте сначала решить свою проблему, прежде чем просить о помощи
Поиск в существующей документации
Сайт документации, на котором вы находитесь, хорошо поддается поиску, убедитесь, что вы исследовали его в поисках ответа в первую очередь. Если вы новичок в dbt, попробуйте сначала пройти руководство по быстрому старту, чтобы получить прочную основу по основным концепциям.
Попробуйте устранить проблему самостоятельно
У нас есть удобное руководство по отладке ошибок, которое поможет вам! Это руководство также объясняет, почему возникают ошибки, и какие документы вам могут понадобиться для поиска помощи.
Поиск ответов с помощью вашего любимого поисковика
Мы стремимся сделать больше ошибок доступными для поиска, поэтому стоит проверить, есть ли уже готовое решение! Кроме того, некоторые ошибки, связанные с установкой dbt, SQL в ваших моделях или правильной настройкой YAML, не специфичны для dbt, поэтому могут быть и другие ресурсы для проверки.
Экспериментируйте!
Если ваш вопрос: "Что произойдет, если я сделаю X
", попробуйте сделать X
и посмотрите, что произойдет! Если у вас настроена надежная среда разработки, ошибки в разработке не повлияют на ваших конечных пользователей.
2. Потратьте несколько минут, чтобы хорошо сформулировать свой вопрос
Четкое объяснение проблем, с которыми вы сталкиваетесь, поможет другим помочь вам.
Включите в вопрос соответствующие детали
Укажите, что именно идет не так! Когда вы задаете вопрос, вы должны:
- Вставить сообщение об ошибке или соответствующий код в три обратные кавычки в вашем вопросе, вместо того чтобы делиться скриншотом
- Указать версию dbt, которую вы используете (которую можно проверить с помощью
dbt --version
) - Сообщить, какое хранилище данных вы используете
Избегайте обобщения вашего кода
Хотя мы понимаем, что вы можете захотеть обобщить свою проблему или у вас может быть конфиденциальная информация, которую вы хотите анонимизировать, часто замена ссылок в SQL может привести к недействительному коду, который создает ошибку, отличную от той, с которой вы столкнулись. Это затрудняет понимание вашей проблемы. По возможности делитесь точным кодом, который вы пытаетесь запустить.
Сообщите, что вы уже пробовали
В общем, люди гораздо более склонны помочь, когда знают, что вы уже приложили все усилия!
Поделитесь контекстом проблемы, которую вы пытаетесь решить
Иногда вы можете столкнуться с ограничениями dbt, потому что пытаетесь использовать его таким образом, который не соответствует заложенным в dbt принципам. Поделившись контекстом проблемы, которую вы пытаетесь решить, мы можем предложить альтернативный способ ее решения.
Публикуйте одно сообщение и используйте потоки
Культура Slack dbt вращается вокруг потоков. При публикации сообщения попробуйте сначала набросать его себе, чтобы убедиться, что вы включили весь контекст. Включайте большие блоки кода в поток, чтобы не перегружать канал.
Не отмечайте отдельных людей, требуя помощи
Если кто-то захочет ответить на ваш вопрос, он это сделает. Мы — сообщество волонтеров, и мы, как правило, довольно отзывчивы и готовы помочь! Если никто не ответил на ваш вопрос, подумайте, задали ли вы вопрос, который помогает нам понять вашу проблему. Если вам требуется углубленная, постоянная помощь, у нас есть замечательная группа опытных консультантов по dbt в нашей экосистеме. Полный список можно найти ниже.
3. Выберите правильный канал для вашего вопроса
Мы используем несколько различных каналов для обмена информацией:
- Если ваш вопрос примерно такой: "Я столкнулся с этой ошибкой и застрял", пожалуйста, задайте его на форуме сообщества dbt.
- Если вы думаете, что нашли ошибку, пожалуйста, сообщите о ней в соответствующем репозитории GitHub (например, репозиторий dbt, репозиторий dbt-utils).
- Если вы ищете более широкую дискуссию (например, "Какой лучший подход к X?", "Почему Y делается таким образом?"), присоединяйтесь к нашему сообществу в Slack. Каналы последовательно именуются с префиксами для облегчения поиска.
Получение специализированной поддержки
Если вам нужна специализированная поддержка для создания вашего проекта dbt, рассмотрите возможность обращения за профессиональными услугами или сотрудничества с одним из наших консультантов-партнеров.
Обучение dbt
Если вы хотите пройти обучение dbt, ознакомьтесь с нашей программой dbt Learn.
Поддержка dbt Cloud
Примечание: Если вы являетесь пользователем dbt Cloud и вам нужна помощь с одной из следующих проблем, пожалуйста, свяжитесь с нами, нажав Создать заявку в поддержку через навигацию dbt Cloud или отправив электронное письмо на support@getdbt.com:
- Настройка учетной записи (например, проблемы с подключением, подключения к репозиторию)
- Выставление счетов
- Сообщения об ошибках, связанных с веб-интерфейсом
Как правило, если вы используете dbt Cloud, но ваша проблема связана с кодом в вашем проекте dbt, следуйте вышеуказанному процессу или ознакомьтесь с часто задаваемыми вопросами, прежде чем обращаться в поддержку. Обратитесь к поддержке dbt Cloud для получения дополнительной информации.