// бесплатный инструмент

Конструктор строки подключения MySQL

Создавайте URI подключения MySQL, JDBC URL, строку ADO.NET, строку ODBC или DSN для Go из одной формы или вставьте готовую, чтобы увидеть, что делает каждый параметр, и заметить небезопасные настройки вроде allowPublicKeyRetrieval. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.

Открыть это подключение в SQLly

Открывает редактор подключений SQLly с заполненными полями.

Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.

Форматы строк подключения MySQL

У MySQL нет единого стандарта строки подключения. Connector/J использует JDBC URL со свойствами в camelCase (sslMode, connectTimeout в миллисекундах), MySqlConnector и Connector/NET используют строки ADO.NET, Server=...; строки, Connector/ODBC использует ключевые слова ODBC, у драйвера Go свой user:pass@tcp(host:3306)/db DSN, а MySQL Shell принимает URI с ssl-mode.

TLS по умолчанию PREFERRED почти везде: шифруется, когда сервер это поддерживает, но сертификат не проверяется. VERIFY_IDENTITY (MySqlConnector: VerifyFull) проверяет CA и имя хоста.

URI MySQL Shell, mysql2, Prisma

mysql://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY

JDBC MySQL Connector/J

jdbc:mysql://db.example.com/sales?user=app_user&password=your_password&sslMode=VERIFY_IDENTITY

ADO.NET MySqlConnector, MySql.Data

Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;

ODBC MySQL Connector/ODBC

Driver={MySQL ODBC 8.0 Unicode Driver};Server=db.example.com;Database=sales;Uid=app_user;Pwd=your_password;SslMode=VERIFY_IDENTITY;

Go DSN github.com/go-sql-driver/mysql

app_user:your_password@tcp(db.example.com)/sales?tls=true

URL SQLAlchemy Python SQLAlchemy с PyMySQL

mysql+pymysql://app_user:[email protected]/sales?charset=utf8mb4

Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к MySQL: SQLly для MySQL.

Свойства MySQL Connector/J

Формат URL: jdbc:mysql://[host][:port][/database][?property=value&...]. Кодируйте зарезервированные символы процентным кодированием (/ : @ ( ) [ ] & # = ? и пробел) везде, включая пользователя и пароль.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
user / password - - Учётные данные.
sslMode - ПРЕДПОЧТИТЕЛЬНО DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY.
useSSL / requireSSL / verifyServerCertificate - - Устарело; все еще переводится (useSSL=false = DISABLED). sslMode выигрывает.
connectTimeout - 0 (нет) Миллисекунды ожидания подключения сокета.
socketTimeout - 0 (нет) Миллисекунды, в течение которых чтение может блокироваться.
allowPublicKeyRetrieval - ложь Позволяет клиенту запрашивать RSA-ключ сервера для caching_sha2_password без TLS.
connectionTimeZone serverTimezone МЕСТНЫЕ LOCAL, SERVER или идентификатор зоны.
characterEncoding - utf8mb4 (8.0.26+) Набор символов Java.
trustCertificateKeyStoreUrl - - Хранилище доверия с CA сервера для VERIFY_CA / VERIFY_IDENTITY.
rewriteBatchedStatements - ложь Преобразует пакетные INSERT-запросы в многострочные инструкции.

Опции MySqlConnector (ADO.NET)

MySqlConnector и Oracle Connector/NET (MySql.Data) используют в основном одни и те же ключевые слова. Значения с ; заключаются в двойные кавычки.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
Server Хост, источник данных, адрес localhost Хост, список через запятую или путь к Unix-сокету.
Port - 3306 TCP-порт.
User ID UID, User, Username - Имя пользователя.
Password PWD - Пароль.
Database Initial Catalog - Схема по умолчанию.
SslMode Режим SSL Предпочтительно None/Disabled, Preferred, Required, VerifyCA, VerifyFull.
SslCa Файл сертификата CA, Ssl-Ca - Файл CA для VerifyCA / VerifyFull.
Connection Timeout Таймаут подключения 15 Секунды.
Default Command Timeout Тайм-аут команды 30 Секунды; 0 означает ожидание бесконечно.
Application Name - - Устанавливает program_name атрибут соединения.
AllowPublicKeyRetrieval - ложь См. предупреждение выше.
AllowUserVariables - ложь Разрешить @variables в SQL.
Pooling - истина Пул подключений.
Maximum Pool Size Макс. размер пула 100 Наибольший пул.
Minimum Pool Size Мин. размер пула 0 Минимальный пул.

go-sql-driver/mysql DSN

Форма: [user[:password]@][protocol[(address)]]/dbname[?param=value&...]. Пароль экранировать не нужно; имя базы данных экранируется как часть пути (1.8+); значения параметров экранируются как часть запроса; имена параметров чувствительны к регистру.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
tcp(host:port) unix(/путь) tcp(127.0.0.1:3306) Адрес; порт по умолчанию — 3306.
tls - ложь true (проверить), false, skip-verify (шифрование, без проверок), preferredили зарегистрированное имя конфигурации.
timeout - По умолчанию ОС Тайм-аут подключения с указанием единицы: 10s.
readTimeout / writeTimeout - 0 Тайм-ауты ввода/вывода с указанием единицы измерения.
parseTime - ложь Сканировать DATE и DATETIME в time.Time.
loc - UTC Часовой пояс для time.Time значений (экранирование / как %2F).
collation - utf8mb4_general_ci Параметры сортировки подключения.
allowCleartextPasswords - ложь Отправлять пароль в открытом виде (только через TLS).
multiStatements - ложь Несколько операторов в одном запросе; усиливает последствия SQL-инъекции.

