Связаться с намиПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ООО «Яндекс.Облако»

Подключение к кластеру MySQL® из приложений

Статья создана
Обновлена 28 января 2026 г.

В этом разделе представлены настройки для подключения к хостам кластера Managed Service for MySQL® с помощью инструментов командной строки, из графических IDE, из Yandex WebSQL и Docker-контейнера. О подключении из кода вашего приложения см. Примеры кода.

Инструменты командной строки

Примеры кода с заполненным FQDN хоста доступны в консоли управления по нажатию кнопки Подключиться на странице кластера.

Linux (Bash)/macOS (Zsh)

Перед подключением установите утилиту mysql:

sudo apt update && sudo apt install --yes mysql-client

mysql --host=<имя_хоста_MySQL®>.mdb.yandexcloud.net \
      --port=3306 \
      --ssl-ca=~/.mysql/root.crt \
      --ssl-mode=VERIFY_IDENTITY \
      --user=<имя_пользователя> \
      --password \
      <имя_БД>

mysql --host=<FQDN_любого_хоста_MySQL®> \
      --port=3306 \
      --ssl-mode=DISABLED \
      --user=<имя_пользователя> \
      --password \
      <имя_БД>

О том, как получить FQDN хоста, см. инструкцию.

При выполнении любой из команд введите пароль пользователя БД.

После подключения к СУБД выполните команду SELECT version();.

При успешном подключении к кластеру и выполнении тестового запроса будет выведена версия MySQL®.

Windows (PowerShell)

Перед подключением скачайте и установите утилиту MySQL Shell.

mysqlsh --host=<FQDN_любого_хоста_MySQL®> `
        --port=3306 `
        --ssl-ca=<абсолютный_путь_к_файлу_сертификата> `
        --ssl-mode=VERIFY_IDENTITY `
        --user=<имя_пользователя> `
        --password `
        --database=<имя_БД> `
        --sql

mysqlsh --host=<FQDN_любого_хоста_MySQL®> `
        --port=3306 `
        --ssl-mode=DISABLED `
        --user=<имя_пользователя> `
        --password `
        --database=<имя_БД>

О том, как получить FQDN хоста, см. инструкцию.

При выполнении любой из команд введите пароль пользователя БД.

После подключения к СУБД выполните команду SELECT version();.

При успешном подключении к кластеру и выполнении тестового запроса будет выведена версия MySQL®.

Подключение с аутентификацией через IAM

К базе данных Managed Service for MySQL® можно подключиться с помощью интерфейса командной строки Yandex Cloud (CLI), используя аутентификацию через IAM. Этот метод доступен для аккаунтов на Яндексе, федеративных аккаунтов и локальных пользователей. Подключение с аутентификацией через IAM не требует получения SSL-сертификата или указания FQDN хостов кластера.

Перед подключением установите клиент MySQL®:

sudo apt update && sudo apt install --yes mysql-client

Подготовьте кластер Managed Service for MySQL® к подключению:

  1. Перейдите в сервис Managed Service for MySQL.
  2. Нажмите на имя нужного кластера.
  3. Включите публичный доступ для хостов кластера:
    1. Выберите вкладку Хосты.
    2. Нажмите значок в строке первого хоста и выберите пункт Редактировать.
    3. Включите опцию Публичный доступ.
    4. Повторите операцию для остальных хостов кластера.
  4. Назначьте роль аккаунту пользователя, который будет подключаться к БД:
    1. Выберите вкладку Права доступа и нажмите кнопку Назначить роли.
    2. Введите электронную почту пользователя, к которой привязан аккаунт.
    3. Нажмите кнопку Добавить роль и выберите роль managed-mysql.clusters.connector.
    4. Нажмите кнопку Сохранить.
  5. Создайте пользователя MySQL®:
    1. Выберите вкладку Пользователи.
    2. Нажмите кнопку Создать пользователя.
    3. Выберите способ аутентификации IAM.
    4. Выберите аккаунт, которому была назначена роль managed-mysql.clusters.connector.
    5. Нажмите кнопку Добавить базу данных и выберите нужную базу данных из выпадающего списка.
    6. Нажмите значок в столбце Роли и выберите привилегию из выпадающего списка.
    7. Нажмите кнопку Создать.

