Curso de MariaDB / Restaurar um backup em outro banco e verificar a recuperação

Verifique um backup restaurando em outro banco vazio e comparando definições, linhas, restrições e valores. Examine primeiro os comandos do arquivo que mudam de banco ou removem objetos e interrompa a execução diante de erros para não confundir uma restauração parcial com uma completa.

Examinar o dump antes de confiar no banco selecionado

CREATE DATABASE, USE e nomes de objetos qualificados pelo banco podem direcionar operações para fora do banco escolhido na conexão. Confira a origem confiável, as versões e as opções de geração antes de executar. Um dump, arquivo com comandos para reconstruir objetos e dados, pode conter DROP TABLE; um banco existente com dados não é um destino adequado para este teste.

A prática de backup com mariadb-dump explica as condições do arquivo e o fluxo de cópia e verificação. Aqui usamos um conjunto independente para praticar a restauração completa sem depender das tabelas do artigo anterior.

Etapa O que conferir Decisão
Arquivo CREATE DATABASE, USE, DROP e DEFINER Pode atuar fora do destino?
Destino vazio Servidor real, nome e permissões É diferente da origem?
Execução Primeiro erro e estado do cliente Terminou ou ficou parcial?
Validação Objetos, linhas, chaves e valores Corresponde à referência original?

Preparar uma origem independente e um arquivo novo

Em uma conexão administrativa com o servidor de estudos, confira SELECT VERSION(); e SHOW DATABASES e confirme que restore47_source e restore47_target estão livres. Se algum existir, pare e escolha nomes exclusivos; não apague dados existentes para reutilizá-los. Se preferir restaurar o arquivo do artigo anterior, use os nomes e valores de referência daquele exercício, sem misturar os dois conjuntos.

