Conexión a base de datos MySQL desde consola (Linux)
No siempre tienes a mano un programa gráfico para ver una base de datos. En un servidor, por ejemplo, solo tienes la terminal. El cliente mysql te deja entrar y mirar lo que hay en un minuto.
Piensa en el servidor MySQL como un archivador: cada base de datos es un cajón, cada tabla es una carpeta dentro del cajón y cada campo es una columna de la ficha. Primero abres el archivador (te conectas), luego eliges cajón (USE) y después miras las carpetas.
Cómo entrar en MySQL desde la consola de Linux
mysql -u root -p
| Opción | Qué hace |
|---|---|
-u root |
Usuario con el que entras (aquí, root) |
-p |
Pide la contraseña sin mostrarla en pantalla |
-h servidor |
Servidor al que te conectas; si no lo pones, es tu propio equipo |
-P 3306 |
Puerto del servidor; 3306 es el habitual |
Escribe la contraseña cuando la pida (no se ve mientras tecleas) y verás el saludo del servidor con su versión:
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 16
Server version: 9.7.4 MySQL Community Server - GPL
Copyright (c) 2000, 2026, Oracle and/or its affiliates.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql>
Puedes entrar directamente en una base de datos poniendo su nombre al final:
mysql -u root -p tienda
Si te da «Access denied» en Ubuntu
Si instalaste MySQL en Ubuntu con apt, el usuario root de MySQL no usa contraseña: entra quien sea root en el sistema. Prueba con:
sudo mysql
Para tus aplicaciones, crea un usuario propio con su contraseña en lugar de usar root.
Si no tienes MySQL instalado
Para practicar sin instalar nada, puedes levantar un MySQL de usar y tirar con Docker. La contraseña es solo para el contenedor:
docker run --rm -d --name mysql-pruebas -e MYSQL_ROOT_PASSWORD=clave-de-prueba mysql:lts
docker exec -it mysql-pruebas mysql -u root -p
Espera unos segundos a que arranque antes del segundo comando. Al terminar, docker stop mysql-pruebas lo para y, por el --rm, lo borra con sus datos.
Cómo ver las bases de datos y tablas de MySQL por consola
Ya dentro, verás el indicador mysql>. Estas son las órdenes más usadas:
SHOW DATABASES; -- lista las bases de datos
USE tienda; -- elige la base de datos "tienda"
SELECT DATABASE(); -- dice en qué base de datos estás
SHOW TABLES; -- lista las tablas de la base elegida
DESCRIBE clientes; -- muestra los campos de la tabla "clientes"
Así responde SHOW DATABASES. Las cuatro primeras son del propio MySQL; la tuya es tienda:
+--------------------+
| Database |
+--------------------+
| information_schema |
| mysql |
| performance_schema |
| sys |
| tienda |
+--------------------+
5 rows in set (0.001 sec)
Si tienes muchas, filtra por el nombre con LIKE (el % vale por cualquier texto). Y para ver las tablas de otra base sin cambiarte, usa FROM:
SHOW DATABASES LIKE 'tien%';
SHOW TABLES FROM tienda;
¿No sabes con qué usuario has entrado o en qué base estás? Pregúntaselo:
SELECT CURRENT_USER(), DATABASE();
+----------------+------------+
| CURRENT_USER() | DATABASE() |
+----------------+------------+
| root@localhost | NULL |
+----------------+------------+
NULL significa que aún no has elegido ninguna con USE.
Así responde DESCRIBE con una tabla de ejemplo:
+--------+--------------+------+-----+---------+----------------+
| Field | Type | Null | Key | Default | Extra |
+--------+--------------+------+-----+---------+----------------+
| id | int | NO | PRI | NULL | auto_increment |
| nombre | varchar(50) | NO | | NULL | |
| email | varchar(100) | YES | | NULL | |
+--------+--------------+------+-----+---------+----------------+
Cada fila es un campo: su nombre, su tipo, si admite vacíos (NULL) y si es la clave principal (PRI).
Hacer consultas
Desde la consola puedes lanzar cualquier orden SQL. Para ver todas las filas de una tabla:
SELECT * FROM clientes;
Si la tabla es grande, limita el resultado:
SELECT * FROM clientes LIMIT 10;
Y si las filas son tan anchas que no caben, termina la consulta con \G en lugar de ; y verás cada fila en vertical:
SELECT * FROM clientes\G
*************************** 1. row ***************************
id: 1
nombre: Ana
email: [email protected]
*************************** 2. row ***************************
id: 2
nombre: Luis
email: NULL
2 rows in set (0.000 sec)
Cuando el indicador cambia
Si pulsas Intro sin el punto y coma, MySQL no ejecuta nada: cree que la orden sigue en la línea siguiente y cambia el indicador. Escribe el ; que falta y se ejecuta:
mysql> SHOW DATABASES
-> ;
| Indicador | Qué espera |
|---|---|
mysql> |
Una orden nueva |
-> |
El resto de la orden: te falta el ; |
'> o "> |
Que cierres una comilla que abriste |
`> |
Que cierres un acento grave (`) |
/*> |
Que cierres un comentario /* |
Para abandonar una orden a medias, escribe \c y vuelves a mysql>. Si estás dentro de una comilla sin cerrar, ciérrala antes, porque el \c se tomaría como parte del texto.
En la consola no hay papelera: lo que borras, se va.
Salir
exit
También vale quit o la combinación Ctrl + D.
Ejecutar una consulta sin entrar
Con -e lanzas una orden y vuelves a la terminal. Útil en scripts:
mysql -u root -p -e "SHOW DATABASES;"
Cuando la salida no va a la pantalla, sino a otro programa o a un fichero, MySQL quita los bordes de la tabla y separa las columnas con tabuladores, más fácil de procesar:
Database
information_schema
mysql
performance_schema
sys
tienda
Añade -N para quitar también la cabecera (Database), o -t si quieres los bordes igualmente.
En un script, la contraseña va en un fichero
En un script nadie puede escribir la contraseña cuando la pide -p, y ponerla pegada (-pclave) es arriesgado: puede verse con ps, al menos un instante, y queda en el historial de la terminal. El manual de MySQL recomienda guardarla en un fichero de opciones que solo puedas leer tú. Crea ~/.my.cnf:
[client]
user=tienda_app
password=tu-contraseña
host=servidor
chmod 600 ~/.my.cnf
mysql tienda -e "SELECT COUNT(*) AS total FROM clientes;"
total
2
El cliente lee el fichero solo, sin -u ni -p. Si quieres tenerlo en otro sitio, pásaselo con --defaults-file=ruta.
Errores frecuentes
1. Contraseña o usuario incorrectos.
ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
using password: YES dice que enviaste una contraseña, pero no es la buena para ese usuario desde ese equipo (localhost). En Ubuntu, mira el apartado de sudo mysql de arriba.
2. El servidor no está arrancado (o no está donde lo buscas). Sin -h, el cliente se conecta por un fichero especial de tu equipo, el socket; con -h 127.0.0.1, por la red. Cada caso da su error:
ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)
ERROR 2003 (HY000): Can't connect to MySQL server on '127.0.0.1:3306' (111)
En los dos, comprueba que el servidor MySQL está en marcha y, en el segundo, que el servidor y el puerto son los correctos.
3. Consultar sin haber elegido base de datos.
mysql> SELECT * FROM clientes;
ERROR 1046 (3D000): No database selected
Haz USE tienda; antes, o escribe la base delante de la tabla: SELECT * FROM tienda.clientes;.
4. Equivocarte en el nombre de la base de datos.
ERROR 1049 (42000): Unknown database 'tiend'
SHOW DATABASES; te dice cómo se llama exactamente.
5. Un error de escritura en la orden. Por ejemplo, SHOW DATABASE; sin la «s» final:
ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'DATABASE' at line 1
La pista está en near '…': el error empieza justo ahí.
6. Una comilla sin cerrar. Si escribes WHERE nombre = 'Ana;, el punto y coma queda dentro del texto y el indicador cambia a '>. Si cierras la comilla con ';, la consulta se ejecuta, pero buscando el nombre Ana; con un salto de línea detrás, y no encuentra nada (Empty set). Para descartarla sin ejecutarla, escribe la comilla de cierre seguida de \c:
mysql> SELECT nombre FROM tienda.clientes WHERE nombre = 'Ana;
'> '\c
mysql>
Cuándo no usar la consola
- Para cambiar datos de producción a mano, sin copia de seguridad ni una consulta probada antes en pruebas. La consola no pide confirmación ni tiene «deshacer».
- Para explorar una base que no conoces, con decenas de tablas y relaciones. Un cliente gráfico te enseña el esquema de un vistazo; la consola brilla cuando ya sabes qué buscar.
- En una aplicación: tu código se conecta con su propio usuario y su librería (en Rails, con
database.yml), nunca lanzando el clientemysql.
Ejercicio de cinco minutos
- Levanta el MySQL de pruebas de Docker y entra con
docker exec -it mysql-pruebas mysql -u root -p. - Crea una base y una tabla:
CREATE DATABASE pruebas;,USE pruebas;yCREATE TABLE notas (id INT AUTO_INCREMENT PRIMARY KEY, texto VARCHAR(100) NOT NULL);. - Inserta dos filas con
INSERT INTO notas (texto) VALUES ('Comprar pan'), ('Llamar al taller');y míralas conSELECT, primero con;y luego con\G. - Comprueba que
SHOW TABLES;listanotas, borra todo conDROP DATABASE pruebas;y verifica conSHOW DATABASES LIKE 'pruebas';que ya no aparece.
Tu chuleta
| Quiero… | Orden |
|---|---|
| Entrar | mysql -u usuario -p |
| Entrar en un servidor remoto | mysql -h servidor -P 3306 -u usuario -p |
| Ver bases de datos | SHOW DATABASES; |
| Elegir una | USE nombre; |
| Ver tablas | SHOW TABLES; |
| Ver campos de una tabla | DESCRIBE tabla; |
| Ver datos | SELECT * FROM tabla LIMIT 10; |
| Saber quién soy y dónde estoy | SELECT CURRENT_USER(), DATABASE(); |
| Cancelar una orden a medias | \c |
| Lanzar una orden sin entrar | mysql -u usuario -p -e "orden;" |
| Salir | exit |
Si usas MariaDB en lugar de MySQL, estas órdenes funcionan igual; su cliente se llama mariadb, aunque muchas distribuciones mantienen también el nombre mysql.
Si el servidor está en otra máquina, primero tendrás que entrar en ella: se explica en Conectarse vía SSH desde Linux. Y si trabajas con Rails, mira cómo configurar la base de datos en Ruby on Rails.
Fuentes
Comprobado el 11 de noviembre de 2026 en el manual oficial de MySQL 9.7, la versión LTS actual: opciones del cliente mysql, indicadores y \c al escribir consultas, SHOW DATABASES, SHOW TABLES, DESCRIBE, DROP TABLE, contraseñas en el cliente (riesgo de -pclave, visible con ps y en el historial, y fichero de opciones con permisos 600) y ficheros de opciones.
Todas las órdenes, salidas y errores se han ejecutado el 11 de noviembre de 2026 con la imagen oficial mysql:lts de Docker (MySQL 9.7.4), incluidos el fichero ~/.my.cnf y los errores 2002 y 2003 con el servidor parado. La versión anterior del artículo se comprobó con mysql:8.4 (MySQL 8.4.13) y las órdenes son las mismas. La entrada de root con auth_socket (y por tanto sudo mysql) se ha comprobado instalando el paquete mysql-server en un contenedor ubuntu:26.04 (MySQL 8.4.11, la versión que trae Ubuntu). El nombre del cliente de MariaDB, en el contenedor mariadb:10.11.