// herramienta gratuita

Constructor de cadenas de conexión de MariaDB

Construye una URL JDBC de MariaDB, una cadena ADO.NET o un DSN de Go desde un solo formulario, o pega una para ver qué hace cada opción y si realmente se verifica TLS. Todo se ejecuta en tu navegador: nada de lo que escribas se envía a ningún lugar.

Abrir esta conexión en SQLly

Abre el editor de conexiones de SQLly con los datos ya rellenados.

Privado por diseño. El constructor y el decodificador son JavaScript puro que se ejecuta en esta pestaña. La página no envía ninguna solicitud con lo que escribes, no almacena nada (ni siquiera en tu navegador) y sigue funcionando sin conexión una vez cargada. El enlace Abrir en SQLly va directamente desde tu navegador a la aplicación en tu computadora.

Formatos de cadenas de conexión de MariaDB

MariaDB habla el protocolo MySQL, así que los controladores de MySQL (MySqlConnector, go-sql-driver/mysql, mysql2) se conectan con las mismas cadenas. El Connector/J propio de MariaDB usa jdbc:mariadb:// y diferente sslMode palabras que las de MySQL: disable, trust, verify-ca, verify-full.

Ojo con el valor predeterminado del Connector/J: la versión 3.x se conecta sin TLS cuando sslMode no está establecido, y la 4.0 cambió el valor predeterminado a verify-full, que falla ante un servidor con certificado autofirmado.

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 de SQLAlchemy MariaDB Connector/Python

mariadb+mariadbconnector://app_user:[email protected]/sales

URI SQLly y herramientas estilo URI

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

Los marcadores de posición como your_password son eso mismo: construye tu propia cadena con el formulario de arriba. Más sobre cómo conectar SQLly a MariaDB: SQLly para MariaDB.

Opciones de MariaDB Connector/J

Formato de URL: jdbc:mariadb:[replication:|loadbalance:|sequential:]//host[:port][,...]/[database][?key=value&...]. Connector/J 3.x solo acepta jdbc:mysql: con permitMysqlScheme.

Palabra claveSinónimosPredeterminadoLo que hace
user / password - - Credenciales.
sslMode - desactivar (3.x); verify-full (4.0+) disable, trust (cifrar, sin verificaciones), verify-ca, verify-full, y allow (3.5.11+).
serverSslCert - - Certificado CA o del servidor (ruta o PEM) para verify-ca / verify-full.
connectTimeout - 30000 Milisegundos para esperar la conexión.
socketTimeout - 0 Milisegundos durante los que una lectura puede bloquearse.
allowPublicKeyRetrieval - falso Solicitar la clave RSA del servidor sin TLS.

Opciones de MySqlConnector (ADO.NET)

MySqlConnector y Connector/NET de Oracle (MySql.Data) comparten la mayoría de las palabras clave. Los valores con ; van entre comillas dobles.

Palabra claveSinónimosPredeterminadoLo que hace
Server Host, Fuente de datos, Dirección localhost Host, lista separada por comas o una ruta de socket de Unix.
Port - 3306 Puerto TCP.
User ID UID, Usuario, Nombre de usuario - Nombre de usuario.
Password PWD - Contraseña.
Database Initial Catalog - Esquema predeterminado.
SslMode Modo SSL Preferido None/Disabled, Preferred, Required, VerifyCA, VerifyFull.
SslCa Archivo de certificado CA, Ssl-Ca - Archivo CA para VerifyCA / VerifyFull.
Connection Timeout Tiempo de espera de conexión 15 Segundos.
Default Command Timeout Tiempo de espera del comando 30 Segundos; 0 espera indefinidamente.
Application Name - - Establece el program_name atributo de conexión.
AllowPublicKeyRetrieval - falso Consulta la advertencia anterior.
AllowUserVariables - falso Permitir @variables en SQL.
Pooling - verdadero Agrupación de conexiones.
Maximum Pool Size Tamaño máximo del grupo 100 Pool más grande.
Minimum Pool Size Tamaño mínimo del grupo 0 Pool más pequeño.

