# schema

### Модель

Укажите [пользовательскую схему](https://docs.getdbt.tech/docs/build/custom-schemas.md#understanding-custom-schemas) для группы моделей в YAML-файле проекта (`dbt_project.yml`), в [конфигурации SQL-файла](https://docs.getdbt.tech/reference/resource-configs/schema.md#models) или в YAML-файле свойств.

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

dbt\_project.yml

```yml
models:
  your_project:
    marketing: # Группировка или папка для набора моделей
      +schema: marketing
```

Вы также можете задать схему для отдельной модели в её файле свойств:

models/properties.yml

```yml
models:
  - name: my_model
    config:
      schema: marketing
```

В результате сгенерированные отношения для этих моделей будут размещены в схеме `marketing`, а полные имена отношений будут иметь вид `analytics.target_schema_marketing.model_name`. Это связано с тем, что схема отношения задаётся как `{{ target.schema }}_{{ schema }}`. В разделе [Определение](#definition) это объясняется подробнее.

### Сиды

Настройте [пользовательскую](https://docs.getdbt.tech/docs/build/custom-schemas.md#understanding-custom-schemas) схему в вашем файле `dbt_project.yml`.

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

dbt\_project.yml

```yml
seeds:
  your_project:
    product_mappings:
      +schema: mappings
```

Это приведет к тому, что сгенерированное отношение будет находиться в схеме `mappings`, так что полное имя отношения будет `analytics.mappings.seed_name`.

### Снапшоты

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

Укажите [пользовательскую схему](https://docs.getdbt.tech/docs/build/custom-schemas.md#understanding-custom-schemas) для snapshot в вашем файле `dbt_project.yml` или в property‑файле.

Например, если у вас есть снапшот, который вы хотите загрузить в схему, отличную от целевой схемы, вы можете настроить это следующим образом:

В файле `dbt_project.yml`:

dbt\_project.yml

```yml
snapshots:
  your_project:
    your_snapshot:
      +schema: snapshots
```

В файле `snapshots/snapshot_name.yml`:

snapshots/snapshot\_name.yml

```yaml

snapshots:
  - name: snapshot_name
    config:
      schema: snapshots
```

Это приведет к тому, что сгенерированное отношение будет находиться в схеме `snapshots`, так что полное имя отношения будет `analytics.snapshots.your_snapshot` вместо стандартной целевой схемы.

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

Укажите [пользовательскую схему](https://docs.getdbt.tech/docs/build/custom-schemas.md#understanding-custom-schemas) для [сохранённого запроса](https://docs.getdbt.tech/docs/build/saved-queries.md#parameters) в вашем `dbt_project.yml` или файле свойств.

dbt\_project.yml

```yml
saved-queries:
  +schema: metrics
```

В результате сохранённый запрос будет сохранён в схеме `metrics`.

### Тест

Настройте [свою схему](https://docs.getdbt.tech/docs/build/custom-schemas.md#understanding-custom-schemas) для хранения результатов тестов в вашем файле `dbt_project.yml`.

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

dbt\_project.yml

```yml
data_tests:
  +store_failures: true
  +schema: test_results
```

Это приведет к тому, что результаты тестов будут сохранены в схеме `test_results`.

### Функции

Задайте для функции [пользовательскую схему](https://docs.getdbt.tech/docs/build/custom-schemas.md#understanding-custom-schemas) в `dbt_project.yml` или в файле свойств.

Например, чтобы разместить функцию в схеме `finance` вместо целевой схемы, настройте её в `dbt_project.yml` или в `properties.yml`:

dbt\_project.yml

```yml
functions:
  your_project:
    calculate_tax:
      +schema: finance
```

functions/properties.yml

```yaml
functions:
  - name: calculate_tax
    config:
      schema: finance
```

Функция будет размещена в схеме `target_schema_finance`, поэтому её полное имя будет `analytics.target_schema_finance.calculate_tax`.

Обратитесь к разделу [Использование](#usage) для получения дополнительных примеров.

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

При необходимости укажите пользовательскую схему для [модели](https://docs.getdbt.tech/docs/build/sql-models.md), [сида](https://docs.getdbt.tech/docs/build/seeds.md), [снапшота](https://docs.getdbt.tech/docs/build/snapshots.md), [сохраненного запроса](https://docs.getdbt.tech/docs/build/saved-queries.md) или [теста](https://docs.getdbt.tech/docs/build/data-tests.md).

Если вы используете dbt версии 1.8 или более ранней, используйте [конфигурацию `target_schema`](https://docs.getdbt.tech/reference/resource-configs/target_schema.md), чтобы указать пользовательскую схему для снимка.

Когда dbt создает отношение (таблица/представление) в базе данных, оно создается как: `{{ database }}.{{ schema }}.{{ identifier }}`, например, `analytics.finance.payments`.

Стандартное поведение dbt:

* Если пользовательская схема *не* указана, схема отношения — это целевая схема (`{{ target.schema }}`).
* Если пользовательская схема указана, по умолчанию схема отношения — это `{{ target.schema }}_{{ schema }}`.

Чтобы узнать больше о том, как изменить способ генерации схемы отношения dbt, прочитайте [Использование пользовательских схем](https://docs.getdbt.tech/docs/build/custom-schemas.md).

## Использование

### Модели

Настройте группы моделей из файла `dbt_project.yml`.

dbt\_project.yml

```yml
models:
  jaffle_shop: # имя проекта
    marketing:
      +schema: marketing
```

Настройте отдельные модели с помощью блока конфигурации:

models/my\_model.sql

```sql
{{ config(
    schema='marketing'
) }}
```

Или настройте отдельные модели в файле свойств:

models/properties.yml

```yml
models:
  - name: my_model
    config:
      schema: marketing
```

### Сиды

dbt\_project.yml

```yml
seeds:
  +schema: mappings
```

### Тесты данных

Настройте имя схемы, в которой тесты [настроенные для хранения сбоев](https://docs.getdbt.tech/reference/resource-configs/store_failures.md) будут сохранять свои результаты. Полученная схема — это `{{ profile.schema }}_{{ tests.schema }}`, с суффиксом по умолчанию `dbt_test__audit`. Чтобы использовать ту же схему профиля, установите `+schema: null`.

dbt\_project.yml

```yml
data_tests:
  +store_failures: true
  +schema: _sad_test_failures  # Запишет таблицы в my_database.my_schema__sad_test_failures
```

Убедитесь, что у вас есть права на создание или доступ к схемам, необходимым для вашей работы. Чтобы проверить, что требуемые схемы имеют корректные разрешения, выполните SQL‑запрос в соответствующей среде вашей платформы данных. Например, при использовании Redshift выполните следующую команду (конкретный запрос для проверки прав может отличаться в зависимости от платформы данных):

```sql
create schema if not exists dev_username_dbt_test__audit authorization username;
```

*Замените `dev_username` на ваше конкретное имя схемы разработки и `username` на соответствующего пользователя, которому должны быть предоставлены разрешения.*

Эта команда предоставляет соответствующие разрешения для создания и доступа к схеме `dbt_test__audit`, которая часто используется с конфигурацией `store_failures`.

## Информация, специфичная для хранилища

* BigQuery: `dataset` и `schema` взаимозаменяемы.
