Curso de MariaDB / Conectarse con el cliente y ejecutar archivos SQL con SOURCE

Inicie la conexión MariaDB desde el terminal y escriba las instrucciones SQL dentro del cliente conectado. Para ejecutar un archivo SQL guardado en UTF-8, use el comando SOURCE del cliente con una ruta del equipo donde se ejecuta ese cliente; la ruta no corresponde al sistema de archivos del servidor de base de datos.

Preparar el servidor, la cuenta y el archivo

Complete la instalación en Windows o la instalación en Ubuntu y compruebe que el servidor funciona. Los ejemplos comunes utilizan la cuenta de aprendizaje y los valores de conexión siguientes. Sustituya el puerto si eligió otro de forma deliberada. La introducción al servidor y al cliente MariaDB explica por qué iniciar el programa cliente y seleccionar una base son acciones diferentes.

Elemento Valor o comprobación
Protocolo y host TCP a 127.0.0.1
Puerto 3306, salvo que su instancia use otro
Cuenta course_user con la contraseña que eligió
Juego de caracteres de la conexión utf8mb4
Archivo SQL Texto UTF-8 con extensión .sql, no .sql.txt

El terminal inicia el cliente mariadb y SOURCE lee un archivo SQL del equipo del cliente; el servidor ejecuta las instrucciones y el cliente muestra los resultados

El intérprete del terminal ejecuta el programa cliente; el cliente conectado transmite SQL al servidor. El propio cliente interpreta SOURCE, lee el archivo local y envía sus instrucciones. Confundir estas capas puede llevar a escribir un comando correcto en el lugar equivocado. Por ejemplo, el comando mariadb se ejecuta en el terminal y un SELECT se introduce después de conectar.

Conectarse desde el terminal y comprobar la sesión

Ejecute lo siguiente en el terminal, fuera de una conexión MariaDB ya abierta:

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
Opción Función
--protocol=tcp Usar TCP explícitamente en lugar de un socket local
--host y --port Seleccionar el servidor y su puerto
--user Indicar el nombre de usuario MariaDB
--password Solicitar la contraseña sin escribirla en el comando
--default-character-set=utf8mb4 Configurar el juego de caracteres de la conexión cliente
--abort-source-on-error Detener el resto del archivo SOURCE cuando aparece un error

En Windows, si no se encuentra mariadb, utilice MariaDB Command Prompt de la instalación o la ruta completa al ejecutable explicada en la guía de Windows. El indicador MariaDB [(none)]> significa que la conexión no tiene una base predeterminada seleccionada; por sí solo no indica un fallo de autenticación.

Dentro del cliente, ejecute:

SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
       CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;

El servidor devuelve su versión, la información de cuenta, un total de 5 y el saludo Hello, café. El carácter acentuado permite comprobar de forma sencilla la codificación. USER() describe la identidad de conexión y CURRENT_USER() identifica la cuenta utilizada para comprobar privilegios. La referencia oficial del cliente de línea de comandos define las opciones y los comandos.

Terminar, cancelar o mostrar una instrucción

Una instrucción SQL puede ocupar varias líneas. El cliente espera hasta que esté completa, normalmente marcada con punto y coma:

SELECT
  10 + 20 AS total;

El resultado es 30. Si todavía está escribiendo una instrucción incompleta y quiere descartarla, introduzca este comando del cliente:

\c

Para mostrar un resultado en vertical, utilice el terminador del cliente \G en lugar del punto y coma:

SELECT VERSION() AS server_version\G

\c y \G son convenciones del cliente, no sintaxis SQL general aceptada por todas las herramientas. Use \q para salir de la conexión. Desconectarse no detiene el servidor MariaDB ni elimina sus datos.

Guardar un archivo SQL completo en UTF-8

Cree un archivo de texto plano llamado lesson04-check.sql con todo este contenido:

SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
       CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;

Guárdelo con la codificación UTF-8 del editor y compruebe la extensión real. Windows puede ocultar extensiones y dejar un nombre como lesson04-check.sql.txt. Use un directorio que controle, por ejemplo C:\mariadb-course\ en Windows o /home/yourname/mariadb-course/ en Ubuntu. Sustituya yourname por el componente real de su ruta.

El archivo contiene instrucciones; no es una copia de seguridad de una base. Guardarlo no ejecuta ninguna consulta. Su ruta es una ubicación de archivos en el equipo cliente, mientras que 127.0.0.1:3306 identifica el extremo de conexión del servidor.

Ejecutar SOURCE y comprobar los resultados

Después de conectar, use en Windows la ruta con barras normales:

SOURCE C:/mariadb-course/lesson04-check.sql;

En Ubuntu, use la ruta real de ese equipo:

SOURCE /home/yourname/mariadb-course/lesson04-check.sql;

Son alternativas, no dos comandos que deba ejecutar seguidos. El cliente debe mostrar los mismos tres resultados de consulta, incluido el total 5 y el saludo sin alteraciones. Este archivo solo consulta valores: repetirlo no añade ni elimina filas de tablas. Esa propiedad no se puede trasladar sin revisar el contenido a un archivo que cree tablas o inserte datos.

Si el cliente y el servidor están en ordenadores diferentes, SOURCE sigue leyendo un archivo del equipo cliente. Con --abort-source-on-error, un error detiene el resto del archivo fuente. Esto no revierte las instrucciones que ya tuvieron éxito ni convierte las creaciones de tablas en operaciones recuperables con un rollback.

Resolver errores de archivo, codificación y SQL

  • Archivo no encontrado: compruebe la ruta completa, su escritura, los permisos y que la extensión sea realmente .sql.
  • Texto ilegible: revise el UTF-8 del archivo, el juego de caracteres de la conexión y la codificación de presentación del terminal.
  • Access denied: revise la cuenta y los permisos; no es lo mismo que un archivo ausente.
  • Error a mitad del archivo: examine lo que ya se ejecutó antes de repetir un archivo que modifica datos.

En Windows, si el problema está en la codificación de presentación del terminal, salga del cliente MariaDB y ejecute lo siguiente en el terminal antes de volver a conectar con la opción UTF-8:

chcp 65001

Cuando sea necesario, examine las variables de caracteres dentro de la conexión:

SHOW VARIABLES LIKE 'character_set_%';

Cambiar una opción de conexión no repara automáticamente texto guardado antes con una codificación incorrecta. Localice el origen del problema antes de modificar datos almacenados. Mantenga los comandos del terminal, los comandos del cliente y el SQL en sus contextos de ejecución correspondientes.