Связаться с намиПодключиться

Создание подключения к MySQL® в Yandex DataLens

Статья создана
Улучшена
Обновлена 11 ноября 2025 г.

Важно

Yandex Cloud не отвечает за настройки удаленного подключения со стороны внешнего сервера БД. Подключая внешнюю БД, которая не является ресурсом Yandex Cloud:

  • Проверьте, что на стороне БД используется SSL-сертификат, подписанный удостоверяющим центром SSL. Вы не сможете создать подключение в DataLens, если на стороне БД используется самоподписанный SSL-сертификат.

  • Предоставьте доступ к БД для следующих диапазонов IP-адресов сервиса DataLens (через / указана длина маски подсети):

    • 178.154.242.176/28
    • 178.154.242.192/28
    • 178.154.242.208/28
    • 178.154.242.128/28
    • 178.154.242.144/28
    • 178.154.242.160/28
    • 130.193.60.0/28
    • 2a02:6b8:c03:500:0:f83d:a987:0/112
    • 2a02:6b8:c02:900:0:f83d:a987:0/112
    • 2a02:6b8:c0e:500:0:f83d:a987:0/112
    • 2a02:6b8:c41:1300:0:f83d:a987:0/112

Чтобы создать подключение к MySQL®:

  1. Перейдите на страницу создания нового подключения.

  2. В разделе Базы данных выберите подключение MySQL.

  3. Выберите тип подключения:

    Выберите управляемую БД в текущей организации Yandex Cloud и укажите для нее параметры, чтобы подключиться по внутренней сети:

    • Облако и каталог. Выберите каталог, в котором находится кластер.

    • Кластер. Укажите кластер из списка доступных кластеров MySQL®. В настройках кластера должна быть активирована опция Доступ из DataLens. Если у вас нет доступного кластера, нажмите кнопку Создать новый.

      Примечание

      В списке отображаются кластеры:

      • с правами доступа для пользователя, создающего подключение;
      • созданные в той же организации, что и экземпляр DataLens.

    • Тип хоста. Выберите тип хоста:

      • Обычный (по умолчанию) — позволяет выбрать обычные хосты для подключения.
      • Особые FQDN — позволяет выбрать для подключения особые FQDN, которые всегда указывают на текущий хост-мастер или на наименее отстающую от мастера реплику в кластере MySQL®.

    • Имя хоста. Выберите имя хоста из списка доступных в кластере MySQL®. Вы можете выбрать несколько хостов. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка.

    • Порт. Укажите порт подключения к MySQL®. Порт по умолчанию — 3306.

    • Путь к базе данных. Укажите имя подключаемой базы данных.

    • Имя пользователя. Укажите имя пользователя для подключения к MySQL®.

    • Пароль. Укажите пароль для пользователя.

    • Время жизни кеша в секундах. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).

    • Уровень доступа SQL запросов. Позволяет использовать произвольный SQL-запрос для формирования датасета. По умолчанию опция отключена. При активации необходимо выбрать уровень доступа SQL-запросов:

      • Разрешить подзапросы в датасетах — описывать источники датасета с помощью SQL-запросов;
      • Разрешить подзапросы в датасетах и параметризацию источников — описывать источники датасета с помощью SQL-запросов и использовать параметризацию источников;
      • Разрешить подзапросы в датасетах, параметризацию источников и QL-чарты — описывать источники датасета с помощью SQL-запросов, использовать параметризацию источников и создавать QL-чарты.

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

    Вручную укажите реквизиты внешней БД, чтобы подключиться через публичную сеть:

    • Имя хоста. Укажите путь до хоста-мастера или IP-адрес хоста-мастера MySQL®. Вы можете указать несколько хостов через запятую. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка.
    • Порт. Укажите порт подключения к MySQL®. Порт по умолчанию — 3306.
    • Путь к базе данных. Укажите имя подключаемой базы данных.
    • Имя пользователя. Укажите имя пользователя для подключения к MySQL®.
    • Пароль. Укажите пароль для пользователя.
    • Время жизни кеша в секундах. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).

    • Уровень доступа SQL запросов. Позволяет использовать произвольный SQL-запрос для формирования датасета. По умолчанию опция отключена. При активации необходимо выбрать уровень доступа SQL-запросов:

      • Разрешить подзапросы в датасетах — описывать источники датасета с помощью SQL-запросов;
      • Разрешить подзапросы в датасетах и параметризацию источников — описывать источники датасета с помощью SQL-запросов и использовать параметризацию источников;
      • Разрешить подзапросы в датасетах, параметризацию источников и QL-чарты — описывать источники датасета с помощью SQL-запросов, использовать параметризацию источников и создавать QL-чарты.

    image

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

    Примечание

    Для использования подключения Connection Manager в DataLens пользователю должна быть назначена роль connection-manager.user на это подключение.

    Выберите подключение к кластеру с управляемой БД MySQL®, созданное в сервисе Yandex Connection Manager:

    • Облако и каталог. Выберите каталог, в котором создано подключение к кластеру.
    • Идентификатор подключения. Выберите одно из доступных подключений в Connection Manager или создайте новое.
    • Хост. Выберите хост из списка доступных в кластере MySQL®.
    • Порт. Заполняется автоматически в зависимости от выбранного хоста.
    • База данных. Выберите имя подключаемой базы данных.
    • Имя пользователя. Заполняется автоматически из данных выбранного подключения.
    • Время жизни кеша в секундах. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).

    • Уровень доступа SQL запросов. Позволяет использовать произвольный SQL-запрос для формирования датасета. По умолчанию опция отключена. При активации необходимо выбрать уровень доступа SQL-запросов:

      • Разрешить подзапросы в датасетах — описывать источники датасета с помощью SQL-запросов;
      • Разрешить подзапросы в датасетах и параметризацию источников — описывать источники датасета с помощью SQL-запросов и использовать параметризацию источников;
      • Разрешить подзапросы в датасетах, параметризацию источников и QL-чарты — описывать источники датасета с помощью SQL-запросов, использовать параметризацию источников и создавать QL-чарты.

  4. Нажмите кнопку Создать подключение.

  5. Выберите воркбук, в котором сохранится подключение, или создайте новый. Если вы пользуетесь старой навигацией по папкам, выберите папку для сохранения подключения. Нажмите кнопку Создать.

  6. Укажите название подключения и нажмите кнопку Создать.

Дополнительные настройки

Вы можете указать дополнительные параметры подключения в разделе Продвинутые настройки подключения:

  • TLS — опция определяет необходимость использования протокола TLS. Когда опция включена, использование SSL для подключения становится обязательным.
  • CA Certificate — чтобы загрузить сертификат, нажмите кнопку Прикрепить файл и укажите файл сертификата. Когда сертификат загружен, поле отображает название файла.

  • Запрет на экспорт данных — когда опция включена, в чартах на базе этого подключения в меню пункт экспорта данных будет недоступен. При этом останется возможность копировать данные из чартов, а также снимать скриншоты.

Предыдущая
Создание подключения к PostgreSQL
Следующая
Создание подключения к YDB