# Пользовательские базы данных

Слово о наименованиях

Разные хранилища данных используют разные названия для *логических баз данных*. Информация в этом документе охватывает "базы данных" в Snowflake, Redshift и Postgres; "проекты" в BigQuery; и "каталоги" в Databricks Unity Catalog.

Значения `project` и `database` взаимозаменяемы в конфигурациях проектов BigQuery.

## Настройка пользовательских баз данных

Логическая база данных, в которую строятся модели dbt, может быть настроена с помощью конфигурации модели `database`. Если эта конфигурация не указана для модели, то dbt будет использовать базу данных, настроенную в активной цели из вашего файла `profiles.yml`. Если конфигурация `database` *указана* для модели, то dbt построит модель в указанной базе данных.

Конфигурация `database` может быть указана для групп моделей в файле `dbt_project.yml` или для отдельных моделей в SQL-файлах моделей.

### Настройка переопределений базы данных в `dbt_project.yml`:

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

dbt\_project.yml

```yaml
name: jaffle_shop

models:
  jaffle_shop:
    +database: jaffle_shop

    # Для пользователей BigQuery:
    # project: jaffle_shop
```

### Настройка переопределений базы данных в файле модели

Эта конфигурация изменяет конкретную модель, чтобы она строилась в базе данных под названием `jaffle_shop`.

models/my\_model.sql

```sql

{{ config(database="jaffle_shop") }}

select * from ...
```

### generate\_database\_name

Имя базы данных, генерируемое для модели, контролируется макросом под названием `generate_database_name`. Этот макрос может быть переопределен в проекте dbt для изменения способа генерации имен баз данных для моделей. Этот макрос работает аналогично макросу [generate\_schema\_name](https://docs.getdbt.tech/docs/build/custom-schemas.md#changing-the-way-dbt-generates-a-schema-name).

Чтобы переопределить генерацию имен баз данных в dbt, создайте макрос с именем `generate_database_name` в вашем собственном проекте dbt. Макрос `generate_database_name` принимает два аргумента:

1. Пользовательская база данных, указанная в конфигурации модели
2. Узел, для которого генерируется пользовательская база данных

Стандартная реализация `generate_database_name` просто использует указанную конфигурацию `database`, если она присутствует, в противном случае используется база данных, настроенная в активной `target`. Эта реализация выглядит следующим образом:

get\_custom\_database.sql

```jinja2
{% macro generate_database_name(custom_database_name=none, node=none) -%}

    {%- set default_database = target.database -%}
    {%- if custom_database_name is none -%}

        {{ default_database }}

    {%- else -%}

        {{ custom_database_name | trim }}

    {%- endif -%}

{%- endmacro %}
```

💡 Используйте управление пробелами Jinja, чтобы упорядочить ваши макросы!

Когда вы изменяете макросы в вашем проекте, вы можете заметить лишние пробелы в вашем коде в папке `target/compiled`.

Вы можете удалить ненужные пробелы и строки с помощью [управления пробелами Jinja](https://docs.getdbt.tech/faqs/Jinja/jinja-whitespace.md), используя знак минус. Например, используйте `{{- ... -}}` или `{%- ... %}` вокруг определений ваших макросов (таких как `{%- macro generate_schema_name(...) -%} ... {%- endmacro -%}`).

### Управление различными поведениями в пакетах

См. документацию по макросу `dispatch`: ["Управление различными глобальными переопределениями в пакетах"](https://docs.getdbt.tech/reference/dbt-jinja-functions/dispatch.md)

## Соображения

### BigQuery

Когда dbt открывает соединение с BigQuery, он делает это, используя `project_id`, указанный в активном таргете в файле `profiles.yml`. Именно на этот `project_id` будут выставляться счета за запросы, выполняемые в рамках запуска dbt, даже если некоторые модели настроены так, чтобы создаваться в других проектах.

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

* [Настройка database, schema и alias для dbt‑моделей](https://docs.getdbt.tech/guides/customize-schema-alias.md?step=1) — о том, как настраивать database, schema и alias для моделей dbt
* [Custom schema](https://docs.getdbt.tech/docs/build/custom-schemas.md) — о том, как настраивать schema для моделей dbt
* [Custom aliases](https://docs.getdbt.tech/docs/build/custom-aliases.md) — о том, как настраивать alias (имя) моделей dbt
