# Поиск данных в Catalog

Платформа dbt | Starter, Enterprise, Enterprise+

С помощью Catalog вы можете просматривать [ресурсы](https://docs.getdbt.tech/docs/build/projects.md) своего проекта (например, модели, тесты и метрики), их происхождение и связи, а также [использование моделей](https://docs.getdbt.tech/docs/explore/view-downstream-exposures.md), чтобы лучше понимать актуальное состояние проекта в продакшене.

Используйте Catalog для навигации по проектам и управления ими в dbt, чтобы вам и другим разработчикам данных, аналитикам и потребителям данных было проще находить и использовать ресурсы dbt. Catalog интегрируется с [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md), [dbt Insights](https://docs.getdbt.tech/docs/explore/dbt-insights.md), [Orchestrator](https://docs.getdbt.tech/docs/deploy/deployments.md) и [Canvas](https://docs.getdbt.tech/docs/platform/canvas.md), помогая вам разрабатывать или просматривать ресурсы dbt.

## Предварительные требования

* У вас есть учетная запись dbt на [тарифе Starter, Enterprise или Enterprise+](https://www.getdbt.com/pricing/).
* Вы настроили среду развертывания [production](https://docs.getdbt.tech/docs/deploy/deploy-environments.md#set-as-production-environment) или [staging](https://docs.getdbt.tech/docs/deploy/deploy-environments.md#create-a-staging-environment) для каждого проекта, который хотите исследовать.
* В среде развертывания есть хотя бы один успешный запуск задания. Обратите внимание, что [задания CI](https://docs.getdbt.tech/docs/deploy/ci-jobs.md) не обновляют Catalog.
* Вы находитесь на странице Catalog. Чтобы перейти на нее, выберите **Catalog** в меню верхнего уровня в dbt.

## Генерация метаданных

Catalog использует метаданные, предоставляемые [Discovery API](https://docs.getdbt.tech/docs/dbt-apis/discovery-api.md), для отображения подробной информации о [состоянии вашего проекта dbt](https://docs.getdbt.tech/docs/dbt-apis/project-state.md). Доступные метаданные зависят от [среды развертывания](https://docs.getdbt.tech/docs/deploy/deploy-environments.md), которую вы обозначили как *production* или *staging* в своем проекте dbt.

## Метаданные dbt

Если вы используете [гибридную конфигурацию проекта](https://docs.getdbt.tech/docs/deploy/hybrid-setup.md) и загружаете артефакты из dbt v1, обязательно следуйте [инструкциям по настройке](https://docs.getdbt.tech/docs/deploy/hybrid-setup.md#create-hybrid-project), чтобы подключить свой проект в dbt. Это позволит Catalog корректно получать и отображать ваши метаданные.

* (Версии dbt: v2.0 и новее) Чтобы все метаданные были доступны в Catalog, выполняйте `dbt build` в рамках задания в среде production или staging. Задания, использующие v2, автоматически обновляют метаданные каталога при каждом запуске, поэтому шаг `dbt docs generate` не требуется.
* Catalog автоматически получает обновления метаданных после каждого запуска задания в среде развертывания production или staging, поэтому в нем всегда доступны актуальные результаты для вашего проекта. Это относится и к заданиям развертывания и слияния.
  * Обратите внимание, что задания CI не обновляют Catalog. Это связано с тем, что они не отражают состояние production и не предоставляют необходимые обновления метаданных.
* Чтобы просмотреть ресурс и его метаданные, необходимо определить ресурс в проекте и запустить задание в среде production или staging.
* Итоговые метаданные зависят от [команд](https://docs.getdbt.tech/docs/deploy/job-commands.md), выполняемых заданиями.

### Когда dbt создает метаданные модели

dbt заполняет метаданные модели в Catalog, когда выполняются оба следующих условия:

* Модель определена в вашем проекте dbt (присутствует в манифесте).
* Модель присутствует в `run_results` команды [`dbt build`](https://docs.getdbt.tech/reference/commands/build.md), [`dbt run`](https://docs.getdbt.tech/reference/commands/run.md) или [`dbt clone`](https://docs.getdbt.tech/reference/commands/clone.md), независимо от того, завершилось выполнение успешно или с ошибкой.

### Когда dbt удаляет метаданные модели

dbt удаляет метаданные модели из Catalog в двух случаях:

* **Модель удалена из проекта**: если модель удалена из вашего проекта dbt (и, следовательно, больше не присутствует в манифесте), ее метаданные удаляются после последующего запуска задания, в которое эта модель больше не включена.
* **Отсутствие активности в среде**: если в среде не было запусков заданий за последние 3 месяца, все метаданные этой среды удаляются. Чтобы этого избежать, настройте запуск заданий по расписанию не реже одного раза в 3 месяца.

(Версии dbt: v2.0 и новее)

| Чтобы просмотреть в Catalog                                  | Необходимо успешно выполнить                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Все метаданные                                               | [dbt build](https://docs.getdbt.tech/reference/commands/build.md) и [dbt source freshness](https://docs.getdbt.tech/reference/commands/source.md#dbt-source-freshness) вместе в рамках одного задания в этой среде                                                                                         |
| Зависимости модели, сведения о ней или результаты выполнения | [dbt run](https://docs.getdbt.tech/reference/commands/run.md) или [dbt build](https://docs.getdbt.tech/reference/commands/build.md) для конкретной модели в рамках задания в этой среде                                                                                                                    |
| Столбцы и статистику для моделей, источников и снимков       | Любое [задание](https://docs.getdbt.tech/docs/explore/build-and-view-your-docs.md) в этой среде. Задания, использующие v2, автоматически обновляют метаданные каталога.                                                                                                                                     |
| Результаты тестов данных                                     | [dbt test](https://docs.getdbt.tech/reference/commands/test.md) или [dbt build](https://docs.getdbt.tech/reference/commands/build.md) в рамках задания в этой среде                                                                                                                                        |
| Результаты модульных тестов                                  | [dbt test](https://docs.getdbt.tech/reference/commands/test.md) или [dbt build](https://docs.getdbt.tech/reference/commands/build.md) в рамках задания в этой среде. Модульные тесты обычно выполняются в средах разработки или CI, поэтому их результаты редко появляются в Catalog для среды production. |
| Результаты проверки актуальности источников                  | [dbt source freshness](https://docs.getdbt.tech/reference/commands/source.md#dbt-source-freshness) в рамках задания в этой среде                                                                                                                                                                            |
| Сведения о снимках                                           | [dbt snapshot](https://docs.getdbt.tech/reference/commands/snapshot.md) или [dbt build](https://docs.getdbt.tech/reference/commands/build.md) в рамках задания в этой среде                                                                                                                                |
| Сведения о seed                                              | [dbt seed](https://docs.getdbt.tech/reference/commands/seed.md) или [dbt build](https://docs.getdbt.tech/reference/commands/build.md) в рамках задания в этой среде                                                                                                                                        |

подсказка

Если ваша организация работает как с dbt v1, так и с Cloud, вы можете объединить эти рабочие процессы, автоматически загружая артефакты dbt v1 в dbt Cloud и просматривая их в Catalog, чтобы работать с dbt в единой среде. Подробнее см. в разделе [Гибридные проекты](https://docs.getdbt.tech/docs/deploy/hybrid-projects.md).

## Обзор Catalog

[Global navigation](https://docs.getdbt.tech/docs/explore/global-navigation.md) [Starter](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе")[Enterprise](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе")[Enterprise +](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе")

Catalog позволяет расширить поиск, включив в него ресурсы dbt (модели, seeds, snapshots, источники, exposures и другие) из всего вашего аккаунта. Это расширяет результаты поиска и позволяет получить более полное представление обо всех ресурсах ваших проектов dbt. Подробнее см. в разделе [Глобальная навигация](https://docs.getdbt.tech/docs/explore/global-navigation.md) или в нашем [видеообзоре](https://www.loom.com/share/ae93b3d241cd439fbe5f98f5e6872113?).

Используйте обзорную страницу Catalog для доступа к ресурсам и метаданным вашего проекта. Страница содержит следующие разделы:

* **Строка поиска** — [Ищите](#search-resources) ресурсы в проекте по ключевому слову. Вы также можете использовать фильтры для уточнения результатов поиска.
* **Боковая панель** — Используйте нижнюю часть левой боковой панели для просмотра [ресурсов, дерева файлов и базы данных](#browse-with-the-sidebar) вашего проекта. В зависимости от вашего тарифного плана вы также можете просматривать [производительность](https://docs.getdbt.tech/docs/explore/model-performance.md) моделей и [рекомендации по проекту](https://docs.getdbt.tech/docs/explore/project-recommendations.md). Подробнее см. в разделе [Доступность по тарифным планам](#availability-by-plan).
  * Рекомендации по проекту находятся на главной странице вашего проекта.\*
* **Граф зависимостей** — Изучайте [граф зависимостей](#project-lineage) вашего проекта или аккаунта, чтобы визуализировать связи между ресурсами.
* **Последние обновления** — Просматривайте последние изменения или проблемы, связанные с ресурсами вашего проекта, включая последние запуски заданий, изменённые свойства, зависимости и проблемы.
* **Витрины данных и публичные модели** — Просматривайте [витрины данных](https://docs.getdbt.tech/best-practices/how-we-structure/1-guide-overview.md#guide-structure-overview) и [публичные модели](https://docs.getdbt.tech/docs/mesh/govern/model-access.md#access-modifiers) вашего проекта. Из этого представления вы также можете перейти ко всем публичным моделям вашего аккаунта.
* **История запросов к моделям** — Используйте [историю запросов к моделям](https://docs.getdbt.tech/docs/explore/model-query-history.md), чтобы отслеживать запросы, использующие данные ваших моделей, и получать более глубокое представление об их использовании.
* **Визуализация зависимых exposures** — [Настройте](https://docs.getdbt.tech/docs/platform-integrations/downstream-exposures-tableau.md) и [визуализируйте зависимые exposures](https://docs.getdbt.tech/docs/explore/view-downstream-exposures.md), чтобы автоматически отображать соответствующие модели данных из Tableau и улучшать их обозримость.
* **Индикаторы состояния данных** — Просматривайте [индикаторы состояния данных](https://docs.getdbt.tech/docs/explore/data-health-signals.md) для каждого ресурса, чтобы оценивать его состояние и производительность.

### Права доступа к каталогу

При использовании глобальной навигации и поиске по всем проектам действуют следующие правила доступа:

* Ваши права доступа к проектам определяют, какие проекты dbt отображаются в левом меню глобальной навигации.
* При поиске в Catalog используются мягкие ограничения доступа: в результатах поиска вы увидите все соответствующие запросу ресурсы с явными индикаторами для тех, к которым у вас нет доступа.

### Доступность по тарифным планам

Catalog доступен во всех тарифных планах Starter, Enterprise и Enterprise+. Однако некоторые функции доступны только в тарифных планах Enterprise и Enterprise+:

| Функция                                                                                                      | Starter | Enterprise | Enterprise+ |
| ------------------------------------------------------------------------------------------------------------ | ------- | ---------- | ----------- |
| Просмотр графа зависимостей и ресурсов dbt                                                                   | ✅      | ✅         | ✅          |
| [Глобальная навигация](https://docs.getdbt.tech/docs/explore/global-navigation.md)                          | ✅      | ✅         | ✅          |
| [Сигналы о состоянии данных](https://docs.getdbt.tech/docs/explore/data-health-signals.md)                  | ✅      | ✅         | ✅          |
| [Производительность моделей](https://docs.getdbt.tech/docs/explore/model-performance.md)                    | ❌      | ✅         | ✅          |
| [Рекомендации по проекту](https://docs.getdbt.tech/docs/explore/project-recommendations.md)                 | ❌      | ✅         | ✅          |
| [Граф зависимостей на уровне столбцов](https://docs.getdbt.tech/docs/explore/column-level-lineage.md)       | ❌      | ✅         | ✅          |
| [Граф зависимостей нескольких проектов](https://docs.getdbt.tech/docs/explore/explore-multiple-projects.md) | ❌      | ✅         | ✅          |
| [История запросов к моделям](https://docs.getdbt.tech/docs/explore/model-query-history.md)                  | ❌      | ✅         | ✅          |
| [Зависимые exposures](https://docs.getdbt.tech/docs/explore/view-downstream-exposures.md)                   | ❌      | ✅         | ✅          |
| [Плитка состояния данных](https://docs.getdbt.tech/docs/explore/data-tile.md)                               | ❌      | ✅         | ✅          |

Эта таблица относится только к Catalog. Подробнее о том, как использовать граф зависимостей на уровне столбцов локально, см. в разделе [Граф зависимостей на уровне столбцов](https://docs.getdbt.tech/docs/explore/column-level-lineage.md).

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

Если вам нравятся видеокурсы, ознакомьтесь с нашим [курсом по dbt Catalog, доступным по запросу](https://learn.getdbt.com/courses/dbt-catalog), и узнайте, как наиболее эффективно исследовать свои проекты dbt!

## Изучение графа lineage проекта

Catalog предоставляет интерактивную визуализацию DAG вашего проекта. Чтобы открыть полный граф происхождения данных проекта, выберите **Overview** на левой боковой панели и нажмите кнопку **Explore Lineage** в основной (центральной) части страницы.

Если граф lineage проекта не отображается сразу, нажмите **Render Lineage**. В зависимости от размера проекта и объёма доступной оперативной памяти на вашем компьютере отрисовка графа может занять некоторое время. Для очень крупных проектов граф может не отрисоваться полностью — в этом случае можно выбрать подмножество узлов с помощью селекторов.

Узлы в графе lineage представляют ресурсы проекта, а рёбра — связи между этими узлами. Узлы имеют цветовую кодировку и иконки в соответствии с типом ресурса.

По умолчанию Catalog показывает граф зависимостей проекта в его [применённом состоянии](https://docs.getdbt.tech/docs/dbt-apis/project-state.md#definition-logical-vs-applied-state-of-dbt-nodes). То есть он показывает модели, которые были успешно построены и доступны для запросов, а не просто модели, определённые в проекте.

Чтобы изучить графы зависимостей тестов и макросов, откройте [страницы с подробной информацией об этих ресурсах](#view-resource-details). По умолчанию Catalog исключает эти ресурсы из полного графа зависимостей, если только они не попадают в результаты поискового запроса.

 Как я могу взаимодействовать с полным графом происхождения?

* Наведите указатель на любой элемент графа, чтобы увидеть название и тип ресурса.

* Увеличивайте и уменьшайте масштаб графа с помощью колеса мыши.

* Захватывайте и перемещайте граф и его узлы.

* Щёлкните правой кнопкой мыши по узлу, чтобы открыть контекстное меню и:

  * Переключить фокус на узел, включая его вышестоящие и нижестоящие узлы
  * Переключить фокус только на узел и его нижестоящие узлы
  * Переключить фокус только на узел и его вышестоящие узлы
  * Открыть страницу [сведений о ресурсе](#view-resource-details) для этого узла

* Выберите ресурс, чтобы выделить его связи с другими ресурсами в проекте. Справа от графа откроется панель с краткими сведениями о ресурсе. На боковой панели есть вкладка **General** с такой информацией, как описание, тип материализации и другие сведения. В правом верхнем углу боковой панели:

  * Нажмите значок View Resource, чтобы [просмотреть сведения о ресурсе](#view-resource-details).
  * Нажмите значок [Open in IDE](#open-in-ide), чтобы изучить ресурс в [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md).
  * Нажмите значок Copy Link to Page, чтобы скопировать ссылку на страницу в буфер обмена.

* Используйте [селекторы](https://docs.getdbt.tech/reference/node-selection/methods.md) (в строке поиска), чтобы выбрать конкретные ресурсы или подмножество DAG. Это поможет сосредоточиться на интересующих вас ресурсах. Доступны все селекторы, кроме тех, которым требуется сравнение состояний (result, source status и state). Также можно использовать флаги `--exclude` и `--select` (последний необязателен). Примеры:

  * `resource_type:model [RESOURCE_NAME]` — Возвращает все модели, соответствующие поисковому запросу по имени
  * `resource_type:metric,tag:nightly` — Возвращает метрики с тегом `nightly`

* Используйте [операторы графа](https://docs.getdbt.tech/reference/node-selection/graph-operators.md) (в строке поиска), чтобы выбрать конкретные ресурсы или подмножество DAG. Это поможет сосредоточиться на интересующих вас ресурсах. Примеры:

  * `+orders` — Возвращает все вышестоящие узлы для `orders`
  * `+dim_customers,resource_type:source` — Возвращает все источники, расположенные выше `dim_customers` по графу зависимостей

* Используйте [операторы множеств](https://docs.getdbt.tech/reference/node-selection/set-operators.md) (в строке поиска), чтобы выбрать конкретные ресурсы или подмножество DAG. Это поможет сосредоточиться на интересующих вас ресурсах. Например:

  * `+snowplow_sessions +fct_orders` — Используйте аргументы, разделённые пробелами, для операции объединения. Возвращает ресурсы, которые являются вышестоящими узлами для `snowplow_sessions` или `fct_orders`.

* [Просмотрите сведения о ресурсе](#view-resource-details), выбрав узел в графе двойным щелчком мыши.

* Нажмите **Lenses** (в правом нижнем углу графа), чтобы использовать функцию [линз](#lenses) в Catalog.

### Пример полного графа происхождения

Чтобы изучить модель на графе происхождения данных вашего проекта в Catalog:

1. Выберите свой проект на левой боковой панели.
2. Нажмите кнопку **View lineage**.
3. Нажмите на модель, чтобы просмотреть её описание.

[![Пример полного графа происхождения](/img/docs/collaborate/dbt-explorer/example-project-lineage-graph.png?v=2 "Пример полного графа происхождения")](#)Пример полного графа происхождения

## Линзы

Функция **Lenses** доступна в [графе линейности вашего проекта](#project-lineage) (правый нижний угол). Lenses можно сравнить со слоями на карте для вашего DAG. Они упрощают понимание контекстных метаданных проекта в большом масштабе, особенно когда нужно выделить конкретную модель или подмножество моделей.

Когда вы применяете линзу, теги становятся видимыми на узлах в графе происхождения, указывая значение слоя вместе с окраской на основе этого значения. Если вы значительно уменьшили масштаб, в графе видны только теги и их цвета.

Линзы полезны для анализа подмножества DAG, если вы увеличили масштаб, или для поиска моделей/проблем с более высокой точки зрения.

 Список доступных линз

Ресурс в вашем проекте характеризуется типом ресурса, типом материализации или слоем модели, а также его последним запуском или последним статусом теста. Линзы доступны для следующих метаданных:

* **Resource type**: Организует ресурсы по типу ресурса, например: models, tests, seeds, saved query и [другие](https://docs.getdbt.tech/docs/build/projects.md). Для типа ресурса используется селектор `resource_type`.

* **Materialization type**: Определяет стратегию построения моделей dbt в вашей платформе данных.

* **Latest status**: Статус последнего выполнения ресурса в текущем окружении. Например, используется для диагностики упавшего участка DAG.

* **Model layer**: Слой моделирования, к которому относится модель согласно [руководству по лучшим практикам](https://docs.getdbt.tech/best-practices/how-we-structure/1-guide-overview.md#guide-structure-overview). Например, для поиска моделей marts для анализа.

  * **Marts** — Модель с префиксом `fct_` или `dim_`, либо модель, находящаяся в подкаталоге `/marts/`.
  * **Intermediate** — Модель с префиксом `int_` или модель, находящаяся в подкаталоге `/int/` или `/intermediate/`.
  * **Staging** — Модель с префиксом `stg_` или модель, находящаяся в подкаталоге `/staging/`.

* **Test status**: Статус последнего выполнения тестов, запущенных для данного ресурса. Если у модели есть несколько тестов с разными результатами, линза отображает статус по принципу «наихудшего случая».

* **Consumption query history**: Количество запросов к данному ресурсу за заданный период времени.

### Пример линз

Пример применения *линзы* **Materialization type** к графу происхождения данных в уменьшенном масштабе. В левом нижнем углу откройте **Lenses** и выберите **Materialization type**. На каждом узле отображается цветной значок соответствующего типа материализации:

* Table
* View
* Incremental
* Ephemeral
* Materialized View.

[![Пример линзы «Тип материализации»](/img/docs/collaborate/dbt-explorer/example-materialization-type.png?v=2 "Пример линзы «Тип материализации»")](#)Пример линзы «Тип материализации»

Пример применения *линзы* **Test status** к графу происхождения данных, отфильтрованному по моделям. В левом нижнем углу откройте **Lenses** и выберите **Test status**. На каждом узле отображается цветной значок последнего статуса тестирования:

* Pass
* Error
* Fail
* Warn
* Skipped
* Reused.

[![Пример линзы «Статус тестирования»](/img/docs/collaborate/dbt-explorer/example-test-status.png?v=2 "Пример линзы «Статус тестирования»")](#)Пример линзы «Статус тестирования»

## Поиск по ключевым словам

В Catalog глобальная навигация предоставляет возможность поиска ресурсов dbt во всех ваших проектах, а также ресурсов в Snowflake, не относящихся к dbt.

Вы можете находить ресурсы в своем проекте, выполняя поиск по ключевым словам в строке поиска. Все имена ресурсов, имена колонок, описания ресурсов, связи с warehouse, а также код, соответствующие вашим критериям поиска, будут отображены списком в основной (центральной) части страницы. При поиске по точному имени колонки результаты показывают все реляционные узлы, содержащие эту колонку в своих схемах. Если найдено совпадение, в результате поиска отображается уведомление о том, что ресурс содержит указанную колонку. Кроме того, вы можете применять фильтры, чтобы дополнительно уточнить результаты поиска.

 Функции поиска

* **Поиск по части ключевого слова** — Также называется нечётким поиском. Catalog использует логику «содержит» для улучшения результатов поиска. Это означает, что вы можете искать по части слова, не зная точной основы искомого слова.
* **Исключение ключевых слов** — Добавьте знак минус (-) перед ключевым словом, которое нужно исключить из результатов поиска. Например, `-user` исключит из результатов поиска все совпадения с этим ключевым словом.
* **Логические операторы** — Используйте логические операторы для расширения возможностей поиска по ключевым словам. Например, результаты поиска по запросу `users OR github` будут включать совпадения с любым из этих ключевых слов.
* **Поиск по фразе** — Заключите последовательность ключевых слов в двойные кавычки, чтобы найти именно эту фразу (например, `"stg users"`). Подробнее см. в статье [Поиск по фразе](https://en.wikipedia.org/wiki/Phrase_search) в Википедии.
* **Поиск по ключевым словам SQL** — Используйте ключевые слова SQL в поисковом запросе. Например, результаты поиска по запросу `int github users joined` будут включать совпадения, содержащие именно эту последовательность ключевых слов (аналогично поиску по фразе).

 Боковая панель фильтров

Боковая панель **Фильтры** становится доступна после выполнения поиска по ключевым словам. Используйте эту панель, чтобы дополнительно уточнить результаты поиска по ключевым словам. По умолчанию Catalog выполняет поиск по всем ресурсам проекта. Вы можете фильтровать результаты по следующим критериям:

* [Тип ресурса](https://docs.getdbt.tech/docs/build/projects.md) (например, models, sources и т.д.)
* [Уровень доступа модели](https://docs.getdbt.tech/docs/mesh/govern/model-access.md) (например, public, private)
* [Слой модели](https://docs.getdbt.tech/best-practices/how-we-structure/1-guide-overview.md) (например, marts, staging)
* [Материализация модели](https://docs.getdbt.tech/docs/build/materializations.md) (например, view, table)
* [Tags](https://docs.getdbt.tech/reference/resource-configs/tags.md) (поддерживается множественный выбор)

В разделе **Models** вы можете фильтровать по свойствам модели (access или тип materialization). Также доступны **Advanced**‑параметры, где можно ограничить результаты поиска по имени колонки, коду модели и другим критериям.

 Global navigation

Catalog развивает возможности прежней навигации и предлагает новые функции, которые делают работу удобнее. Подробнее см. в разделе [Глобальная навигация](https://docs.getdbt.tech/docs/explore/global-navigation.md).

### Пример поиска по ключевому слову

Пример результатов поиска по ключевому слову `customers` с применением фильтров models, description и code. [Сигналы качества данных](https://docs.getdbt.tech/docs/explore/data-health-signals.md) отображаются справа от имени модели в результатах поиска.

## Обзор через боковую панель

С помощью боковой панели вы можете просматривать ресурсы проекта, его дерево файлов и базу данных.

* Вкладка **Ресурсы** — Все ресурсы проекта, сгруппированные по типу. Выберите любой тип ресурсов в списке, и все ресурсы этого типа в проекте отобразятся в виде таблицы в основной области страницы. Описание различных типов ресурсов (например, моделей, метрик и т. д.) см. в разделе [О проектах dbt](https://docs.getdbt.tech/docs/build/projects.md).
  * [Индикаторы состояния данных](https://docs.getdbt.tech/docs/explore/data-health-signals.md) отображаются справа от имени ресурса в столбце **Состояние**.
* Вкладка **Дерево файлов** — Все ресурсы проекта, сгруппированные по файлам, в которых они определены. Эта структура повторяет дерево файлов в репозитории вашего проекта dbt.
* Вкладка **База данных** — Все ресурсы проекта, сгруппированные по базам данных и схемам, в которых они созданы. Эта структура повторяет структуру вашей платформы данных, которая отражает [применённое состояние](https://docs.getdbt.tech/docs/dbt-apis/project-state.md) вашего проекта.

## Доступ к интегрированным инструментам

Пользователи с [лицензией разработчика](https://docs.getdbt.tech/docs/platform/manage-access/about-user-access.md#role-based-access-control-) или рабочим местом аналитика\* могут открыть ресурс непосредственно из Catalog в Studio IDE для просмотра файлов его модели, в Insights для выполнения запросов к нему или в Canvas для визуального редактирования.

\* [Лицензия типа Analyst](https://docs.getdbt.tech/docs/platform/manage-access/about-user-access.md?version=1.12#licenses) больше не доступна для приобретения.

## Просмотр версий моделей

Если модели в проекте версионируются, вы можете увидеть, какая [версия модели](https://docs.getdbt.tech/docs/mesh/govern/model-versions.md) применяется — `prerelease`, `latest` и `old` — в заголовке страницы деталей модели и в списке моделей в боковой панели.

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

Вы можете просмотреть определение и результаты последнего запуска любого ресурса в вашем проекте. Чтобы найти ресурс и просмотреть сведения о нём, воспользуйтесь графом зависимостей, поиском или просмотрите Catalog.

Доступные вам сведения (метаданные) зависят от типа ресурса, его определения и [команд](https://docs.getdbt.tech/docs/deploy/job-commands.md), которые выполняются в заданиях в production-окружении.

В правом верхнем углу страницы сведений о ресурсе вы можете:

[]()

* Нажать значок [Открыть в Studio IDE](#open-in-ide), чтобы изучить ресурс в [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md).
* Нажать значок «Поделиться», чтобы скопировать ссылку на страницу в буфер обмена.

 Какие сведения доступны для модели?

* **Индикаторы состояния данных** — [Индикаторы состояния данных](https://docs.getdbt.tech/docs/explore/data-health-signals.md) позволяют быстро оценить состояние данных. Эти значки показывают, находится ли модель в состоянии «Исправна», «Требует внимания», «Ухудшено» или «Неизвестно». Наведите указатель на значок, чтобы просмотреть подробную информацию о состоянии модели.

* **Строка состояния** (под заголовком страницы) — Информация о времени последнего запуска модели, его успешности, способе материализации данных, количестве строк и размере модели.

* Вкладка **Общие сведения** включает:

  * Граф **Зависимости** — Интерактивный граф зависимостей модели. Граф включает один вышестоящий и один нижестоящий узел относительно модели. Нажмите значок разворачивания в правом верхнем углу графа, чтобы просмотреть модель в режиме полного графа зависимостей.
  * Раздел **Описание** — [Описание модели](https://docs.getdbt.tech/docs/build/documentation.md#adding-descriptions-to-your-project).
  * Раздел **Последний запуск** — Информация о времени последнего запуска модели, его продолжительности и успешности, идентификаторе задания и идентификаторе запуска.
  * Раздел **Тесты** — [Тесты данных](https://docs.getdbt.tech/docs/build/data-tests.md) для модели, включая индикатор статуса последнего выполнения теста. Значок ✅ обозначает успешно пройденный тест.
  * Раздел **Сведения** — Основные свойства, такие как имя отношения модели (например, как она представлена и как к ней можно обращаться с запросами на платформе данных: `database.schema.identifier`); атрибуты управления моделью, такие как уровень доступа, группа и наличие контракта; и многое другое.
  * Раздел **Связи** — Узлы, от которых модель **Зависит**, которые **Ссылаются на неё** и (если применимо) в которых она **Используется** в проектах, объявивших проект этой модели своей зависимостью.

* Вкладка **Код** — Исходный и скомпилированный код модели.

* Вкладка **Столбцы** — Доступные столбцы модели, включая [теги](https://docs.getdbt.tech/reference/resource-configs/tags.md), заданные для столбцов в YAML-файлах dbt. Теги столбцов отображаются в виде интерактивных меток, при нажатии на которые представление зависимостей фильтруется по выбранному тегу. На этой вкладке также отображаются результаты тестов (если они есть), которые можно выбрать для перехода на страницу подробных сведений о тесте. Значок ✅ обозначает успешно пройденный тест. Чтобы отфильтровать столбцы ресурса (в том числе по имени тега), используйте строку поиска в верхней части представления столбцов.

 Какие сведения доступны для exposure?

* **Status bar** (под заголовком страницы) — Информация о том, когда exposure последний раз обновлялся.

* **Data health signals** — [Сигналы качества данных](https://docs.getdbt.tech/docs/explore/data-health-signals.md) дают быстрый обзор состояния данных. Эти значки показывают, находится ли ресурс в состоянии Healthy, Caution или Degraded. Наведите курсор на значок, чтобы увидеть подробную информацию о состоянии exposure.

* Вкладка **General** включает:

  * **Data health** — Статус свежести данных и качества данных.
  * Раздел **Status** — Статус свежести данных и качества данных.
  * Граф **Lineage** — Граф lineage для exposure. Нажмите значок **Expand** в правом верхнем углу графа, чтобы открыть exposure в режиме полноэкранного (full) lineage-графа. Нативно интегрируется с Tableau и автоматически генерирует downstream-lineage.
  * Раздел **Description** — Описание exposure.
  * Раздел **Details** — Детали, такие как тип exposure, maturity, информация о владельце и т. д.
  * Раздел **Relationships** — Узлы, от которых exposure **Depends On**.

 Какие сведения доступны для test?

* **Status bar** (под заголовком страницы) — Информация о том, когда тест запускался в последний раз, прошел ли тест, имя теста, цель (target) теста и имя колонки. По умолчанию — все (all), если не указано иное.
* **Test Type** (рядом со Status bar) — Информация о доступных типах тестов: Unit test или Data test. По умолчанию — все (all), если не указано иное.

Когда вы выбираете тест, доступны следующие сведения:

* Вкладка **General** включает:

  * Граф **Lineage** — Интерактивный граф lineage для теста. Граф включает один upstream-узел и один downstream-узел относительно ресурса теста. Нажмите значок Expand в правом верхнем углу графа, чтобы открыть тест в режиме полноэкранного (full) lineage-графа.
  * Раздел **Description** — Описание теста.
  * Раздел **Recent** — Информация о последнем запуске теста: как долго он выполнялся, прошел ли он, ID задания (job ID) и ID запуска (run ID).
  * Раздел **Details** — Детали, такие как схема (schema), серьезность (severity), пакет (package) и т. д.
  * Раздел **Relationships** — Узлы, от которых тест **Depends On**.

* Вкладка **Code** — Исходный код и скомпилированный код теста.

Пример представления Tests:

 Какие детали доступны для каждой таблицы источников в коллекции источников?

* **Строка состояния** (под заголовком страницы) — Информация о времени последнего обновления источника и количестве используемых им таблиц.

* **Индикаторы состояния данных** — [Индикаторы состояния данных](https://docs.getdbt.tech/docs/explore/data-health-signals.md) позволяют быстро оценить состояние данных. Эти значки показывают, находится ли ресурс в состоянии «Исправен» (Healthy), «Требует внимания» (Caution) или «Ухудшено» (Degraded). Наведите указатель на значок, чтобы просмотреть подробную информацию о состоянии источника.

* Вкладка **Общие сведения** включает:

  * Граф **Происхождение данных** — Интерактивный граф происхождения данных источника. Граф включает один вышестоящий и один нижестоящий узел относительно источника. Нажмите значок разворачивания в правом верхнем углу графа, чтобы просмотреть источник в режиме полного графа происхождения данных.
  * Раздел **Описание** — Описание источника.
  * Раздел **Актуальность источника** — Информация об успешности обновления данных, времени последней загрузки источника, временной метке создания данных при запуске и идентификаторе запуска.
  * Раздел **Подробности** — Сведения о базе данных, схеме и другие подробности.
  * Раздел **Связи** — Таблица со списком всех используемых источников, их статусом актуальности, временной меткой последней проверки актуальности и временной меткой последней загрузки источника.

* Вкладка **Столбцы** — Доступные столбцы источника, включая [теги](https://docs.getdbt.tech/reference/resource-configs/tags.md), заданные для столбцов в YAML-файлах dbt. Теги столбцов отображаются в виде интерактивных меток, при нажатии на которые представление происхождения данных фильтруется по выбранному тегу. На этой вкладке также отображаются результаты тестов (если они есть), которые можно выбрать, чтобы открыть страницу с подробностями теста. Значок ✅ обозначает успешно пройденный тест.

### Пример деталей модели

Чтобы открыть страницу модели в Catalog:

1. Выберите проект в боковой панели.
2. Нажмите **Models**.
3. В разделе **Models** выберите модель, например `customers`.

На вкладке **General** можно посмотреть описание, последний статус и граф зависимостей. Нажмите **Full Lineage**, чтобы открыть полный граф.

[![Пример сведений о ресурсе](/img/docs/collaborate/dbt-explorer/example-model-details.png?v=2 "Пример сведений о ресурсе")](#)Пример сведений о ресурсе

[![Пример сведений о нижестоящей экспозиции для Tableau.](/img/docs/platform-integrations/auto-exposures/explorer-lineage2.png?v=2 "Пример сведений о нижестоящей экспозиции для Tableau.")](#)Пример сведений о нижестоящей экспозиции для Tableau.

## Стейджинговая среда

dbt Explorer поддерживает представления для [стейджинговых сред развертывания](https://docs.getdbt.tech/docs/deploy/deploy-environments.md#staging-environment), в дополнение к производственной среде. Это дает вам уникальный взгляд на ваши пред-производственные рабочие процессы данных с теми же инструментами, доступными в производстве, обеспечивая дополнительный уровень проверки.

Catalog поддерживает просмотр [сред развёртывания staging](https://docs.getdbt.tech/docs/deploy/deploy-environments.md#staging-environment) в дополнение к среде production. Это даёт вам уникальную возможность изучать рабочие процессы обработки данных перед их запуском в production, используя те же инструменты, что и в production, и обеспечивая дополнительный уровень проверки.

Вы можете изучать метаданные среды production или staging, чтобы принимать обоснованные решения на протяжении жизненного цикла разработки данных. Просто [назначьте одну среду](https://docs.getdbt.tech/docs/deploy/deploy-environments.md) в каждом проекте dbt как "production" или "staging" и убедитесь, что необходимые метаданные сгенерированы, — после этого вы сможете просматривать их в Catalog. Подробнее см. в разделе [Генерация метаданных](https://docs.getdbt.tech/docs/explore/explore-projects.md#generate-metadata).

## Связанные материалы

* [Разрешения Enterprise](https://docs.getdbt.tech/docs/platform/manage-access/enterprise-permissions.md)
* [Об управлении моделями](https://docs.getdbt.tech/docs/mesh/govern/about-model-governance.md)
* Статья в блоге [Что такое data mesh?](https://www.getdbt.com/blog/what-is-data-mesh-the-definition-and-importance-of-data-mesh)
