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.
Abrir esta conexión en SQLly
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 clave | Sinónimos | Predeterminado | Lo 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 clave | Sinónimos | Predeterminado | Lo 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 clave | Sinónimos | Predeterminado | Lo 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.
Otros motores
- Cadenas de conexión de SQL Server
- Cadenas de conexión de PostgreSQL
- Cadenas de conexión de MySQL
- Cadenas de conexión de SQLite
- Cadenas de conexión de Oracle
- Cadenas de conexión de Redis
- Cadenas de conexión de ClickHouse
- Cadenas de conexión de DuckDB
- Cadenas de conexión de libSQL
- Todos los motores y formatos
- Formateador SQL
- Todas las herramientas gratuitas
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.