# group

### Модели

dbt\_project.yml

```yml
models:

  <resource-path>:
    +group: GROUP_NAME
```

models/schema.yml

```yml

models:
  - name: MODEL_NAME
    config:
      group: GROUP # changed to config in v1.10
```

models/\<modelname>.sql

```sql

{{ config(
  group='GROUP_NAME'
) }}

select ...
```

### Семена

dbt\_project.yml

```yml
models:
  <resource-path>:
    +group: GROUP_NAME
```

seeds/properties.yml

```yml
seeds:
  - name: [SEED_NAME]
    config:
      group: GROUP_NAME # changed to config in v1.10
```

### Снимки

dbt\_project.yml

```yml
snapshots:
  <resource-path>:
    +group: GROUP_NAME
```

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

snapshots/properties.yml

```yaml

snapshots:
  - name: snapshot_name
    config:
      group: GROUP_NAME
```

snapshots/\<filename>.sql

```sql
{% snapshot snapshot_name %}

{{ config(
  group='GROUP_NAME'
) }}

select ...

{% endsnapshot %}
```

### Тесты

dbt\_project.yml

```yml
data_tests:
  <resource-path>:
    +group: GROUP_NAME
```

tests/properties.yml

```yml

<resource_type>:
  - name: <resource_name>
    data_tests:
      - <test_name>:
          config:
            group: GROUP_NAME
```

tests/\<filename>.sql

```sql
{% test <testname>() %}

{{ config(
  group='GROUP_NAME'
) }}

select ...

{% endtest %}
```

tests/\<filename>.sql

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

### Анализы

analyses/\<filename>.yml

```yml

analyses:
  - name: ANALYSIS_NAME
    config:
      group: GROUP_NAME # changed to config in v1.10
```

### Метрики

dbt\_project.yml

```yaml
metrics:
  <resource-path>:
    +group: GROUP_NAME
```

models/metrics.yml

```yaml

metrics:
  - name: [METRIC_NAME]
    config:
      group: GROUP_NAME
```

### Семантические модели

dbt\_project.yml

```yaml
semantic-models:
  <resource-path>:
    +group: GROUP_NAME
```

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

models/file\_name.yml

```yaml
models:
  - name: model_name
    semantic_model:
      enabled: true
      group: group_name
```

### Сохраненные запросы

dbt\_project.yml

```yaml
saved-queries:
  <resource-path>:
    +group: GROUP_NAME
```

models/semantic\_models.yml

```yaml
saved_queries:
  - name: SAVED_QUERY_NAME
    config:
      group: GROUP_NAME
```

Обратите внимание, что для обратной совместимости `group` поддерживается как ключ верхнего уровня, но без возможностей наследования конфигурации.

## Определение

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

Подробнее о доступе к ссылкам между ресурсами в группах см. раздел [model access](https://docs.getdbt.tech/docs/mesh/govern/model-access.md#groups).

## Примеры

### Запретить модели группы 'маркетинг' ссылаться на приватную модель группы 'финансы'

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

models/schema.yml

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

models/marketing\_model.sql

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

```shell
$ dbt run -s marketing_model
...
dbt.exceptions.DbtReferenceError: Ошибка разбора
  Узел model.jaffle_shop.marketing_model попытался сослаться на узел model.jaffle_shop.finance_model, 
  что не разрешено, поскольку ссылающийся узел является приватным для группы финансов.
```

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

* [Доступ к моделям](https://docs.getdbt.tech/docs/mesh/govern/model-access.md#groups)
* [Определение групп](https://docs.getdbt.tech/docs/build/groups.md)
