[Документация Yandex Cloud](../../../index.md) > [Yandex Cloud Stackland](../../index.md) > [Пошаговые инструкции](../index.md) > Оркестрация данных > Managed Service for Apache Airflow™ > Настроить Connections в Apache Airflow™

# Настроить Connections в Apache Airflow™

Connection хранит параметры подключения DAG к базе данных, хранилищу или другому сервису. Инструкция описывает веб-интерфейс Apache Airflow™ 3.1.8 и подключения, сохраненные в базе метаданных кластера.

## Перед началом {#before-you-begin}

1. [Откройте веб-интерфейс](connect-ui.md) с учетной записью администратора Apache Airflow™ или пользователя с правами на Connections.
1. Подготовьте адрес сервиса, учетные данные и разрешения на нужные операции в этом сервисе.
1. Убедитесь, что установлен пакет provider для выбранного типа подключения. Например, для PostgreSQL нужен `apache-airflow-providers-postgres`. Если нужного типа нет в форме, [добавьте пакет](edit-cluster.md#console-dependencies) и дождитесь готовности кластера.

## Создать подключение {#create}

1. В левом меню Apache Airflow™ выберите **Admin** → **Connections**.
1. Нажмите **Add Connection**.
1. Заполните:

    * **Connection ID** — уникальный идентификатор, на который будет ссылаться код DAG, например `analytics_db`.
    * **Connection Type** — тип внешнего сервиса, например **Postgres** для PostgreSQL.
    * Поля подключения: **Host**, **Port**, **Login**, **Password** и другие поля, доступные для выбранного типа. Для подключения к PostgreSQL в **Database** укажите имя базы данных.
    * **Description** — описание назначения подключения, если требуется.

1. Если provider требует дополнительные настройки, задайте их в **Extra Fields** или **Extra Fields JSON**. Состав настроек зависит от provider; например, здесь могут задаваться параметры TLS.
1. Нажмите **Save** и найдите созданный Connection в списке по **Connection ID**.
1. В коде DAG укажите этот идентификатор в параметре подключения выбранного оператора или hook. Например, для `PostgresHook` используется `postgres_conn_id="analytics_db"`.
1. [Запустите DAG](run-dag.md#trigger), который обращается к сервису, и проверьте [логи задачи](view-logs.md#task-logs).

Кнопка **Test Connection** может быть отключена настройками Apache Airflow™ или недоступна для выбранного provider. Успешный тест из интерфейса не заменяет проверку задачи: сетевой доступ и окружение выполнения могут отличаться.

Подробнее о полях и проверке подключения — в [документации Apache Airflow™](https://airflow.apache.org/docs/apache-airflow/3.1.8/howto/connection.html).

## Изменить подключение {#edit}

1. Откройте **Admin** → **Connections** и найдите нужный **Connection ID**.
1. Нажмите кнопку с карандашом **Edit Connection** в строке подключения.
1. Измените нужные параметры и нажмите **Save**. Замаскированные поля со значением `***` оставьте без изменения, если не требуется заменить сохраненные данные.
1. Выполните новый запуск использующего подключение DAG или [повторите упавшую задачу](run-dag.md#rerun-task).

## Удалить подключение {#delete}

1. Убедитесь, что Connection больше не используется нужными DAG. При необходимости [сохраните настройки](export-settings.md).
1. В **Admin** → **Connections** найдите подключение и нажмите кнопку удаления в его строке.
1. Проверьте идентификатор в окне подтверждения и нажмите **Delete**.

Удаление Connection не удаляет внешний сервис или его данные. Задачи, которые продолжают обращаться к этому идентификатору, могут завершиться с ошибкой.

## Сохранить подключения перед удалением кластера {#export}

В интерфейсе Connections версии 3.1.8 нет операции экспорта. Используйте [экспорт и восстановление через CLI](export-settings.md): он сохраняет подключения из базы метаданных, включая пароли.

Connections из переменных окружения или внешнего хранилища секретов не отображаются в этом списке. Настроенные платформой подключения для синхронизации DAG и хранения логов задаются в [конфигурации кластера](edit-cluster.md), а не на странице Connections. Подробнее — в [описании видимости подключений](https://airflow.apache.org/docs/apache-airflow/3.1.8/howto/connection.html#visibility-in-ui-and-cli).