Чтобы подключиться к БД Managed Service for MySQL®, выполните команду:

yc managed-mysql connect <имя_или_идентификатор_кластера> --db <имя_БД>

Подключение из графических IDE

Подключения проверялись в следующем окружении:

  • Ubuntu 20.04, DBeaver: 22.2.4;
  • MacOS Monterey 12.7:
    • JetBrains DataGrip: 2023.3.4;
    • DBeaver Community: 24.0.0.

Подключаться из графических IDE можно только к хостам кластера в публичном доступе с использованием SSL-сертификата.

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

  1. Создайте источник данных:
    1. Выберите в меню File → New → Data Source → MySQL®.
    2. На вкладке General:
      1. Укажите параметры подключения:
      2. Нажмите ссылку Download, чтобы загрузить драйвер соединения.
    3. На вкладке SSH/SSL:
      1. Включите настройку Use SSL.
      2. В поле CA file укажите путь к файлу SSL-сертификата для подключения.
  2. Чтобы проверить подключение, нажмите ссылку Test Connection. При успешном подключении будет выведен статус подключения, информация о СУБД и драйвере.
  3. Нажмите кнопку OK, чтобы сохранить источник данных.
  1. Создайте новое соединение с БД:
    1. Выберите в меню База данных пункт Новое соединение.
    2. Выберите из списка БД MySQL®.
    3. Нажмите кнопку Далее.
    4. Укажите параметры подключения на вкладке Главное:
      • Сервер — FQDN любого хоста MySQL® или один из особых FQDN;
      • Порт — 3306;
      • База данных — имя БД для подключения;
      • Пользователь, Пароль — имя и пароль пользователя БД.
    5. На вкладке SSL:
      1. Включите настройку Использовать SSL.
      2. В поле Корневой сертификат укажите путь к сохраненному файлу SSL-сертификата.
      3. В блоке Дополнительные:
        1. Включите настройку Только SSL.
        2. Выключите настройку Проверять сертификат сервера.
  2. Нажмите кнопку Тест соединения ... для проверки подключения. При успешном подключении будет выведен статус подключения, информация о СУБД и драйвере.
  3. Нажмите кнопку Готово, чтобы сохранить настройки соединения с БД.

Подключение из Yandex WebSQL

Вы можете отправлять SQL-запросы к базам данных в кластере Managed Service for MySQL® с помощью сервиса Yandex WebSQL.

WebSQL — это сервис Yandex Cloud, который позволяет подключаться к кластерам управляемых баз данных, работать с БД, таблицами и схемами и выполнять запросы. Сервис работает в браузере, не требует дополнительной авторизации и предлагает удобные подсказки для работы с SQL-командами.

Для подключения из WebSQL в настройках кластера должна быть включена опция Доступ из WebSQL. Опцию можно включить при создании или изменении кластера.

В кластере Managed Service for MySQL® для каждого пользователя БД автоматически создается подключение Connection Manager, которое можно использовать для подключения к БД из WebSQL. При необходимости вы также можете создать новое подключение.

Чтобы подключиться к БД из WebSQL:

  1. В консоли управления перейдите в каталог с нужным кластером.

  2. Перейдите в сервис Managed Service for MySQL.

  3. Нажмите на имя нужного кластера и перейдите на вкладку WebSQL.

  4. Выберите нужное подключение.

    Откроется подключение в сервисе WebSQL. Чтобы перейти в редактор запросов, выберите нужную БД.

    Справочник по поддерживаемым запросам можно найти в документации MySQL®.

Подробнее о работе с WebSQL см. в документации сервиса.

Подготовка к подключению из Docker-контейнера

Чтобы подключаться к кластеру Managed Service for MySQL® из Docker-контейнера, добавьте в Dockerfile строки:

RUN apt-get update && \
    apt-get install mysql-client --yes

RUN apt-get update && \
    apt-get install wget mysql-client --yes && \
    mkdir --parents ~/.mysql && \
    wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
         --output-document ~/.mysql/root.crt && \
    chmod 0600 ~/.mysql/root.crt
Предыдущая
FQDN хостов
Следующая
Примеры кода