Получение помощи

Помощь сообщества

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 для получения дополнительной информации.