---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/operations/connection/create-mysql
  - ru/operations/connection/create-mysql
  - href: ru/operations/connection/create-mysql.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/operations/connection/create-mysql.html
title: Инструкция по созданию подключения к MySQL® в DataLens On-premises
description: Из статьи вы узнаете, как подключиться к MySQL® в DataLens On-premises.
vcsPath: ru/operations/connection/create-mysql.md
---

# Создание подключения к MySQL® в DataLens On-premises



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

1. Перейдите на страницу [воркбука](../../workbooks-collections/index.md) или создайте новый.
1. В правом верхнем углу нажмите **Создать** → **Подключение**.
1. Выберите подключение **MySQL®**.
1. Укажите параметры подключения для внешней БД MySQL®:

   <!-- source: ru/_includes/datalens/datalens-db-connection-parameters-mysql.md -->
   * **Имя хоста**. Укажите путь до хоста-мастера или IP-адрес хоста-мастера MySQL®. Вы можете указать несколько хостов через запятую. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка.
   * **Порт**. Укажите порт подключения к MySQL®. Порт по умолчанию — 3306.
   * **Путь к базе данных**. Укажите имя подключаемой базы данных.
   * **Имя пользователя**. Укажите имя пользователя для подключения к MySQL®.
   * **Пароль**. Укажите пароль для пользователя.
   * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).

   <!-- source: ru/_includes/datalens/datalens-db-connection-sql-level-3.md -->
   * **Уровень доступа 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-запросы на чтение.
   <!-- endsource: ru/_includes/datalens/datalens-db-connection-sql-level-3.md -->
   <!-- endsource: ru/_includes/datalens/datalens-db-connection-parameters-mysql.md -->

   ![image](../../_assets/datalens/operations/connection/connection-mysql-ent.png)

1. (опционально) Проверьте работоспособность подключения. Для этого нажмите кнопку **Проверить подключение**.
1. Нажмите кнопку **Создать подключение**.
1. Укажите название подключения и нажмите кнопку **Создать**.


## Дополнительные настройки {#additional-settings}

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

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

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

* **TLS** — опция определяет необходимость использования протокола TLS. Когда опция включена, использование SSL для подключения становится обязательным.
* **CA Certificate** — чтобы загрузить сертификат, нажмите кнопку **Прикрепить файл** и укажите файл сертификата. Когда сертификат загружен, поле отображает название файла.
* <!-- source: ru/_includes/datalens/operations/datalens-db-connection-export-settings-item.md -->
  **Запрет на экспорт данных** — когда опция включена, в чартах на базе этого подключения в меню <!-- diplodoc:svg ![icon](../../_assets/console-icons/ellipsis.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg> пункт экспорта данных будет недоступен. При этом останется возможность копировать данные из чартов, а также снимать скриншоты.
  <!-- endsource: ru/_includes/datalens/operations/datalens-db-connection-export-settings-item.md -->