# О контекстной переменной graph

Контекстная переменная `graph` содержит информацию об *узлах* в вашем dbt‑проекте. Модели, источники, тесты и снапшоты — все это примеры узлов в dbt‑проектах.

Внимание

dbt активно строит переменную `graph` во время [фазы парсинга](https://docs.getdbt.tech/reference/dbt-jinja-functions/execute.md) при запуске dbt‑проектов, поэтому некоторые свойства контекстной переменной `graph` будут отсутствовать или будут некорректными во время парсинга. Пожалуйста, внимательно ознакомьтесь с информацией ниже, чтобы понять, как эффективно использовать эту переменную.

### Контекстная переменная graph

Контекстная переменная `graph` — это словарь, который сопоставляет идентификаторы узлов (`node id`) со словарными представлениями этих узлов. Упрощенный пример может выглядеть так:

```json
{
  "nodes": {
    "model.my_project.model_name": {
      "unique_id": "model.my_project.model_name",
      "config": {"materialized": "table", "sort": "id"},
      "tags": ["abc", "123"],
      "path": "models/path/to/model_name.sql",
      ...
    },
    ...
  },
  "sources": {
    "source.my_project.snowplow.event": {
      "unique_id": "source.my_project.snowplow.event",
      "database": "analytics",
      "schema": "analytics",
      "tags": ["abc", "123"],
      "path": "models/path/to/schema.yml",
      ...
    },
    ...
  },
  "exposures": {
    "exposure.my_project.traffic_dashboard": {
      "unique_id": "exposure.my_project.traffic_dashboard",
      "type": "dashboard",
      "maturity": "high",
      "path": "models/path/to/schema.yml",
      ...
    },
    ...
  },
  "metrics": {
    "metric.my_project.count_all_events": {
      "unique_id": "metric.my_project.count_all_events",
      "type": "count",
      "path": "models/path/to/schema.yml",
      ...
    },
    ...
  },
  "groups": {
    "group.my_project.finance": {
      "unique_id": "group.my_project.finance",
      "name": "finance",
      "owner": {
        "email": "finance@jaffleshop.com"
      }
      ...
    },
    ...
  }
}
```

Точный контракт для этих узлов моделей и источников в настоящее время не документирован, но в будущем это изменится.

### Доступ к моделям

Записи `model` в словаре `graph` будут неполными или некорректными во время парсинга. Если вы обращаетесь к моделям вашего проекта через переменную `graph`, обязательно используйте флаг [execute](https://docs.getdbt.tech/reference/dbt-jinja-functions/execute.md), чтобы гарантировать, что этот код выполняется только во время выполнения, а не во время парсинга. Не используйте переменную `graph` для построения DAG, так как поведение dbt в этом случае будет неопределенным и, скорее всего, некорректным. Пример использования:

graph-usage.sql

```sql

/*
  Вывод информации обо всех моделях в пакете Snowplow
*/

{% if execute %}
  {% for node in graph.nodes.values()
     | selectattr("resource_type", "equalto", "model")
     | selectattr("package_name", "equalto", "snowplow") %}
  
    {% do log(node.unique_id ~ ", materialized: " ~ node.config.materialized, info=true) %}
  
  {% endfor %}
{% endif %}

/*
  Пример вывода
---------------------------------------------------------------
model.snowplow.snowplow_id_map, materialized: incremental
model.snowplow.snowplow_page_views, materialized: incremental
model.snowplow.snowplow_web_events, materialized: incremental
model.snowplow.snowplow_web_page_context, materialized: table
model.snowplow.snowplow_web_events_scroll_depth, materialized: incremental
model.snowplow.snowplow_web_events_time, materialized: incremental
model.snowplow.snowplow_web_events_internal_fixed, materialized: ephemeral
model.snowplow.snowplow_base_web_page_context, materialized: ephemeral
model.snowplow.snowplow_base_events, materialized: ephemeral
model.snowplow.snowplow_sessions_tmp, materialized: incremental
model.snowplow.snowplow_sessions, materialized: table
*/
```

### Доступ к источникам

Чтобы программно получить доступ к источникам в вашем dbt‑проекте, используйте атрибут `sources` объекта `graph`.

Пример использования:

models/events\_unioned.sql

```sql
/*
  Объединение (union) всех источников Snowplow, определенных в проекте,
  которые начинаются со строки "event_"
*/

{% set sources = [] -%}
{% for node in graph.sources.values() -%}
  {%- if node.name.startswith('event_') and node.source_name == 'snowplow' -%}
    {%- do sources.append(source(node.source_name, node.name)) -%}
  {%- endif -%}
{%- endfor %}

select * from (
  {%- for source in sources %}
    select * from {{ source }} {% if not loop.last %} union all {% endif %}
  {% endfor %}
)

/*
  Пример скомпилированного SQL
---------------------------------------------------------------
select * from (
  select * from raw.snowplow.event_add_to_cart union all
  select * from raw.snowplow.event_remove_from_cart union all
  select * from raw.snowplow.event_checkout
)
*/
```

### Доступ к exposures

Чтобы программно получить доступ к exposures в вашем dbt‑проекте, используйте атрибут `exposures` объекта `graph`.

Пример использования:

models/my\_important\_view\_model.sql

```sql
{# Добавляем SQL‑комментарий со списком всех exposures, на которые влияет эта модель #}

{% set exposures = [] -%}
{% for exposure in graph.exposures.values() -%}
  {%- if model['unique_id'] in exposure.depends_on.nodes -%}
    {%- do exposures.append(exposure) -%}
  {%- endif -%}
{%- endfor %}

-- ПРИВЕТ, администратор базы данных! Перед тем как удалить это представление,
-- пожалуйста, имейте в виду, что это повлияет на:

{% for exposure in exposures %}
--   * {{ exposure.name }} ({{ exposure.type }})
{% endfor %}

/*
  Пример скомпилированного SQL
---------------------------------------------------------------
-- ПРИВЕТ, администратор базы данных! Перед тем как удалить это представление,
-- пожалуйста, имейте в виду, что это повлияет на:

--   * our_metrics (dashboard)
--   * my_sync (application)
*/
```

### Доступ к метрикам

Чтобы программно получить доступ к метрикам в вашем dbt‑проекте, используйте атрибут `metrics` объекта `graph`.

Пример использования:

macros/get\_metric.sql

```sql
{% macro get_metric_sql_for(metric_name) %}

  {% set metrics = graph.metrics.values() %}
  
  {% set metric = (metrics | selectattr('name', 'equalto', metric_name) | list).pop() %}

  /* В другом месте у меня определен макрос get_metric_timeseries_sql,
     который возвращает SQL, необходимый для выполнения временной агрегации вычисления этой метрики */

  {% set metric_sql = get_metric_timeseries_sql(
      relation = metric['model'],
      type = metric['type'],
      expression = metric['sql'],
      ...
  ) %}

  {{ return(metric_sql) }}

{% endmacro %}
```

### Доступ к группам

Чтобы программно получить доступ к группам в вашем dbt‑проекте, используйте атрибут `groups` объекта `graph`.

Пример использования:

macros/get\_group.sql

```sql

{% macro get_group_owner_for(group_name) %}

  {% set groups = graph.groups.values() %}
  
  {% set owner = (groups | selectattr('owner', 'equalto', group_name) | list).pop() %}

  {{ return(owner) }}

{% endmacro %}
```