CREATE DATABASE restore47_source CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE restore47_source;
CREATE TABLE c47_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 c47_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 c47_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_c47_order_customer FOREIGN KEY (customer_id)
  REFERENCES c47_customers(customer_id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE c47_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_c47_item_order FOREIGN KEY (order_id)
  REFERENCES c47_orders(order_id) ON DELETE RESTRICT,
 CONSTRAINT fk_c47_item_product FOREIGN KEY (product_id)
  REFERENCES c47_products(product_id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO c47_customers VALUES
 (1,'김민수','서울'),(2,'이서연','부산'),
 (3,'박지우','서울'),(4,'최하늘','대전');
INSERT INTO c47_products VALUES
 (1,'노트','문구',3500,20),(2,'볼펜','문구',1500,50),
 (3,'머그컵','생활',8000,12),(4,'스탠드','생활',25000,5);
INSERT INTO c47_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 c47_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);

Foram preservados os nomes e as cidades originais em coreano. Os produtos 1–4 são caderno, caneta, caneca e luminária. Os clientes 1 e 3 moram em Seul; o 2, em Busan; e o 4, em Daejeon. Mantenha os valores de texto em UTF-8 para reproduzir os resultados.

Conceda acesso apenas aos bancos de estudo e crie o destino vazio pela conexão administrativa. ALL fica limitado aqui aos dois bancos do exercício; não representa uma política de permissões para todos os bancos do servidor.

GRANT ALL PRIVILEGES ON restore47_source.* TO 'course_user'@'127.0.0.1';
CREATE DATABASE restore47_target CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON restore47_target.* TO 'course_user'@'127.0.0.1';

No Windows PowerShell, prepare a pasta e um arquivo novo executando o bloco abaixo no terminal do sistema operacional. Confira o código de saída antes de continuar. Ajuste a porta se o servidor não usar 3306 e informe a senha quando solicitada.

New-Item -ItemType Directory -Path 'C:/mariadb-lab' -Force | Out-Null
$courseBackupPath='C:/mariadb-lab/restore47-source.sql'
if (Test-Path -LiteralPath $courseBackupPath) { 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=$courseBackupPath restore47_source
if ($LASTEXITCODE -ne 0) { throw 'Backup failed; do not restore this file.' }
Get-Item -LiteralPath $courseBackupPath | Select-Object Name,Length
Get-FileHash -LiteralPath $courseBackupPath -Algorithm SHA256

Alternativa para um terminal Ubuntu: escolha este bloco ou o de PowerShell conforme o cliente. O subshell, execução delimitada pelos parênteses, restringe a esta operação as permissões de arquivo e a proteção contra sobrescrita.

mkdir -p "$HOME/mariadb-lab"
(
  umask 077
  set -C
  backup_file="$HOME/mariadb-lab/restore47-source.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 restore47_source > "$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
)

Se o arquivo de destino já existir, o bloco deve falhar sem sobrescrevê-lo. Não restaure um arquivo parcial após uma falha: diagnostique a causa e tente novamente com um nome novo. O tamanho e o hash SHA-256 identificam os bytes; não comprovam a recuperação.

Em caso de erro de TLS, protocolo de proteção dos dados em trânsito, confira as versões, o nome do certificado, a autoridade confiável e qualquer certificado de cliente exigido, conforme os requisitos oficiais de conexão criptografada. Aplique as opções adequadas às duas ferramentas; não desative a verificação por rotina.

Confirmar o destino vazio e usar um cliente compatível

Revise o conteúdo do SQL antes de importar. Abra o cliente apontando para o destino; a opção abaixo interrompe o processamento do arquivo SOURCE ao encontrar um erro. Execute o comando no terminal:

mariadb --abort-source-on-error --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 restore47_target

Dentro do cliente, confira a versão, o banco e se SHOW TABLES retorna vazio antes de SOURCE. Se houver tabelas, pare:

SELECT VERSION(),DATABASE();
SHOW TABLES;
SOURCE C:/mariadb-lab/restore47-source.sql;

Dumps recentes de mariadb-dump podem incluir uma diretiva de modo sandbox, que restringe comandos do cliente, não interpretada por clientes antigos do MariaDB ou pelo cliente mysql do MySQL. Escolha versões compatíveis em vez de apagar automaticamente uma diretiva desconhecida. A referência oficial de mariadb-dump descreve essa condição.

Se restaurar a partir do Ubuntu, abra o mesmo destino com o comando abaixo e use em SOURCE o caminho absoluto real e o usuário do sistema. learner é apenas um exemplo:

mariadb --abort-source-on-error --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 restore47_target
SELECT DATABASE();
SHOW TABLES;
SOURCE /home/learner/mariadb-lab/restore47-source.sql;

Execute uma única variante de plataforma em cada destino. Interromper o arquivo no primeiro erro impede as instruções posteriores daquele arquivo, mas não remove objetos nem desfaz mudanças já confirmadas. Depois de uma falha, corrija a causa e tente novamente em um destino novo, preparado e vazio.

Comparar estrutura, conteúdo e valores

SELECT TABLE_NAME,TABLE_TYPE FROM information_schema.TABLES
WHERE TABLE_SCHEMA='restore47_target' ORDER BY TABLE_NAME;
SELECT (SELECT COUNT(*) FROM restore47_target.c47_customers) AS customers,
 (SELECT COUNT(*) FROM restore47_target.c47_products) AS products,
 (SELECT COUNT(*) FROM restore47_target.c47_orders) AS orders_count,
 (SELECT COUNT(*) FROM restore47_target.c47_items) AS detail_rows;
SELECT SUM(i.quantity*i.unit_price) AS paid_goods
FROM restore47_target.c47_orders o
JOIN restore47_target.c47_items i ON i.order_id=o.order_id WHERE o.status='paid';
SHOW CREATE TABLE restore47_target.c47_items;

Devem aparecer quatro tabelas base, contagens de 4 clientes, 4 produtos, 4 pedidos e 6 itens, e valor pago de 39000.00. SHOW CREATE TABLE permite examinar a chave primária, as chaves estrangeiras e as condições de quantidade e preço dos itens. Contagens iguais não demonstram que todos os campos são iguais: compare os registros pelas chaves com a origem e execute também as consultas de negócio previstas.

O valor do exemplo usa os preços unitários de compra e exclui frete e pedidos cancelados. Se o banco tiver views, rotinas, gatilhos ou eventos, confira também suas definições e seu comportamento. Copiar um banco não garante por si só recriar todas as contas, concessões ou configurações do servidor; verifique os contextos de definição e execução necessários, inclusive os definidores indicados por DEFINER.

Parar diante de erros e identificar o estado parcial

Erros de sintaxe, permissões, DEFINER ou conjunto de caracteres podem surgir depois de alguns objetos já terem sido criados. Não use --force para continuar e declarar sucesso ao final. Preserve o erro e o inventário parcial, corrija a causa e repita a verificação em outro banco vazio.

Não desative arbitrariamente as verificações de chaves estrangeiras para ocultar falhas. Examine os ajustes que o próprio dump salva e restaura. Uma restauração estrutural completa não é uma única transação que possa ser desfeita com ROLLBACK comum. Direcionar a aplicação ao destino, bloquear acessos e impedir novas gravações exige um procedimento controlado à parte.

Preservar evidências de recuperação antes de limpar

Registre o hash do arquivo, as versões de cliente e servidor, o destino real, o momento da execução e as consultas e resultados da validação. Preserve a origem e a cópia até concluir as verificações. Antes de remover um banco de estudos, confirme que foi criado para este exercício e guarde o necessário. Nenhum DROP DATABASE automático faz parte desta restauração.