[Документация Yandex Cloud](../../../index.md) > [Yandex DataLens](../../index.md) > Подключения > Базы данных > Создание подключения к MySQL® # Создание подключения к MySQL® в Yandex DataLens {% note warning %} Yandex Cloud не отвечает за настройки удаленного подключения со стороны внешнего сервера БД. Подключая внешнюю БД, которая не является ресурсом Yandex Cloud: * Проверьте, что на стороне БД используется [SSL-сертификат](../../../glossary/ssl-certificate.md), подписанный удостоверяющим центром SSL. Вы не сможете создать подключение в DataLens, если на стороне БД используется самоподписанный SSL-сертификат. * Предоставьте доступ к БД для следующих диапазонов IP-адресов сервиса DataLens (через `/` указана длина маски подсети): {% list tabs group=ip_address %} - ipv4 {#ipv4} * `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` - ipv6 {#ipv6} * `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` {% endlist %} {% endnote %} Чтобы создать подключение к MySQL®: 1. Перейдите на [страницу создания нового подключения](https://datalens.ru/connections/new). 1. В разделе **Базы данных** выберите подключение **MySQL**. 1. Выберите тип подключения: {% list tabs group=connection %} - Выбрать в организации {#organization} Выберите управляемую БД в текущей организации Yandex Cloud и укажите для нее параметры, чтобы подключиться по внутренней сети: * **Облако и каталог**. Выберите каталог, в котором находится кластер. * **Кластер**. Укажите кластер из списка доступных кластеров MySQL®. В настройках кластера должна быть активирована опция **Доступ из DataLens**. Если у вас нет доступного кластера, нажмите кнопку **Создать новый**. {% note info %} В списке отображаются кластеры: * с правами доступа для пользователя, создающего подключение; * созданные в той же [организации](../../concepts/organizations.md), что и экземпляр DataLens. {% endnote %} * **Тип хоста**. Выберите тип хоста: * **Обычный** (по умолчанию) — позволяет выбрать обычные хосты для подключения. * **Особые FQDN** — позволяет выбрать для подключения [особые FQDN](../../../managed-mysql/operations/connect/index.md#special-fqdns), которые всегда указывают на текущий хост-мастер или на наименее отстающую от мастера реплику в кластере MySQL®. * **Имя хоста**. Выберите имя хоста из списка доступных в кластере MySQL®. Вы можете выбрать несколько хостов. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка. * **Порт**. Укажите порт подключения к MySQL®. Порт по умолчанию — 3306. * **Путь к базе данных**. Укажите имя подключаемой базы данных. * **Имя пользователя**. Укажите имя пользователя для подключения к MySQL®. * **Пароль**. Укажите пароль для пользователя. * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут). * **Уровень доступа SQL-запросов**. Позволяет использовать произвольный SQL-запрос для [формирования датасета](../../dataset/settings.md#sql-request-in-datatset). По умолчанию опция отключена. При активации необходимо выбрать уровень доступа SQL-запросов: * **Только подзапросы** — описывать источники датасета с помощью [SQL-запросов](../../dataset/settings.md#sql-request-in-datatset). * **Подзапросы и параметры** — описывать источники датасета с помощью SQL-запросов и использовать [параметризацию источников](../../dataset/settings.md#parametrization). * **SQL на чтение** — описывать источники датасета с помощью SQL-запросов, использовать параметризацию источников и [создавать QL-чарты](../../concepts/chart/ql-charts.md). Чтобы проверить корректность введенных параметров, нажмите кнопку **Проверить подключение**. ![image](../../../_assets/datalens/connection/mysql.png) - Указать вручную {#manual} Вручную укажите реквизиты внешней БД, чтобы подключиться через публичную сеть: * **Имя хоста**. Укажите путь до хоста-мастера или IP-адрес хоста-мастера MySQL®. Вы можете указать несколько хостов через запятую. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка. * **Порт**. Укажите порт подключения к MySQL®. Порт по умолчанию — 3306. * **Путь к базе данных**. Укажите имя подключаемой базы данных. * **Имя пользователя**. Укажите имя пользователя для подключения к MySQL®. * **Пароль**. Укажите пароль для пользователя. * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут). * **Уровень доступа SQL-запросов**. Позволяет использовать произвольный SQL-запрос для [формирования датасета](../../dataset/settings.md#sql-request-in-datatset). По умолчанию опция отключена. При активации необходимо выбрать уровень доступа SQL-запросов: * **Только подзапросы** — описывать источники датасета с помощью [SQL-запросов](../../dataset/settings.md#sql-request-in-datatset). * **Подзапросы и параметры** — описывать источники датасета с помощью SQL-запросов и использовать [параметризацию источников](../../dataset/settings.md#parametrization). * **SQL на чтение** — описывать источники датасета с помощью SQL-запросов, использовать параметризацию источников, [создавать QL-чарты](../../concepts/chart/ql-charts.md) и выполнять SQL-запросы на чтение. Чтобы проверить корректность введенных параметров, нажмите кнопку **Проверить подключение**. - Connection Manager {#conn-man} {% note info %} Для использования подключения Connection Manager в DataLens пользователю должна быть назначена [роль](../../../metadata-hub/security/connection-manager-roles.md) `connection-manager.user` на это подключение. {% endnote %} Выберите [подключение](../../../metadata-hub/concepts/connection-manager.md) к кластеру с управляемой БД MySQL®, созданное в сервисе Yandex Connection Manager: * **Облако и каталог**. Выберите каталог, в котором создано подключение к кластеру. * **Идентификатор подключения**. Выберите одно из доступных подключений в Connection Manager или [создайте новое](../../../metadata-hub/operations/create-connection.md). * **Хост**. Выберите хост из списка доступных в кластере MySQL®. * **Порт**. Заполняется автоматически в зависимости от выбранного хоста. * **База данных**. Выберите имя подключаемой базы данных. * **Имя пользователя**. Заполняется автоматически из данных выбранного подключения. * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут). * **Уровень доступа SQL-запросов**. Позволяет использовать произвольный SQL-запрос для [формирования датасета](../../dataset/settings.md#sql-request-in-datatset). По умолчанию опция отключена. При активации необходимо выбрать уровень доступа SQL-запросов: * **Только подзапросы** — описывать источники датасета с помощью [SQL-запросов](../../dataset/settings.md#sql-request-in-datatset). * **Подзапросы и параметры** — описывать источники датасета с помощью SQL-запросов и использовать [параметризацию источников](../../dataset/settings.md#parametrization). * **SQL на чтение** — описывать источники датасета с помощью SQL-запросов, использовать параметризацию источников и [создавать QL-чарты](../../concepts/chart/ql-charts.md). {% endlist %} 1. Нажмите кнопку **Создать подключение**. 1. Выберите [воркбук](../../workbooks-collections/index.md), в котором сохранится подключение, или создайте новый. Если вы пользуетесь старой навигацией по папкам, выберите папку для сохранения подключения. Нажмите кнопку **Создать**. 1. Укажите название подключения и нажмите кнопку **Создать**. ## Дополнительные настройки {#additional-settings} Вы можете указать дополнительные параметры подключения в разделе **Продвинутые настройки подключения**: * **Указание collate в запросе** — если в запросах к БД требуется явно задать правило сортировки, выберите один из режимов: * **Авто** — применяется настройка по умолчанию, решение о включении локали `utf8mb4_general_ci` остается на усмотрение DataLens. * **Вкл** — применяется настройка DataLens, для отдельных выражений в запросе указывается локаль `utf8mb4_general_ci`. Это приводит к использованию соответствующей логики сортировки сервером, вне зависимости от настроек сервера и конкретных таблиц. Используйте настройку DataLens, если локаль в БД несовместима с работой DataLens. Подробнее о локали и `COLLATE` смотрите в разделе [Изменить набор символов и правила их сравнения](../../../managed-mysql/operations/databases.md#charset-collate). * **Выкл** — применяется настройка по умолчанию, DataLens использует только имеющиеся параметры локали БД. * **TLS** — опция определяет необходимость использования протокола TLS. Когда опция включена, использование SSL для подключения становится обязательным. * **CA Certificate** — чтобы загрузить сертификат, нажмите кнопку **Прикрепить файл** и укажите файл сертификата. Когда сертификат загружен, поле отображает название файла. * **Запрет на экспорт данных** — когда опция включена, в чартах на базе этого подключения в меню ![icon](../../../_assets/console-icons/ellipsis.svg) пункт экспорта данных будет недоступен. При этом останется возможность копировать данные из чартов, а также снимать скриншоты.