# meta

### Модели

dbt\_project.yml

```yml
models:
  <resource-path>:
    +meta: {<dictionary>}
```

models/schema.yml

```yml

models:
  - name: model_name
    config:
      meta: {<словарь>}

    columns:
      - name: column_name
        config:
          meta: {<dictionary>} # изменено на config в версии v1.10 и затем портировано обратно в 1.9
```

Конфигурацию `meta` можно определить следующими способами:

* В разделе `models` конфигурации в файле проекта (как показано в предыдущем примере `models/schema.yml`)
* В разделе `models` конфигурации в файле проекта (`dbt_project.yml`)
* В Jinja‑макросе `config()` внутри SQL‑файла модели

Смотрите [конфигурации и свойства](https://docs.getdbt.tech/reference/configs-and-properties.md) для получения подробной информации.

### Источники

dbt\_project.yml

```yml
sources:
  <resource-path>:
    +meta: {<dictionary>}
```

models/schema.yml

```yml

источники:
  - name: model_name
    config:
      meta: {<словарь>}

    tables:
      - name: table_name
        config:
          meta: {<словарь>}

        columns:
          - name: column_name
            config:
              meta: {<dictionary>} # переименовано в config в версии v1.10 и портировано обратно в 1.9
```

### Сиды

dbt\_project.yml

```yml
seeds:
  <resource-path>:
    +meta: {<dictionary>}
```

seeds/schema.yml

```yml

seeds:
  - name: seed_name
    config:
      meta: {<словарь>}

    columns:
      - name: column_name
        config:
          meta: {<dictionary>} # изменено на config в версии v1.10 и бэкпортировано в 1.9
```

Конфигурацию `meta` можно определить:

* В разделе `seeds` в файле свойств (как показано в предыдущем примере 'seeds/schema.yml')
* В разделе `seeds` в файле проекта (`dbt_project.yml`). Подробнее см. в разделе [Конфигурации и свойства](https://docs.getdbt.tech/reference/configs-and-properties.md).

### Снимки

dbt\_project.yml

```yml
snapshots:
  <resource-path>:
    +meta: {<dictionary>}
```

snapshots/schema.yml

```yml

snapshots:
  - name: snapshot_name
    config:
      meta: {<словарь>}

    columns:
      - name: column_name
        config:
          meta: {<dictionary>} # изменено на config в версии v1.10 и портировано обратно в 1.9
```

Конфигурация `meta` может быть определена:

* в разделе `snapshots` файла свойств (как показано в предыдущем примере `snapshots/schema.yml`)
* в разделе `snapshots` файла проекта (`dbt_project.yml`)
* внутри Jinja‑макроса `config()` в SQL‑блоке snapshot’а

Смотрите [конфигурации и свойства](https://docs.getdbt.tech/reference/configs-and-properties.md) для получения подробной информации.

### Тесты

Используйте поле `meta`, чтобы добавить метаданные к [универсальным](https://docs.getdbt.tech/docs/build/data-tests.md#generic-data-tests) или [единичным тестам](https://docs.getdbt.tech/docs/build/data-tests.md#singular-data-tests). Поле `meta` принимает пары «ключ — значение», включается в `manifest.json` при компиляции и отображается в автоматически создаваемой документации.

**Универсальные тесты данных**

Добавьте `meta` в блок `config` в файле `properties.yml`:

models/properties.yml

```yaml
models:
  - name: my_model
    columns:
      - name: my_column
        data_tests:
          - unique:
              config:
                meta:
                  owner: "docs team"
```

Или задайте значения по умолчанию в `dbt_project.yml`:

dbt\_project.yml

```yaml
data_tests:
  my_project:
    +meta:
      owner: "docs team"
```

**Единичные тесты данных**

Добавьте `meta` в SQL-файл теста с помощью `config()`:

tests/my\_singular\_test.sql

```sql
{{ config(meta={'owner': 'docs team'}) }}

select * from {{ ref('my_model') }}
where my_column is null
```

Или укажите метаданные в `tests/properties.yml`:

tests/properties.yml

```yaml
data_tests:
  - name: my_singular_test
    config:
      meta:
        owner: "analytics_team"
```

### Модульные тесты

Полезно знать

Доступно начиная с dbt v1.8 или в [канале релизов v1 Latest](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md).

dbt\_project.yml

```yml
unit_tests:
  <resource-path>:
    +meta: {<dictionary>}
```

models/\<filename>.yml

```yml
unit_tests:
  - name: <test-name>
    config:
      meta: {<dictionary>}
```

### Анализы

Конфигурация `meta` в настоящее время не поддерживается для анализов.

### Макросы

dbt\_project.yml

```yml
macros:
  <resource-path>:
    +meta: {<dictionary>}
```

macros/schema.yml

```yml
macros:
  - name: macro_name
    config: 
      meta: {<dictionary>} # перенесено в config в v1.11
    arguments:
      - name: argument_name
```

### Экспозиции

dbt\_project.yml

```yml
exposures:
  <resource-path>:
    +meta: {<dictionary>}
```

models/exposures.yml

```yml

exposures:
  - name: exposure_name
    config:
      meta: {<dictionary>} # изменено на config в версии v1.10
```

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

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

Задайте `meta` для [семантических моделей](https://docs.getdbt.tech/docs/build/semantic-models.md) в YAML-файле модели или в блоке конфигурации `semantic-models` в `dbt_project.yml`.

dbt\_project.yml

```yml
semantic-models:
  <resource-path>:
    +meta: {<dictionary>}
```

models/file\_name.yml

```yml
models:
  - name: model_name
    semantic_model:
      enabled: true
      config:
        meta: {<dictionary>}
```

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

У [измерений](https://docs.getdbt.tech/docs/build/dimensions.md), [сущностей](https://docs.getdbt.tech/docs/build/entities.md) и метрик могут быть собственные настройки `meta`.

models/file\_name.yml

```yml
models:
  - name: model_name
    semantic_model:
      enabled: true
      config:
        meta: {<dictionary>}

    agg_time_dimension: your_time_dimension_name

    columns:
      - name: entity_column_name
        entity:
          type: primary
          name: entity_name
          config:
            meta: {<dictionary>}

      - name: dimension_column_name
        dimension:
          type: categorical
          name: dimension_name
          config:
            meta: {<dictionary>}

    metrics:
      - name: simple_metric_name
        description: "Description of the metric"
        type: simple
        agg: sum  
        expr: column_name 
        config:
          meta: {<dictionary>}
```

Конфигурацию `meta` можно определить:

* В разделе `semantic-models` файла свойств (как показано в предыдущем примере `models/semantic_models.yml`)
* В разделе `semantic-models` файла проекта (`dbt_project.yml`). Подробнее см. в разделе [Конфигурации и свойства](https://docs.getdbt.tech/reference/configs-and-properties.md).

### Метрики

dbt\_project.yml

```yml
metrics:
<resource-path>:
  +meta: {<dictionary>}
```

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

models/file\_name.yml

```yml
models:
  - name: model_name 
    semantic_model:
      enabled: true
    agg_time_dimension: your_time_dimension
    columns:
      - name: column_name
        dimension:
          type: time
        granularity: day
    metrics:
      - name: number_of_people
        type: simple
        description: Total count of people
        agg: count
        expr: people
        config:
          meta:
            my_meta_config: 'config_value'
```

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

dbt\_project.yml

```yml
saved-queries:
  <resource-path>:
    +meta: {<dictionary>}
```

models/semantic\_models.yml

```yml
saved_queries:
  - name: saved_query_name
    config:
      meta: {<словарь>}
```

### Функции

dbt\_project.yml

```yml
functions:
  <resource-path>:
    +meta: {<dictionary>}
```

functions/properties.yml

```yaml
functions:
  - name: function_name
    config:
      meta: {<dictionary>}
```

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

Конфигурация `meta` задаёт метаданные ресурса и принимает любые пары «ключ — значение». Эти метаданные включаются в файл `manifest.json`, создаваемый dbt, и отображаются в автоматически сгенерированной документации.

В зависимости от ресурса, который вы настраиваете, `meta` может быть доступно в свойстве `config` и/или в качестве ключа верхнего уровня. (Для обратной совместимости `meta` часто (но не всегда) поддерживается в качестве ключа верхнего уровня, хотя без возможностей наследования конфигурации.)

Влияние на сравнение состояния

Изменения `meta`, в том числе на уровне столбца, не приводят к выбору ресурса через [`state:modified`](https://docs.getdbt.tech/reference/node-selection/methods.md#state). Для dbt параметры `meta` и `tags` — метаданные: они не влияют на материализацию. Подробнее см. [Особенности сравнения состояния](https://docs.getdbt.tech/reference/node-selection/state-comparison-caveats.md#tags-and-meta).

## Примеры

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

* [Назначить владельца модели](#designate-a-model-owner)

  * [Указать, что столбец источника содержит персональные данные (PII)](#designate-a-source-column-as-containing-pii)
  * [Настроить один атрибут meta для всех seed-файлов](#configure-one-meta-attribute-for-all-seeds)
  * [Переопределить один атрибут meta для отдельной модели](#override-one-meta-attribute-for-a-single-model)
  * [Задать owner и favorite\_color в dbt\_project.yml как свойство конфигурации](#assign-owner-and-favoritecolor-in-the-dbtprojectyml-as-a-config-property)
  * [Задать meta для семантической модели](#assign-meta-to-semantic-model)
  * [Задать meta для измерений, мер и сущностей](#assign-meta-to-dimensions-measures-entities)
  * [Добавить meta к универсальным и единичным тестам данных](#add-meta-to-generic-and-singular-data-tests)
  * [Получить доступ к значениям meta в моделях Python](#access-meta-values-in-python-models)

### Назначить владельца модели

Дополнительно можно указать уровень зрелости модели, используя ключ `model_maturity:`.

models/schema.yml

```yml

models:
  - name: users
    config:
      meta:
        owner: "@alice"
        model_maturity: in dev
```

### Назначение столбца источника как содержащего PII

models/schema.yml

```yml

Похоже, вы прислали только фрагмент `sources:` без содержимого.

Пожалуйста, пришлите полный текст markdown‑файла (или хотя бы раздел целиком), который нужно перевести. Тогда я смогу корректно перевести описания и пояснения, сохранить форматирование Docusaurus и не затронуть технические элементы dbt.
  - name: salesforce
    tables:
      - name: account
        config:
          meta:
            contains_pii: true
        columns:
          - name: email
            config:
              meta: # changed to config in v1.10 and backported to 1.9
                contains_pii: true
```

### Настройка одного атрибута meta для всех сидов

dbt\_project.yml

```yml
seeds:
  +meta:
    favorite_color: red
```

### Переопределение одного атрибута meta для одной модели

models/my\_model.sql

```sql
{{ config(meta = {
    'single_key': 'override'
}) }}

select 1 as id
```

<br />

### Назначение владельца и favorite\_color в dbt\_project.yml как свойства конфигурации

dbt\_project.yml

```yml
models:
  jaffle_shop:
    +meta:
      owner: "@alice"
      favorite_color: red
```

### Назначение meta для семантической модели

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

Ниже показано, как задать `meta` для [семантической модели](https://docs.getdbt.tech/docs/build/semantic-models.md) в YAML-файле модели и в `dbt_project.yml`:

### Semantic model

```yaml
models:
  - name: fact_transactions
    description: "Transaction fact table at the transaction level. This table contains one row per transaction and includes the transaction timestamp."
    semantic_model:
      enabled: true
      name: transaction
      config:
        meta:
          data_owner: "Finance team"
          used_in_reporting: true

    agg_time_dimension: transaction_date
```

### dbt\_project.yml

```yaml
semantic-models:
  jaffle_shop:
    +meta:
      used_in_reporting: true
```

### Назначение meta для измерений, метрик и сущностей

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

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

В следующем примере показано, как задать значение `meta` для [измерения](https://docs.getdbt.tech/docs/build/dimensions.md), [сущности](https://docs.getdbt.tech/docs/build/entities.md) и [простых метрик](https://docs.getdbt.tech/docs/build/simple.md) в семантической модели:

model\_name.yml

```yml
models:
  - name: model_name
    semantic_model:
      enabled: true
      name: semantic_model

    agg_time_dimension: order_date

    columns:
      - name: order_date
        dimension:
          type: time
          config:
            meta:
              data_owner: "Finance team"
              used_in_reporting: true

      - name: customer_id
        entity:
          type: primary
          config:
            meta:
              description: "Unique identifier for customers"
              data_owner: "Sales team"
              used_in_reporting: false

    metrics:
      - name: count_of_users
        type: simple
        agg: count_distinct
        expr: user_id
        config:
          meta:
            used_in_reporting: true
```

### dbt\_project.yml

Во втором примере показано, как задать `data_owner` и дополнительные метаданные для измерения в файле `dbt_project.yml` с помощью синтаксиса `+meta`. Аналогичный синтаксис можно использовать для сущностей и простых метрик.

dbt\_project.yml

```yml
semantic-models:
  jaffle_shop:
    ...
    dimensions:
      - name: order_date
        config:
          meta:
            data_owner: "Finance team"
            used_in_reporting: true
```

### Добавление meta в обобщённые и единичные тесты данных

В следующих примерах показано, как добавить `meta` в [обобщённые тесты данных](https://docs.getdbt.tech/docs/build/data-tests.md#generic-data-tests) в файле `properties.yml` и в [единичные тесты данных](https://docs.getdbt.tech/docs/build/data-tests.md#singular-data-tests) с помощью `config()`. Также можно задать значения по умолчанию в `dbt_project.yml` или `tests/properties.yml`.

### Обобщённый тест данных

models/properties.yml

```yaml
models:
  - name: orders
    columns:
      - name: order_id
        data_tests:
          - not_null:
              config:
                meta:
                  owner: "@data_team"
```

### Единичный тест данных

tests/assert\_order\_ids.sql

```sql
{{ config(meta={'owner': '@data_team'}) }}

select *
from {{ ref('orders') }}
where order_id is null
```

### Доступ к значениям meta в моделях Python

Для доступа к пользовательским значениям `meta` в [моделях Python](https://docs.getdbt.tech/docs/build/python-models.md) используйте метод `dbt.config.meta_get()`.

Например, если у вас есть модель с именем `my_python_model` и вы хотите сохранить в ней пользовательские значения, можно сделать следующее:

models/schema.yml

```yml
models:
  - name: my_python_model
    config:
      meta:
        batch_size: 1000
        processing_mode: "incremental"
```

models/my\_python\_model.py

```python
def model(dbt, session):
    # Access custom values stored in meta directly
    batch_size = dbt.config.meta_get("batch_size")
    processing_mode = dbt.config.meta_get("processing_mode")
    
    # Use the meta values in your model logic
    df = dbt.ref("upstream_model")
    
    if processing_mode == "incremental":
        df = df.limit(batch_size)
    
    return df
```
