Рекомендации по проекту EnterpriseEnterprise +

Catalog предоставляет рекомендации по вашему проекту на основе пакета dbt_project_evaluator из package, используя метаданные из Discovery API.

• Catalog также предлагает глобальное представление, показывая все рекомендации по проекту в одном месте для удобной сортировки и обобщения.
• Эти рекомендации дают представление о том, как создать более хорошо документированный, лучше протестированный и более качественно построенный dbt‑проект, повышая доверие и снижая путаницу.
• Для единообразного и согласованного опыта рекомендации используют преднастроенные параметры dbt_project_evaluator и не учитывают кастомизации, применённые в вашем пакете или проекте.

Обучение по запросу

Если вам нравятся видеокурсы, обратите внимание на наш on-demand курс по dbt Catalog и узнайте, как наиболее эффективно изучать ваши проекты dbt!

Страница рекомендаций

Обзорная страница рекомендаций включает два основных показателя, измеряющих покрытие тестами и документацией моделей в вашем проекте.

• Покрытие моделей тестами — Процент моделей в вашем проекте (модели, не входящие в пакеты и не импортированные через Mesh), для которых настроен хотя бы один dbt‑тест.
• Покрытие моделей документацией — Процент моделей в вашем проекте (модели, не входящие в пакеты и не импортированные через Mesh), у которых есть описание.

Пример обзорной страницы рекомендаций с метриками проекта и рекомендациями для всех ресурсов в проекте

Список правил

Следующая таблица перечисляет правила, которые в настоящее время определены в пакете dbt_project_evaluator package.

Категория	Название	Описание	Ссылка на документацию пакета
Моделирование	Прямое соединение с источником	Модель, которая соединяет как модель, так и источник, указывая на отсутствие промежуточной модели	GitHub
Моделирование	Дублирующие источники	Более одного узла источника соответствует одной и той же связи в хранилище данных	GitHub
Моделирование	Несколько соединенных источников	Модели с более чем одним родительским источником, указывающие на отсутствие промежуточных моделей	GitHub
Моделирование	Корневая модель	Модели без родителей, указывающие на потенциальные жестко закодированные ссылки и необходимость в источниках	GitHub
Моделирование	Разветвление источника	Источники с более чем одним дочерним элементом модели, указывающие на необходимость в промежуточных моделях	GitHub
Моделирование	Неиспользуемый источник	Источники, которые не ссылаются ни на один ресурс	GitHub
Производительность	Экспозиция, зависящая от представления	Экспозиции с хотя бы одним родительским элементом модели, материализованным как представление, указывающие на потенциальные проблемы с производительностью запросов	GitHub
Тестирование	Отсутствие теста на первичный ключ	Модели с недостаточным тестированием на уровне зерна модели.	GitHub
Документация	Недокументированные модели	Модели без описания на уровне модели	GitHub
Документация	Недокументированный источник	Источники (коллекции исходных таблиц) без описаний	GitHub
Документация	Недокументированные исходные таблицы	Исходные таблицы без описаний	GitHub
Управление	Публичная модель без контракта	Модели с публичным доступом, которые не имеют контракта модели для обеспечения типов данных	GitHub

Loading table...

Вкладка рекомендаций

Вкладка Recommendations

Модели, источники и exposures также имеют вкладку Recommendations на странице с деталями ресурса. На этой вкладке отображаются рекомендации, которые относятся именно к данному ресурсу:

Example of the Recommendations tab

Нашли ошибку?

Создать GitHub Issue