Curso de MariaDB / Diagnosticar conexiones locales, remotas y sus errores

Para diagnosticar una conexión a MariaDB, compruebe en orden el acceso al servidor, la dirección y el protocolo, la cuenta que coincide, la autenticación y los permisos de la base. El acceso remoto requiere además un punto de escucha adecuado, reglas de red, un host de cuenta compatible y cifrado verificado; empiece por una conexión TCP local conocida.

Separar el cliente, el servidor y la ruta de red

Tener instalado un cliente no demuestra que el servidor esté en ejecución. Un controlador ODBC, que permite conectar aplicaciones mediante esa interfaz, tampoco implica que haya instalado el servidor o el cliente de línea de comandos. Revise los paquetes, el servicio y la ruta del ejecutable con la guía de instalación en Windows o la guía de instalación en Ubuntu.

Después de conectar, revise por separado qué operaciones puede realizar mediante la práctica de usuarios y permisos limitados. Instalar software, abrir una ruta de red y autorizar una consulta son comprobaciones diferentes.

Síntoma Qué revisar primero No confundirlo con
Comando no encontrado Ejecutable del cliente y PATH Un fallo de contraseña
Conexión rechazada o tiempo agotado Servidor, dirección, puerto y ruta Algo que GRANT resuelve por sí solo
Access denied Usuario, host y autenticación Una contraseña incorrecta en todos los casos
Unknown database Servidor real y nombre de la base Un problema de tabla
Error de verificación TLS Nombre del servidor, autoridad y certificado Un motivo para desactivar la verificación por rutina

Fijar explícitamente la conexión TCP local

Este comando supone que el cliente y el servidor están en el mismo equipo y que el servidor escucha en el puerto 3306. Cambie el puerto si su configuración utiliza otro. Ejecútelo en la terminal del sistema operativo e introduzca la contraseña cuando se solicite, sin escribirla en el argumento.

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 shopcourse

Después de entrar en el cliente, ejecute:

SELECT VERSION(),@@hostname,@@port,DATABASE();
SELECT USER(),CURRENT_USER();
SHOW GRANTS;

Compruebe la versión, el host, el puerto, la base seleccionada y CURRENT_USER, que identifica la cuenta empleada para comprobar permisos. USER muestra el usuario y origen de conexión y no tiene por qué coincidir siempre con aquella cuenta. Revise SHOW GRANTS de forma privada: puede contener datos de autenticación que no debe publicar.

Según la plataforma y las opciones, localhost puede implicar un socket, una canalización con nombre o TCP. El comando elige expresamente TCP y 127.0.0.1 para quitar esa ambigüedad. La referencia oficial del cliente mariadb describe sus opciones de conexión.

Comprobar acceso real a los datos tras autenticarse

Verifique SELECT VERSION(), DATABASE(); y SHOW TABLES; y confirme que products_44_lab no está en uso. Si ya existe, revise sus datos y definición antes de decidir si es prescindible. Con una cuenta de prácticas que tenga los permisos necesarios, cree el ejemplo independiente siguiente; no reemplace una tabla de la aplicación.

USE shopcourse;
CREATE TABLE products_44_lab (
  product_id INT NOT NULL AUTO_INCREMENT,
  product_name VARCHAR(100) NOT NULL,
  category VARCHAR(30) NOT NULL,
  price DECIMAL(10,2) NOT NULL,
  stock INT NOT NULL DEFAULT 0,
  note VARCHAR(100) NULL DEFAULT NULL,
  PRIMARY KEY (product_id),
  CONSTRAINT ck_p44_price CHECK (price >= 0),
  CONSTRAINT ck_p44_stock CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_44_lab (product_id,product_name,category,price,stock,note) VALUES (1, '노트', '문구', 3500.00, 20, NULL),
  (2, '볼펜', '문구', 1500.00, 0, ''),
  (3, '머그컵', '생활', 8000.00, 12, '선물 포장'),
  (4, '스탠드', '생활', 25000.00, 5, NULL),
  (5, '파일', '문구', 1500.00, 50, ''),
  (6, '케이블', '전자', 8000.00, 0, '호환 확인');

Se mantienen los textos originales en coreano para practicar UTF-8. Los ID 1–6 representan un cuaderno, un bolígrafo, una taza, una lámpara, una carpeta y un cable. Las categorías significan papelería, hogar y electrónica. Introduzca los literales como aparecen, utilice los ID para comparar y guarde el archivo como UTF-8 si lo ejecuta con SOURCE.

SELECT COUNT(*) FROM products_44_lab;

El recuento debe ser seis. SELECT 1 puede funcionar sin demostrar acceso a la tabla que necesita la aplicación: pruebe las operaciones realmente requeridas. Conserve los códigos de error y mensajes depurados, sin exponer credenciales en registros o capturas.

Limitar la escucha remota a la ruta necesaria

Confirme con la administración la dirección privada real del servidor, el puerto, el origen permitido del cliente y la política TLS (seguridad de la capa de transporte). En paquetes de Ubuntu puede utilizarse /etc/mysql/mariadb.conf.d/50-server.cnf, pero las rutas varían. Respalde el archivo y compruebe que el servidor en ejecución lo lee antes de modificar su sección.

[mariadbd]
bind-address = 10.0.0.10
port = 3306

10.0.0.10 es un ejemplo de dirección privada, no una dirección garantizada en su equipo. Utilice una interfaz real del servidor y limite los orígenes del cliente tanto en la red como en la definición de cuenta. Planifique la interrupción del reinicio y cómo recuperar los valores anteriores. Que el servidor acepte paquetes no demuestra que el host de la cuenta coincida.

La guía oficial de acceso remoto a MariaDB explica la escucha, las cuentas y las reglas de red. No convierta una escucha amplia ni un host comodín en la solución predeterminada de cualquier error.

Verificar el certificado y la cuenta en la conexión remota

El comando siguiente necesita un servidor real cuyo nombre se resuelva y un archivo de una autoridad certificadora de confianza. Sustituya db.example.internal y la ruta del archivo; el nombre del servidor debe coincidir con su certificado. Ejecute el comando en la terminal, no dentro del cliente SQL.

mariadb --protocol=tcp --host=db.example.internal --port=3306 --user=app_user --password --ssl --ssl-verify-server-cert --ssl-ca=C:/mariadb-lab/ca.pem

Las opciones solicitan cifrado y verificación del certificado del servidor con la autoridad indicada. Si falla, revise el nombre, la cadena de confianza, la ruta del archivo y la compatibilidad de las versiones; no desactive la verificación para ocultar el problema. El éxito de una conexión local no acredita la ruta remota ni la configuración TLS.

Un túnel SSH o una VPN aprobados pueden ofrecer otra ruta, pero debe revisar qué origen ve el servidor y qué cuenta resulta seleccionada. Esas rutas no eliminan la necesidad de comprender los permisos y la identidad del destino.

Registrar la etapa del fallo y las modificaciones reversibles

Si el servidor no es alcanzable, revise la resolución del nombre, la dirección del cliente, la interfaz de escucha, el puerto y el cortafuegos. Cuando sea alcanzable, investigue la coincidencia de Host, el método de autenticación y las credenciales. Una base desconocida o la falta de permiso sobre una tabla corresponden a etapas posteriores.

Registre qué configuración modificó, sus valores originales y los reinicios realizados, conservando la forma de volver a la política anterior. Revise el contenido de la tabla local y elimínela solo si sigue siendo un objeto prescindible de prácticas. DROP TABLE borra estructura y datos y no se revierte mediante un ROLLBACK ordinario.

DROP TABLE shopcourse.products_44_lab;