# О профилях dbt platform

Платформа dbt

Профили dbt platform определяют подключения, учётные данные и атрибуты, которые вы используете для подключения к хранилищу данных.

Назначайте профили [средам развёртывания](https://docs.getdbt.tech/docs/dbt-platform-environments.md#deployment-environment) и повторно используйте эти профили в других средах развёртывания в рамках того же проекта. Вы можете управлять профилями программно, используя нашу [документацию по API](https://docs.getdbt.tech/dbt-cloud/api-v3#/operations/List%20Profiles).

## Таблица профилей среды

На странице **Settings** среды в разделе **Connection profiles** перечислены профили, назначенные этой среде:

* **Profile name**: нажмите на имя профиля, чтобы открыть боковую панель просмотра и редактирования. В режиме просмотра отдельного столбца действий нет, поэтому для открытия и просмотра профиля используйте его имя.
* **Connection**: нажмите на подключение, чтобы открыть страницу [сведений о подключении](https://docs.getdbt.tech/docs/platform/connect-data-platform/about-connections.md#connection-management) в новой вкладке.
* **Режим редактирования**: нажмите **Edit**, чтобы перейти в режим редактирования. Используйте **значок замены** ![Значок замены](/img/docs/deploy/swap-icon.png) рядом со строкой профиля, чтобы назначить другой профиль.

### Особенности

* Профили не применяются к средам разработки, поскольку в них используются уникальные конфигурации и индивидуальные учётные данные.
* Настройка Semantic Layer пока не поддерживается в профилях.

## Создание профиля

Внедрение новой функции

dbt автоматически создаёт новый профиль на уровне проекта для каждой среды развёртывания и заполняет его существующими настройками подключения, учётными данными и расширенными атрибутами. Вам не нужно предпринимать никаких действий, чтобы создать профили для существующих проектов.

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

Чтобы создать новый профиль:

### Из настроек проекта

1. В главном меню перейдите на страницу **Dashboard** вашего проекта.
2. Нажмите **Settings**.
3. Прокрутите страницу до раздела **Profiles** и нажмите **Create new profile**.

[![Создание профиля из настроек проекта.](/img/docs/dbt-platform/profile-from-project.png?v=2 "Создание профиля из настроек проекта.")](#)Создание профиля из настроек проекта.

### Из настроек среды

1. В главном меню нажмите **Orchestration** и выберите **Environments**.
2. Нажмите на доступную среду развёртывания.
3. Нажмите **Settings**.
4. Нажмите **Edit**, чтобы перейти в режим редактирования, затем прокрутите страницу до раздела **Connection profiles**.
5. Нажмите **значок замены** ![Значок замены](/img/docs/deploy/swap-icon.png) рядом со строкой профиля, который хотите изменить.
6. Выберите **Add new profile** в раскрывающемся списке **Profile**.
7. Нажмите **Create profile**.
8. Нажмите **Save**.

[![Создание профиля из настроек среды.](/img/docs/dbt-platform/profile-from-environment.png?v=2 "Создание профиля из настроек среды.")](#)Создание профиля из настроек среды.

Следующие шаги одинаковы независимо от выбранного способа:

1. Задайте профилю имя, которое уникально среди всех проектов аккаунта, легко распознаётся и соответствует правилам именования:

   * Начинается с буквы
   * Заканчивается буквой или цифрой
   * Содержит только буквы, цифры, дефисы или символы подчёркивания
   * Не содержит идущих подряд дефисов или символов подчёркивания

2. В разделе **Connection details** выберите подключение из списка доступных [глобальных подключений](https://docs.getdbt.tech/docs/platform/connect-data-platform/about-connections.md#connection-management) или добавьте новое подключение.

3. Настройте **Deployment credentials** для подключения к вашему хранилищу данных.

4. Добавьте необходимые [**Extended attributes**](https://docs.getdbt.tech/docs/dbt-platform-environments.md#extended-attributes). Если вы используете [`env_var()`](https://docs.getdbt.tech/reference/dbt-jinja-functions/env_var.md) в расширенных атрибутах, переменные среды, на которые вы ссылаетесь, должны быть *заданы на уровне проекта*, чтобы работать при проверке подключения. Поскольку профили не привязаны к конкретной среде, переменные уровня среды недоступны при проверке подключения.

   Чтобы задать переменную на уровне проекта, перейдите в **Orchestration** > **Environments** > **Environment variables** и введите значение в столбце **Project default**. Подробнее см. в разделе [Переменные среды](https://docs.getdbt.tech/docs/build/environment-variables.md?version=2.0#setting-environment-variables).

5. Нажмите **Save** в верхней части экрана.

[![Пример настроенного профиля.](/img/docs/dbt-platform/profile-sample.png?v=2 "Пример настроенного профиля.")](#)Пример настроенного профиля.

Повторяйте эти шаги, пока не создадите все профили, необходимые для сред развёртывания вашего проекта.

## Назначение профиля

Вы настраиваете профили при создании среды развёртывания. Если в аккаунте на момент включения профилей уже настроены среды, dbt автоматически создаёт и назначает профиль по умолчанию для всех проектов.

Чтобы назначить другой профиль, обновите настройки среды развёртывания:

1. В левой панели навигации нажмите **Orchestration** и выберите **Environments**.
2. Нажмите на доступную среду развёртывания.
3. Нажмите **Settings**.
4. Нажмите **Edit**, чтобы перейти в режим редактирования, затем прокрутите страницу до раздела **Connection profiles**.
5. Нажмите **значок замены** ![Значок замены](/img/docs/deploy/swap-icon.png) рядом со строкой профиля, который хотите изменить.
6. Выберите новый профиль в раскрывающемся списке **Profile**.
7. Нажмите **Assign profile**.
8. Нажмите **Save**.

## Разрешения и доступ к профилям

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

Чтобы избежать непреднамеренного предоставления доступа, назначайте наборы разрешений, такие как **Job Admin** или **Project Admin**, только тем пользователям, которым необходим доступ ко всем учётным данным проекта. Учитывайте, что профили, созданные на уровне проекта, можно использовать для настройки учётных данных любой среды развёртывания в этом проекте.

Подробнее о наборах разрешений см. в разделе [Разрешения Enterprise](https://docs.getdbt.tech/docs/platform/manage-access/enterprise-permissions.md).

## Часто задаваемые вопросы

 Нужно ли создавать профили для всех существующих проектов?

Вам не нужно предпринимать никаких действий. dbt автоматически создаёт профили для всех существующих проектов и сред развёртывания на основе существующих настроек подключения, учётных данных и расширенных атрибутов.

 Есть ли изменения для сред разработки?

На данный момент нет. Профили применяются только к средам развёртывания.

 Что произойдёт, если я изменю настройки подключения, учётные данные или атрибуты?

Все профили, использующие эти настройки, автоматически обновятся с учётом новых данных.

 Что делать, если я использую API для настройки проекта?

Существующие API продолжают работать и автоматически сопоставляются с профилем за кулисами. Вам не потребуется выполнять какие-либо действия вручную, кроме случаев, когда вы используете API для создания среды развёртывания без настроенных учётных данных. Это редкая ситуация, возможная только при использовании API, но это единственный сценарий, в котором dbt не создаёт профиль.

Доступны API для работы с профилями. Подробнее см. в нашей [документации по API](https://docs.getdbt.tech/docs/dbt-apis/overview.md).

 Поддерживает ли Semantic Layer профили?

Настройка Semantic Layer пока не поддерживается в профилях.
