Конструктор строки подключения MySQL
Создавайте URI подключения MySQL, JDBC URL, строку ADO.NET, строку ODBC или DSN для Go из одной формы или вставьте готовую, чтобы увидеть, что делает каждый параметр, и заметить небезопасные настройки вроде allowPublicKeyRetrieval. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений 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; и точное написание.
Communications link failure
Почему: Connector/J не смог завершить общение с сервером: разрыв сети, ошибка TLS handshake, wait_timeout закрытие неактивного соединения из пула или наличие прокси.
Исправлено: Посмотрите на вложенную причину. Для проблем с TLS проверьте sslMode и хранилище доверия; при обрывах из-за простоя установите максимальное время жизни пула ниже серверного wait_timeout.
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 Server
- Строки подключения к PostgreSQL
- Строки подключения к MariaDB
- Строки подключения к SQLite
- Строки подключения к Oracle
- Строки подключения Redis
- Строки подключения ClickHouse
- Строки подключения DuckDB
- Строки подключения libSQL
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для MySQL и других баз данных.