Ускорьте работу с документацией: Генерация документации для целых папок сразу
· 9 мин. чтения
В Lunar большинство наших dbt моделей берут данные из событийно-ориентированной архитектуры. Например, у нас есть следующие модели для папки activity_based_interest в нашем слое загрузки:
activity_based_interest_activated.sqlactivity_based_interest_deactivated.sqlactivity_based_interest_updated.sqldowngrade_interest_level_for_user.sqlset_inactive_interest_rate_after_july_1st_in_bec_for_user.sqlset_inactive_interest_rate_from_july_1st_in_bec_for_user.sqlset_interest_levels_from_june_1st_in_bec_for_user.sql
Это приводит к тому, что многие одинаковые колонки (например, account_id) существуют в разных моделях, в разных слоях. Это означает, что я в итоге:
- Пишу/копирую одну и ту же документацию снова и снова
- На полпути понимаю, что могу улучшить формулировку, чтобы сделать ее более понятной, и возвращаюсь, чтобы обновить файлы
.yml, которые уже сделал - Понимаю, что сделал синтаксическую ошибку в своем файле
.yml, поэтому возвращаюсь и исправляю ее - Понимаю, что колонки определены по-разному с использованием разных формулировок в других папках нашего проекта dbt
- Переосмысливаю свой выбор карьеры и молюсь, чтобы большая языковая модель украла мою работу
- Задумываюсь, есть ли лучший способ генерировать документацию, используемую в разных моделях
