// herramienta gratuita

Constructor de cadenas de conexión de MySQL

Construye un URI de conexión MySQL, URL JDBC, cadena ADO.NET, cadena ODBC o DSN de Go desde un formulario, o pega uno para ver qué hace cada opción y detectar configuraciones inseguras como allowPublicKeyRetrieval. 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 cadena de conexión de MySQL

MySQL no tiene un estándar único de cadena de conexión. Connector/J usa una URL JDBC con propiedades en camelCase (sslMode, connectTimeout en milisegundos), MySqlConnector y Connector/NET usan cadenas ADO.NET Server=...; cadenas, Connector/ODBC usa las palabras clave de ODBC, el driver de Go tiene las suyas propias user:pass@tcp(host:3306)/db DSN, y MySQL Shell acepta un URI con ssl-mode.

TLS usa por defecto PREFERRED casi en todas partes: cifrado cuando el servidor lo soporta, pero el certificado no se verifica. VERIFY_IDENTITY (MySqlConnector: VerifyFull) comprueba la CA y el nombre del host.

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 de SQLAlchemy Python SQLAlchemy con PyMySQL

mysql+pymysql://app_user:[email protected]/sales?charset=utf8mb4

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 MySQL: SQLly para MySQL.

Propiedades de MySQL Connector/J

Formato de URL: jdbc:mysql://[host][:port][/database][?property=value&...]. Aplica codificación porcentual a los caracteres reservados (/ : @ ( ) [ ] & # = ? y espacio) en todas partes, incluyendo el usuario y la contraseña.

Palabra claveSinónimosPredeterminadoLo que hace
user / password - - Credenciales.
sslMode - PREFERRED DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY.
useSSL / requireSSL / verifyServerCertificate - - Obsoleto; todavía traducido (useSSL=false = DISABLED). sslMode gana.
connectTimeout - 0 (ninguno) Milisegundos para esperar a que el socket se conecte.
socketTimeout - 0 (ninguno) Milisegundos durante los que una lectura puede bloquearse.
allowPublicKeyRetrieval - falso Permitir que el cliente solicite la clave RSA del servidor para caching_sha2_password sin TLS.
connectionTimeZone serverTimezone LOCAL LOCAL, SERVER o un ID de zona.
characterEncoding - utf8mb4 (8.0.26+) Conjunto de caracteres de Java.
trustCertificateKeyStoreUrl - - Almacén de confianza con la CA del servidor, para VERIFY_CA / VERIFY_IDENTITY.
rewriteBatchedStatements - falso Reescribe los INSERT por lotes en instrucciones de varias filas.

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.

Palabras clave de MySQL Connector/ODBC

Las palabras clave no distinguen entre mayúsculas y minúsculas. El nombre del controlador debe coincidir con lo que registró tu administrador ODBC, que incluye la versión.

Palabra claveSinónimosPredeterminadoLo que hace
Driver - - por ejemplo. {MySQL ODBC 8.0 Unicode Driver}.
Server - localhost Host.
Port - 3306 Puerto TCP.
Database - - Esquema predeterminado.
User UID - Nombre de usuario.
Password PWD - Contraseña.
SSLMODE ssl-mode (8.0.29+) PREFERRED DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY.

Errores comunes de conexión a MySQL

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

Por qué: Error 1045: contraseña incorrecta, o la cuenta existe para otro patrón de host ('app_user'@'localhost' es una cuenta diferente de 'app_user'@'%').

Solución: Comprueba la contraseña y SELECT user, host FROM mysql.user; crea o concede la cuenta para el host desde el que te conectas.

Public Key Retrieval is not allowed

Por qué: Connector/J con MySQL 8 caching_sha2_password en una conexión sin TLS: el controlador necesita la clave RSA del servidor para enviar la contraseña y no se le permite solicitarla.

Solución: Usa TLS (sslMode=REQUIRED o más fuerte). allowPublicKeyRetrieval=true también funciona, pero queda expuesto a un atacante intermedio en una red no confiable.

Can't connect to MySQL server on 'db.example.com:3306' (110)

Por qué: Error 2003: el servidor no es accesible: host o puerto incorrectos, bind-address limitado a 127.0.0.1, o un firewall. (111 significa conexión rechazada, 110 un tiempo de espera.)

Solución: Comprobar bind-address y port en my.cnf, el firewall y el grupo de seguridad en la nube, y luego prueba con nc -vz db.example.com 3306.

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

Por qué: Error 1130: ninguna cuenta coincide con ese nombre de usuario para el host de tu cliente.

Solución: Crea la cuenta para tu host o un patrón: CREATE USER 'app_user'@'10.0.0.%' ... y concédale los privilegios que necesite.

Unknown database 'sales'

Por qué: Error 1049: el esquema de la cadena no existe, o su nombre no coincide en mayúsculas y minúsculas en un servidor que distingue mayúsculas de minúsculas en los nombres de tabla.

Solución: Comprobar SHOW DATABASES; y la ortografía exacta.

Authentication plugin 'caching_sha2_password' cannot be loaded

Por qué: Una biblioteca cliente antigua, anterior al plugin de autenticación predeterminado de MySQL 8.

Solución: Actualiza el cliente o conector. Cambia la cuenta a mysql_native_password es una medida provisional; ese complemento está obsoleto.

FAQ de la cadena de conexión de MySQL

¿Cuál es el formato de la cadena de conexión de MySQL?

Depende del controlador. 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 y muchas herramientas de Node y de ORM usan mysql://user:password@host:3306/db.

¿Cuál es el puerto predeterminado de MySQL?

3306 para el protocolo clásico y 33060 para el protocolo X (mysqlx://).

¿Debo usar useSSL=false?

No. useSSL está obsoleto en Connector/J; usa sslMode. sslMode=DISABLED (lo que useSSL=false mapea) envía consultas y resultados en texto plano. Usa VERIFY_IDENTITY con la CA del servidor cuando puedas, o al menos REQUIRED.

¿Es seguro allowPublicKeyRetrieval=true?

Solo sobre TLS o una red de confianza. El valor predeterminado de MySQL 8 caching_sha2_password requiere TLS o la clave pública RSA del servidor para enviar la contraseña. Permitir que el cliente obtenga esa clave sin autenticación significa que un atacante en el medio puede entregar su propia clave y leer la contraseña. Prefiere TLS (sslMode=REQUIRED o más fuerte).

¿Necesito escapar la contraseña en un DSN de MySQL en Go?

No. go-sql-driver/mysql documenta que la contraseña puede contener cualquier carácter sin necesidad de escapar; el controlador corta en el último @. Los valores de los parámetros de consulta deben ir escapados para URL, y los nombres de los parámetros distinguen mayúsculas de minúsculas (parseTime, no parsetime).

¿Por qué connectTimeout es tan alto en JDBC?

Connector/J's connectTimeout y socketTimeout están en milisegundos, y ambos valen 0 por defecto, es decir, sin límite. connectTimeout=10000 es de diez segundos. En MySqlConnector, Connection Timeout está en segundos (15 por defecto).

// 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 MySQL, entre otros.