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

Генератор строк подключения MariaDB

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

Открыть это подключение в 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.

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