Ключевые слова MySQL Connector/ODBC

Ключевые слова нечувствительны к регистру. Имя драйвера должно совпадать с тем, что зарегистрировал ваш менеджер ODBC, — в нём указана версия.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
Driver - - напр. {MySQL ODBC 8.0 Unicode Driver}.
Server - localhost Хост.
Port - 3306 TCP-порт.
Database - - Схема по умолчанию.
User UID - Имя пользователя.
Password PWD - Пароль.
SSLMODE ssl-mode (8.0.29+) ПРЕДПОЧТИТЕЛЬНО DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY.

Распространённые ошибки подключения к MySQL

Access denied for user 'app_user'@'10.0.0.7' (using password: YES)

Почему: Ошибка 1045: неверный пароль, либо учётная запись существует только для другого шаблона хоста ('app_user'@'localhost' это другая учетная запись, чем 'app_user'@'%').

Исправлено: Проверьте пароль и SELECT user, host FROM mysql.user; создайте учётную запись для хоста, с которого вы подключаетесь, или выдайте ей права.

Public Key Retrieval is not allowed

Почему: Connector/J с MySQL 8 caching_sha2_password на соединении без TLS: драйверу нужен RSA-ключ сервера для отправки пароля, и ему не разрешено запрашивать его.

Исправлено: Используйте TLS (sslMode=REQUIRED или строже). allowPublicKeyRetrieval=true тоже работает, но открыт для атакующего посередине в небезопасной сети.

Can't connect to MySQL server on 'db.example.com:3306' (110)

Почему: Ошибка 2003: сервер недоступен: неверный хост или порт, bind-address ограничено 127.0.0.1, или это файрвол. (111 означает отказ в соединении, 110 — таймаут.)

Исправлено: Проверить bind-address и port в my.cnf, брандмауэре и облачной группе безопасности, а затем проверьте с nc -vz db.example.com 3306.

Host '10.0.0.7' is not allowed to connect to this MySQL server

Почему: Ошибка 1130: ни одна учётная запись не соответствует имени пользователя с хоста вашего клиента.

Исправлено: Создайте учётную запись для вашего хоста или для шаблона: CREATE USER 'app_user'@'10.0.0.%' ... и предоставить ему необходимые привилегии.

Unknown database 'sales'

Почему: Ошибка 1049: схемы из строки не существует, либо её имя отличается регистром на сервере с регистрозависимыми именами таблиц.

Исправлено: Проверить SHOW DATABASES; и точное написание.

Authentication plugin 'caching_sha2_password' cannot be loaded

Почему: Старая клиентская библиотека, предшествующая плагину аутентификации по умолчанию в MySQL 8.

Исправлено: Обновите клиент или коннектор. Изменение учетной записи на mysql_native_password является временным решением; этот плагин устарел.

Часто задаваемые вопросы о строке подключения MySQL

Какой формат строки подключения MySQL?

Это зависит от драйвера. JDBC: jdbc:mysql://host:3306/db?user=...&password=.... ADO.NET: Server=host;Port=3306;Database=db;User ID=user;Password=...;. Go: user:password@tcp(host:3306)/db. MySQL Shell и многие инструменты Node и ORM принимают mysql://user:password@host:3306/db.

Какой порт MySQL используется по умолчанию?

3306 для классического протокола и 33060 для X Protocol (mysqlx://).

Стоит ли использовать useSSL=false?

Нет. useSSL устарел в Connector/J; используйте sslMode. sslMode=DISABLED (что useSSL=false передаёт запросы и результаты в незашифрованном виде. Используйте VERIFY_IDENTITY с CA сервера, где это возможно, или хотя бы REQUIRED.

Безопасен ли allowPublicKeyRetrieval=true?

Только через TLS или в доверенной сети. По умолчанию в MySQL 8 caching_sha2_password нужен либо TLS, либо открытый RSA-ключ сервера, чтобы отправить пароль. Если позволить клиенту получать этот ключ без аутентификации, злоумышленник посередине может подсунуть свой ключ и прочитать пароль. Предпочтительнее TLS (sslMode=REQUIRED или строже).

Нужно ли экранировать пароль в DSN MySQL для Go?

Нет. В документации go-sql-driver/mysql указано, что пароль может содержать любые символы без экранирования; драйвер разделяет на последнем @. Значения параметров запроса должны быть URL-экранированы, а имена параметров чувствительны к регистру (parseTime, а не parsetime).

Почему в JDBC такое большое значение connectTimeout?

У Connector/J connectTimeout и socketTimeout значения в миллисекундах, и по умолчанию оба равны 0, что означает отсутствие лимита. connectTimeout=10000 составляет десять секунд. У MySqlConnector Connection Timeout задаётся в секундах (по умолчанию 15).

// вообще без строк подключения

Подключитесь один раз. А потом просто пишите SQL.

SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для MySQL и других баз данных.