Curso de MariaDB / Crear una copia de seguridad con mariadb-dump

mariadb-dump crea una copia lógica con sentencias SQL que permiten reconstruir definiciones y filas. Elija opciones de lectura coherente y una ruta explícita, revise los errores y compruebe una restauración en otra base: la existencia del archivo no demuestra que la copia sea recuperable.

Definir el alcance y los objetivos de recuperación

Este ejercicio copia cuatro tablas InnoDB de una base independiente, backup46_lab. No constituye una copia completa de las cuentas, la configuración ni los archivos externos de una instancia. La pérdida de datos aceptable y el tiempo necesario para recuperar el servicio influyen en la frecuencia, el almacenamiento y los registros adicionales que deba conservar.

Área Este ejercicio Qué revisar además
Datos Cuatro tablas InnoDB Otros motores, volumen y cambios estructurales concurrentes
Objetos Tablas base y claves Vistas, definidores, rutinas, disparadores y eventos
Cuentas y configuración Fuera de esta copia de base Procedimientos de recuperación propios
Verificación Restaurar en otra base vacía Filas, restricciones, importes y acceso

Pasos: base de origen, archivo SQL, restauración en otra base vacía y comparación del esquema, las filas, las restricciones y los importes

El archivo es una etapa del proceso: revise su contenido, restaure sin apuntar al origen y compare. Incluso si los datos están en un volumen de contenedor, necesita una estrategia de copia separada. La referencia oficial de mariadb-dump describe los formatos y las opciones.

Crear una base de origen independiente

En una conexión administrativa al servidor de prácticas, revise SELECT VERSION(); y SHOW DATABASES. Confirme que backup46_lab no existe. Si existe, deténgase y elija otro nombre exclusivo adaptando los bloques; no reemplace ni elimine datos para ejecutar el ejemplo. La definición y los registros completos siguientes hacen que la práctica sea independiente.

