[Документация Yandex Cloud](../../index.md) > [Yandex Query](../index.md) > Пошаговые инструкции > Управление соединениями

# Управление соединениями

[Соединение](../concepts/glossary.md#connection) необходимо для подключения Yandex Query к источникам и приемникам данных.

## Создать соединение {#create}

Чтобы создать соединение:

1. В [консоли управления](https://console.yandex.cloud) выберите каталог, в котором нужно создать соединение.
1. Перейдите в сервис **Yandex Query**.
1. На панели слева выберите **Соединения**.
1. Нажмите кнопку ![info](../../_assets/console-icons/plus.svg) **Создать**.
1. Введите имя и описание соединения. Требования к имени:

    * имя должно состоять из букв латинского алфавита в нижнем регистре;
    * длина — от 3 до 63 символов;
    * может содержать цифры и дефисы;
    * первый символ — буква, последний — не дефис.

1. Выберите тип соединения и укажите **Параметры типа соединения**:

   {% list tabs %}

   - Object Storage

     * **Аутентификация бакета**: `Публичный` или `Приватный`.
     * Для публичного бакета введите имя в поле **Бакет**.
       Для приватного бакета выберите:
       * **Облако и каталог**, в котором находится источник данных.
       * Выберите или создайте новый бакет.
       * Выберите или создайте новый [сервисный аккаунт](../../iam/concepts/users/service-accounts.md), от имени которого будет выполняться доступ к данным.

   - Data Streams

     * Выберите **Облако и каталог**, в котором находится источник данных.
     * Выберите или создайте новую [serverless базу данных Managed Service for YDB](../../ydb/index.md) с [потоком данных](../../data-streams/concepts/index.md) Yandex Data Streams.
     * Выберите или создайте новый [сервисный аккаунт](../../iam/concepts/users/service-accounts.md), от имени которого будет выполняться доступ к данным.

   - Managed Service for ClickHouse®

      * **Кластер** — выберите существующий кластер Managed Service for ClickHouse® или создайте новый.
      * **Сервисный аккаунт** — выберите существующий [сервисный аккаунт](../../iam/concepts/users/service-accounts.md) Managed Service for ClickHouse® или создайте новый с [ролью](../../managed-clickhouse/security.md#managed-clickhouse-viewer) `managed-clickhouse.viewer`, от имени которого будет выполняться подключение к кластерам `Managed Service for ClickHouse®`.
      * **База данных**  — выберите базу данных, которая будет использоваться при работе с кластером ClickHouse®.
      * **Логин**  — имя пользователя, которое будет использоваться для подключения к базам данных ClickHouse®.
      * **Пароль**  — пароль пользователя, который будет использоваться для подключения к базам данных ClickHouse®.

   - Yandex MPP Analytics for PostgreSQL

      * **Кластер** — выберите существующий кластер Yandex MPP Analytics for PostgreSQL или создайте новый.
      * **Сервисный аккаунт** — выберите существующий [сервисный аккаунт](../../iam/concepts/users/service-accounts.md) Yandex MPP Analytics for PostgreSQL или создайте новый с ролью [`managed-greenplum.viewer`](../../managed-greenplum/security/index.md#mgp-viewer), от имени которого будет выполняться подключение к кластерам `Yandex MPP Analytics for PostgreSQL`.
      * **База данных**  — выберите базу данных, которая будет использоваться при работе с кластером Greenplum®.
      * **Схема**  — укажите [пространство имен](https://docs.vmware.com/en/VMware-Greenplum/7/greenplum-database/admin_guide-ddl-ddl-schema.html), которое будет использоваться при работе с базой данных Greenplum®.
      * **Логин**  — имя пользователя, которое будет использоваться для подключения к базам данных Greenplum®.
      * **Пароль**  — пароль пользователя, который будет использоваться для подключения к базам данных Greenplum®.

   - Managed Service for MySQL®

      * **Кластер** — выберите существующий кластер Managed Service for MySQL® или создайте новый.
      * **Сервисный аккаунт** — выберите существующий [сервисный аккаунт](../../iam/concepts/users/service-accounts.md) Managed Service for MySQL® или создайте новый с ролью [`managed-mysql.viewer`](../../managed-mysql/security/index.md#managed-mysql-viewer), от имени которого будет выполняться подключение к кластерам `Managed Service for MySQL®`.
      * **База данных**  — выберите базу данных, которая будет использоваться при работе с кластером MySQL®.
      * **Логин**  — имя пользователя, которое будет использоваться для подключения к базам данных MySQL®.
      * **Пароль**  — пароль пользователя, который будет использоваться для подключения к базам данных MySQL®.

   - Managed Service for PostgreSQL

      * **Кластер** — выберите существующий кластер Managed Service for PostgreSQL или создайте новый.
      * **Сервисный аккаунт** — выберите существующий [сервисный аккаунт](../../iam/concepts/users/service-accounts.md) Managed Service for PostgreSQL или создайте новый с [ролью](../../managed-postgresql/security/index.md#managed-postgresql-viewer) `managed-postgresql.viewer`, от имени которого будет выполняться подключение к кластерам `Managed Service for PostgreSQL`.
      * **База данных**  — выберите базу данных, которая будет использоваться при работе с кластером PostgreSQL.
      * **Логин**  — имя пользователя, которое будет использоваться для подключения к базам данных PostgreSQL.
      * **Пароль**  — пароль пользователя, который будет использоваться для подключения к базам данных PostgreSQL.

   - Managed Service for YDB
     
      * **Кластер** — выберите существующую базу данных Managed Service for YDB или создайте новую.
      * **Сервисный аккаунт** — выберите [сервисный аккаунт](../../iam/concepts/users/service-accounts.md) Managed Service for YDB, от имени которого будет выполняться подключение к кластерам `Managed Service for YDB` и аутентификация в базе данных.

   - Monitoring

     * Выберите **Облако и каталог**, в котором находится источник данных.
     * Выберите или создайте новый [сервисный аккаунт](../../iam/concepts/users/service-accounts.md), от имени которого будет выполняться запись метрик.

   {% endlist %}

1. Нажмите кнопку **Создать**.

Чтобы использовать соединение, в настройках которого указан сервисный аккаунт, пользователю нужна [роль](../../iam/security/index.md#iam-serviceAccounts-user) `iam.serviceAccounts.user`.

Далее вы можете [создать привязку](binding.md#create).

## Получить информацию о соединении {#get-info}

Чтобы посмотреть информацию о соединении:

1. В [консоли управления](https://console.yandex.cloud) выберите каталог, в котором создано соединение.
1. Перейдите в сервис **Yandex Query**.
1. На панели слева выберите **Соединения**.
1. В строке с именем нужного соединения нажмите кнопку ![info](../../_assets/console-icons/circle-info.svg). Раздел **Общее** содержит информацию об источнике и сервисном аккаунте. В разделе **Мета** указаны идентификатор (ID) соединения, время создания и автор.

## Изменить параметры соединения {#update}

Чтобы изменить параметры соединения:

1. В [консоли управления](https://console.yandex.cloud) выберите каталог, в котором создано соединение.
1. Перейдите в сервис **Yandex Query**.
1. На панели слева выберите **Соединения**.
1. В строке с именем нужного соединения нажмите кнопку ![ellipsis](../../_assets/console-icons/ellipsis.svg) и выберите **Изменить**.
1. Укажите новые параметры соединения. Тип соединения изменить нельзя.
1. Нажмите кнопку **Изменить**.

## Удалить соединение {#delete}

Чтобы удалить соединение:

1. В [консоли управления](https://console.yandex.cloud) выберите каталог, в котором создано соединение.
1. Перейдите в сервис **Yandex Query**.
1. На панели слева выберите **Соединения**.
1. В строке с именем нужного соединения нажмите кнопку ![ellipsis](../../_assets/console-icons/ellipsis.svg) и выберите **Удалить**.
1. Подтвердите удаление соединения.

_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._