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

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

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

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

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

   Выбрать в организации

   Указать вручную

   Connection Manager

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

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

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

     Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

   Примечание

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

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

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

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

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

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

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

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

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

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

• Указание collate в запросе — если в запросах к БД требуется явно задать правило сортировки, выберите один из режимов:

  • Авто — применяется настройка по умолчанию, решение о включении локали utf8mb4_general_ci остается на усмотрение DataLens.
  • Вкл — применяется настройка DataLens, для отдельных выражений в запросе указывается локаль utf8mb4_general_ci. Это приводит к использованию соответствующей логики сортировки сервером, вне зависимости от настроек сервера и конкретных таблиц. Используйте настройку DataLens, если локаль в БД несовместима с работой DataLens. Подробнее о локали и COLLATE смотрите в разделе Изменить набор символов и правила их сравнения.
  • Выкл — применяется настройка по умолчанию, DataLens использует только имеющиеся параметры локали БД.

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

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

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