Рекомендации по проекту
Catalog предоставляет рекомендации по вашему проекту из пакета dbt_project_evaluator, используя метаданные из Discovery API.
- Catalog также предоставляет общее представление всех рекомендаций по проекту, позволяя легко сортировать и обобщать их.
- Эти рекомендации помогают понять, как улучшить документацию, тестирование и структуру проекта dbt, чтобы повысить доверие к нему и уменьшить путаницу.
- Для удобства и единообразия рекомендации используют предопределённые настройки
dbt_project_evaluatorи не учитывают пользовательские настройки вашего пакета или проекта.
Обучение по запросу
Если вам нравятся видеокурсы, ознакомьтесь с нашим курсом по dbt Catalog, доступным по запросу, и узнайте, как наиболее эффективно исследовать свои проекты dbt!
Страница рекомендаций
Обзорная страница рекомендаций включает два основных показателя, измеряющих покрытие тестами и документацией моделей в вашем проекте.
- Покрытие моделей тестами — Процент моделей в вашем проекте (модели, не входящие в пакеты и не импортированные через Mesh), для которых настроен хотя бы один dbt‑тест.
- Покрытие моделей документацией — Процент моделей в вашем проекте (модели, не входящие в пакеты и не импортированные через Mesh), у которых есть описание.
Пример обзорной страницы рекомендаций с метриками проекта и рекомендациями для всех ресурсов в проектеСписок правил
Следующая таблица перечисляет правила, которые в настоящее время определены в пакете dbt_project_evaluator package.
| Категория | Название | Описание | Ссылка на документацию пакета |
|---|---|---|---|
| Моделирование | Прямое соединение с источником | Модель, которая соединяет как модель, так и источник, указывая на отсутствие промежуточной модели | GitHub |
| Моделирование | Дублирующие источники | Более одного узла источника соответствует одной и той же связи в хранилище данных | GitHub |
| Моделирование | Несколько соединенных источников | Модели с более чем одним родительским источником, указывающие на отсутствие промежуточных моделей | GitHub |
| Моделирование | Корневая модель | Модели без родителей, указывающие на потенциальные жестко закодированные ссылки и необходимость в источниках | GitHub |
| Моделирование | Разветвление источника | Источники с более чем одним дочерним элементом модели, указывающие на необходимость в промежуточных моделях | GitHub |
| Моделирование | Неиспользуемый источник | Источники, которые не ссылаются ни на один ресурс | GitHub |
| Производительность | Экспозиция, зависящая от представления | Экспозиции с хотя бы одним родительским элементом модели, материализованным как представление, указывающие на потенциальные проблемы с производительностью запросов | GitHub |
| Тестирование | Отсутствие теста на первичный ключ | Модели с недостаточным тестированием на уровне зерна модели. | GitHub |
| Документация | Недокументированные модели | Модели без описания на уровне модели | GitHub |
| Документация | Недокументированный источник | Источники (коллекции исходных таблиц) без описаний | GitHub |
| Документация | Недокументированные исходные таблицы | Исходные таблицы без описаний | GitHub |
| Управление | Публичная модель без контракта | Модели с публичным доступом, которые не имеют контракта модели для обеспечения типов данных | GitHub |
Вкладка рекомендаций
Модели, источники и exposures также имеют вкладку Recommendations на странице с деталями ресурса. На этой вкладке отображаются рекомендации, которые относятся именно к данному ресурсу:
Нашли ошибку?
0