CREATE DATABASE backup46_lab CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE backup46_lab;
CREATE TABLE c46_customers (
 customer_id INT NOT NULL PRIMARY KEY,
 customer_name VARCHAR(50) NOT NULL,
 city VARCHAR(30) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c46_products (
 product_id INT NOT NULL PRIMARY KEY,
 product_name VARCHAR(100) NOT NULL,
 category VARCHAR(30) NOT NULL,
 price DECIMAL(10,2) NOT NULL CHECK (price >= 0),
 stock INT NOT NULL CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c46_orders (
 order_id INT NOT NULL PRIMARY KEY,
 customer_id INT NOT NULL,
 ordered_at DATETIME NOT NULL,
 status VARCHAR(20) NOT NULL,
 shipping_fee DECIMAL(10,2) NOT NULL DEFAULT 1000,
 CONSTRAINT fk_c46_order_customer FOREIGN KEY (customer_id)
  REFERENCES c46_customers(customer_id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c46_items (
 order_id INT NOT NULL,
 product_id INT NOT NULL,
 quantity INT NOT NULL CHECK (quantity > 0),
 unit_price DECIMAL(10,2) NOT NULL CHECK (unit_price >= 0),
 PRIMARY KEY (order_id, product_id),
 CONSTRAINT fk_c46_item_order FOREIGN KEY (order_id)
  REFERENCES c46_orders(order_id) ON DELETE RESTRICT,
 CONSTRAINT fk_c46_item_product FOREIGN KEY (product_id)
  REFERENCES c46_products(product_id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO c46_customers VALUES
 (1,'김민수','서울'),(2,'이서연','부산'),
 (3,'박지우','서울'),(4,'최하늘','대전');
INSERT INTO c46_products VALUES
 (1,'노트','문구',3500,20),(2,'볼펜','문구',1500,50),
 (3,'머그컵','생활',8000,12),(4,'스탠드','생활',25000,5);
INSERT INTO c46_orders
 (order_id,customer_id,ordered_at,status,shipping_fee) VALUES
 (101,1,'2026-01-10 10:00:00','paid',1000),
 (102,1,'2026-01-20 11:00:00','paid',1000),
 (103,2,'2026-02-05 12:00:00','paid',1000),
 (104,3,'2026-02-10 13:00:00','canceled',1000);
INSERT INTO c46_items VALUES
 (101,1,2,3500),(101,2,3,1500),(102,3,1,8000),
 (103,1,1,3500),(103,3,2,8000),(104,2,1,1500);

Se mantienen los nombres y las ciudades originales en coreano. Los productos 1–4 son un cuaderno, un bolígrafo, una taza y una lámpara. Los clientes 1 y 3 viven en Seúl; el 2 en Busan y el 4 en Daejeon. Conserve estos literales UTF-8 al reproducir el ejercicio.

Los permisos de course_user sobre shopcourse no le dan acceso automáticamente a esta base nueva. La administración debe asignarle el alcance requerido. ALL se limita aquí a la base desechable del ejercicio; una cuenta operativa de copias debe recibir permisos ajustados a sus objetos y opciones.

GRANT ALL PRIVILEGES ON backup46_lab.* TO 'course_user'@'127.0.0.1';

Comprobar versiones, archivo nuevo y estado de salida

Utilice mariadb-dump desde el directorio bin instalado o desde PATH. Los comandos siguientes se ejecutan en la terminal del sistema operativo, no dentro del cliente SQL. La guía del cliente de línea de comandos ayuda a distinguir ambos contextos. Compruebe las versiones de las dos herramientas:

mariadb-dump --version
mariadb --version

En Windows PowerShell, ejecute el bloque completo siguiente. --result-file hace que la herramienta escriba directamente el archivo y evita diferencias de codificación de la redirección de salida de PowerShell. Ajuste puerto, rutas y cuenta según el servidor de prácticas.

New-Item -ItemType Directory -Path 'C:/mariadb-lab' -Force | Out-Null
$backup46Path='C:/mariadb-lab/backup46-first.sql'
if (Test-Path -LiteralPath $backup46Path) { throw 'Choose a new backup filename.' }
mariadb-dump --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --single-transaction --quick --skip-lock-tables --result-file=C:/mariadb-lab/backup46-first.sql backup46_lab
if ($LASTEXITCODE -ne 0) { throw 'Backup failed: inspect the error and verify the file.' }
Get-Item -LiteralPath $backup46Path | Select-Object Name,Length
Get-FileHash -LiteralPath $backup46Path -Algorithm SHA256

Introduzca la contraseña cuando se solicite, sin añadirla al argumento. El bloque se detiene si el archivo ya existe o si la herramienta devuelve un código de fallo. Un error puede dejar un archivo vacío o parcial: no lo restaure como si fuera una copia completa. Un tamaño distinto de cero y una huella SHA-256 permiten identificar el archivo, pero no demuestran que pueda recuperar la base.

Alternativa para una terminal de Ubuntu: elija este bloque o el de PowerShell según su equipo cliente. El subshell limita a la operación las opciones de permisos restrictivos y de no sobrescritura.

mkdir -p "$HOME/mariadb-lab"
(
  umask 077
  set -C
  backup_file="$HOME/mariadb-lab/backup46-first.sql"
  if mariadb-dump --protocol=tcp --host=127.0.0.1 --port=3306 \
      --user=course_user --password --default-character-set=utf8mb4 \
      --single-transaction --quick --skip-lock-tables backup46_lab > "$backup_file"; then
    test -s "$backup_file" || exit 1
    sha256sum "$backup_file"
  else
    printf '%s\n' 'Backup failed; preserve the partial file for diagnosis.' >&2
    exit 1
  fi
)

Un destino existente provoca un fallo en lugar de sobrescribirlo. Conserve un archivo parcial para diagnosticar el error y reintente con un nombre nuevo después de corregirlo. La huella permite comprobar que una copia posterior tiene los mismos bytes; la recuperación necesita además la prueba de restauración.

Ante errores TLS, revise las versiones de cliente y servidor, el nombre del certificado, la autoridad de confianza y cualquier certificado de cliente requerido. Aplique la configuración apropiada a las herramientas de copia y restauración, siguiendo los requisitos oficiales de conexiones cifradas. La guía de conexiones locales y remotas ayuda a localizar la etapa del fallo. No desactive la verificación como solución rutinaria.

Comprender las condiciones de la instantánea coherente

--single-transaction permite una lectura coherente de tablas transaccionales como InnoDB. Coordine ALTER, CREATE, DROP, RENAME y TRUNCATE concurrentes porque pueden interferir con las condiciones de la copia. Esta opción no concede la misma garantía a motores no transaccionales.

--quick obtiene las filas progresivamente. --skip-lock-tables hace explícita la elección sobre bloqueos de tablas en este comando; no significa que la copia carezca de carga, bloqueos o tráfico de red. Se omite --databases para facilitar la restauración de estas tablas en una base con otro nombre, pero revise siempre el contenido efectivo del SQL antes de importarlo.

Inventariar otros objetos y proteger el contenido

Este ejemplo no contiene vistas, rutinas, eventos ni disparadores. En una base real, inventáríelos y revise las opciones y permisos de la versión utilizada, los atributos DEFINER y el contexto en que se ejecutarán tras restaurar. Valore --routines y --events cuando correspondan e inspeccione la salida real de los disparadores, sin inferir que todas las dependencias se copiaron por el nombre de una opción.

El archivo contiene definiciones y datos del negocio. Aplique control de acceso, cifrado, conservación y copias en un ámbito de fallo distinto según su política. Un archivo situado únicamente en el mismo disco no protege frente a la pérdida de ese disco; no almacene volcados en un repositorio público ni en un directorio web.

Conservar el origen hasta verificar la restauración

Conserve el origen y el archivo hasta comprobar una restauración en otra base vacía. Compare la estructura, todas las filas, las claves y los importes, no solo el mensaje de importación correcta. El punto de referencia del ejemplo es cuatro clientes, cuatro productos, cuatro pedidos, seis líneas y 39000 en productos de pedidos pagados.

SELECT SUM(i.quantity*i.unit_price) AS paid_goods
FROM backup46_lab.c46_orders o
JOIN backup46_lab.c46_items i ON i.order_id=o.order_id
WHERE o.status='paid';

Guarde ese resultado con las definiciones, versiones y huella del archivo. La consulta utiliza el precio de compra de cada línea y excluye pedidos cancelados y envío. No elimine automáticamente la base original después de producir el volcado: la conservación del origen y la recuperación verificada son decisiones distintas.