go-sql-driver/mysql DSN

Formulario: [user[:password]@][protocol[(address)]]/dbname[?param=value&...]. La contraseña no necesita escape; el nombre de la base de datos se escapa como ruta (1.8+); los valores de los parámetros se escapan en la consulta; los nombres de los parámetros distinguen mayúsculas de minúsculas.

Palabra claveSinónimosPredeterminadoLo que hace
tcp(host:port) unix(/ruta) tcp(127.0.0.1:3306) Dirección; el puerto por defecto es 3306.
tls - falso true (verificar), false, skip-verify (cifrar, sin verificaciones), preferred, o un nombre de configuración registrado.
timeout - Predeterminado del sistema operativo Tiempo de espera de conexión con una unidad: 10s.
readTimeout / writeTimeout - 0 Tiempos de espera de E/S con una unidad.
parseTime - falso Escanear DATE y DATETIME en time.Time.
loc - UTC Zona horaria para time.Time valores (escapar / como %2F).
collation - utf8mb4_general_ci Intercalación de la conexión.
allowCleartextPasswords - falso Enviar la contraseña en claro (solo sobre TLS).
multiStatements - falso Varias instrucciones por consulta; amplía el impacto de la inyección SQL.

Errores comunes de conexión a MariaDB

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

Por qué: Contraseña incorrecta, o la cuenta está definida para otro patrón de host.

Solución: Comprobar SELECT user, host FROM mysql.user y crear u otorgar la cuenta para el host desde el que te conectas.

Could not connect to address=(host=db.example.com)(port=3306)(type=primary) : ... certificate

Por qué: Connector/J 4.0+ usa por defecto sslMode=verify-full, y el servidor presenta un certificado autofirmado o uno emitido para otro nombre.

Solución: Dale al controlador la CA con serverSslCert=/path/ca.pem, o usa un certificado para el nombre del host al que te conectas. sslMode=trust cifra sin verificar y es solo para redes confiables.

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

Por qué: Ninguna cuenta coincide con tu nombre de usuario y el host del cliente.

Solución: Crea la cuenta para tu host o un patrón como 'app_user'@'10.0.0.%'.

Unknown database 'sales'

Por qué: La base de datos de la cadena no existe o el nombre está escrito de otra forma.

Solución: Comprobar SHOW DATABASES;.

Preguntas frecuentes sobre la cadena de conexión de MariaDB

¿Puedo usar un controlador de MySQL con MariaDB?

Sí, para los casos comunes. MariaDB mantiene el protocolo de cliente de MySQL, así que MySqlConnector, Connector/NET, go-sql-driver/mysql, mysql2 y PyMySQL se conectan con las mismas cadenas. Las funciones específicas de MariaDB se cubren mejor con los conectores propios de MariaDB.

¿Qué significa sslMode=trust?

Es el equivalente, en MariaDB Connector/J, de lo que en MySQL es REQUIRED: la conexión está cifrada, pero el certificado del servidor no se comprueba. Usa verify-full con serverSslCert para verificar también el servidor.

¿Cuál es el puerto predeterminado de MariaDB?

3306, el mismo que MySQL.

¿Por qué se rompió mi conexión JDBC de MariaDB después de actualizar Connector/J?

Connector/J 4.0 cambió el sslMode predeterminado de disable a verify-full. Un servidor sin TLS, o con un certificado autofirmado, ahora falla. Configura TLS como es debido, o establece sslMode explícitamente.

// olvídate de las cadenas por completo

Conéctate una vez. Luego solo escribe SQL.

SQLly es un entorno de trabajo SQL nativo para macOS, Windows y Linux. Pega una cadena de conexión en su editor de conexiones, guarda las contraseñas en el llavero del sistema y obtén IntelliSense que entiende el esquema en MariaDB, entre otros.