Генератор строк подключения MariaDB
Создавайте JDBC URL для MariaDB, строки ADO.NET или DSN для Go из одной формы или вставьте готовую, чтобы увидеть, что делает каждый параметр и действительно ли проверяется TLS. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений SQLly с заполненными полями.
Открыть это подключение в SQLly
Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.
Форматы строк подключения MariaDB
MariaDB использует протокол MySQL, поэтому драйверы MySQL (MySqlConnector, go-sql-driver/mysql, mysql2) подключаются к ней с помощью тех же строк. Собственный Connector/J MariaDB использует jdbc:mariadb:// и другие sslMode слов, чем у MySQL: disable, trust, verify-ca, verify-full.
Обратите внимание на настройку по умолчанию Connector/J: версия 3.x подключается без TLS, когда sslMode не установлена, а в версии 4.0 настройка по умолчанию была изменена на verify-full, что приводит к ошибке при соединении с сервером с самоподписанным сертификатом.
JDBC MariaDB Connector/J
jdbc:mariadb://db.example.com/sales?user=app_user&password=your_password&sslMode=verify-full
ADO.NET MySqlConnector
Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;
Go DSN github.com/go-sql-driver/mysql
app_user:your_password@tcp(db.example.com)/sales?tls=true
URL SQLAlchemy MariaDB Connector/Python
mariadb+mariadbconnector://app_user:[email protected]/sales
URI SQLly и инструменты в стиле URI
mariadb://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY
Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к MariaDB: SQLly для MariaDB.
Опции MariaDB Connector/J
Формат URL: jdbc:mariadb:[replication:|loadbalance:|sequential:]//host[:port][,...]/[database][?key=value&...]. Connector/J 3.x принимает только jdbc:mysql: с permitMysqlScheme.
| Ключевое слово | Синонимы | По умолчанию | Что оно делает |
|---|---|---|---|
user / password |
- | - | Учётные данные. |
sslMode |
- | disable (3.x); verify-full (4.0+) | disable, trust (шифрование, без проверок), verify-ca, verify-full, и allow (3.5.11+). |
serverSslCert |
- | - | CA или серверный сертификат (путь или PEM) для verify-ca / verify-full. |
connectTimeout |
- | 30000 | Миллисекунды ожидания соединения. |
socketTimeout |
- | 0 | Миллисекунды, в течение которых чтение может блокироваться. |
allowPublicKeyRetrieval |
- | ложь | Запросить RSA-ключ сервера без TLS. |
Опции 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-инъекции. |
Распространённые ошибки подключения к MariaDB
Access denied for user 'app_user'@'10.0.0.7' (using password: YES)
Почему: Неправильный пароль или учётная запись определена для другого шаблона хоста.
Исправлено: Проверить SELECT user, host FROM mysql.user и создайте учётную запись или дайте ей права для хоста, с которого вы подключаетесь.
Could not connect to address=(host=db.example.com)(port=3306)(type=primary) : ... certificate
Почему: Connector/J 4.0+ по умолчанию использует sslMode=verify-full, и сервер предоставляет самоподписанный сертификат или сертификат для другого имени.
Исправлено: Передайте драйверу CA с помощью serverSslCert=/path/ca.pemили используйте сертификат для имени хоста, к которому вы подключаетесь. sslMode=trust шифрует без проверки и предназначен только для доверенных сетей.
Host '10.0.0.7' is not allowed to connect to this MariaDB server
Почему: Под ваше имя пользователя и клиентский хост нет подходящей учётной записи.
Исправлено: Создайте учётную запись для вашего хоста или для шаблона, такого как 'app_user'@'10.0.0.%'.
Unknown database 'sales'
Почему: База данных из строки подключения не существует или написана неверно.
Исправлено: Проверить SHOW DATABASES;.
FAQ по строкам подключения MariaDB
Могу ли я использовать драйвер MySQL с MariaDB?
Да, для обычных случаев. MariaDB сохраняет протокол клиента MySQL, поэтому MySqlConnector, Connector/NET, go-sql-driver/mysql, mysql2 и PyMySQL подключаются с теми же строками. Особенности MariaDB лучше всего поддерживаются собственными коннекторами MariaDB.
Что означает sslMode=trust?
В MariaDB Connector/J это аналог параметра MySQL REQUIRED: соединение шифруется, но сертификат сервера не проверяется. Используйте verify-full с serverSslCert чтобы также проверять сервер.
Какой порт MariaDB используется по умолчанию?
3306, такой же, как у MySQL.
Почему мое JDBC-соединение с MariaDB сломалось после обновления Connector/J?
Connector/J 4.0 изменил sslMode по умолчанию с disable в verify-full. Сервер без TLS или с самоподписанным сертификатом теперь не проходит проверку. Настройте TLS правильно или укажите sslMode явно.
Другие движки
- Строки подключения к SQL Server
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к SQLite
- Строки подключения к Oracle
- Строки подключения Redis
- Строки подключения ClickHouse
- Строки подключения DuckDB
- Строки подключения libSQL
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для MariaDB и других баз данных.