# Добавление групп в ваш DAG

Группа — это коллекция узлов в dbt DAG. Группы имеют названия, и у каждой группы есть `владелец`. Они позволяют организовать целенаправленное сотрудничество внутри и между командами, ограничивая [доступ к приватным](https://docs.getdbt.tech/reference/resource-configs/access.md) моделям.

Члены группы могут включать модели, тесты, seeds, snapshots, анализы и метрики. (Не включены: источники и экспозиции.) Каждый узел может принадлежать только одной группе.

### Объявление группы

Группы определяются в файлах `.yml` внутри ключа `groups:`. В версии 1.10 и выше можно добавить `description` и конфигурацию `meta`, чтобы указать дополнительную информацию о группе.

(Версии dbt: v1.10 и новее)

models/marts/finance/finance.yml

```yaml
groups:
  - name: finance
    description: "All finance-related models owned by the Finance team." # optional
    owner:
      # 'name' or 'email' is required; additional properties will no longer be allowed in a future release
      email: finance@jaffleshop.com
    config:
      meta: # optional
        data_owner: Finance team
        cost_center: finance
        data_classification: sensitive
```

#### Централизованное определение группы

Чтобы централизованно определить группу в вашем проекте, есть два варианта:

* Создать один файл `_groups.yml` в корне директории `models`.

* Создать один файл `_groups.yml` в корне директории `groups`. Для этого варианта также необходимо настроить параметр [`model-paths`](https://docs.getdbt.tech/reference/project-configs/model-paths.md) в файле `dbt_project.yml`:

  ```yml
  model-paths: ["models", "groups"]
  ```

### Свойства группы

При определении группы доступны следующие свойства:

| Свойство      | Обязательность | Описание                                                                                                                                                                                                    |
| ------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`        | Обязательно    | Уникальное имя группы в рамках проекта. Используется для назначения ресурсов с помощью [конфигурации `group`](https://docs.getdbt.tech/reference/resource-configs/group.md).                               |
| `owner`       | Обязательно    | Указывает, кто отвечает за группу. Должно включать `name:` или `email:`.                                                                                                                                    |
| `description` | Необязательно  | Понятное человеку описание назначения группы. Поддерживает markdown и [функцию Jinja `doc`](https://docs.getdbt.tech/reference/dbt-jinja-functions/doc.md). Поддерживается в версии v1.10 и более поздних. |
| `config.meta` | Необязательно  | Словарь произвольных метаданных о группе в формате «ключ/значение». Полезен для хранения такой информации, как центры затрат, категории данных или контактные данные команды.                               |

models/marts/finance/finance.yml

```yaml
groups:
  - name: finance
    description: "All models owned by the Finance team."
    owner:
      email: finance@jaffleshop.com
    config:
      meta:
        data_owner: Finance team
        cost_center: finance
        data_classification: sensitive
```

### Добавление модели в группу

Используйте конфигурацию `group`, чтобы добавить одну или несколько моделей в группу.

### На уровне проекта

dbt\_project.yml

```yml
models:
  marts:
    finance:
      +group: finance
```

### На уровне модели

models/schema.yml

```yml
models:
  - name: model_name
    config:
      group: finance
```

### В файле

models/model\_name.sql

```sql
{{ config(group = 'finance') }}

select ...
```

### Ссылка на модель в группе

По умолчанию все модели в группе имеют модификатор доступа `protected`. Это означает, что они могут быть использованы в качестве ссылки для последующих ресурсов в *любой* группе в том же проекте, используя функцию [`ref`](https://docs.getdbt.tech/reference/dbt-jinja-functions/ref.md). Если свойство `access` сгруппированной модели установлено как `private`, только ресурсы внутри её группы могут ссылаться на неё.

models/schema.yml

```yml
models:
  - name: finance_private_model
    config:
      access: private # changed to config in v1.10
      group: finance

  # в другой группе!
  - name: marketing_model
    config:
      group: marketing
```

models/marketing\_model.sql

```sql
select * from {{ ref('finance_private_model') }}
```

```shell
$ dbt run -s marketing_model
...
dbt.exceptions.DbtReferenceError: Parsing Error
  Node model.jaffle_shop.marketing_model attempted to reference node model.jaffle_shop.finance_private_model, 
  which is not allowed because the referenced node is private to the finance group.
```

## Связанные документы

* [Доступ к моделям](https://docs.getdbt.tech/docs/mesh/govern/model-access.md#groups)
* [Конфигурация групп](https://docs.getdbt.tech/reference/resource-configs/group.md)
* [Выбор групп](https://docs.getdbt.tech/reference/node-selection/methods.md#group)
