Перейти к основному содержимому

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

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 на странице с деталями ресурса. На этой вкладке отображаются рекомендации, которые относятся именно к данному ресурсу:

Пример вкладки RecommendationsПример вкладки Recommendations

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

0
Loading