Curso de MariaDB / Criar uma cópia de segurança com mariadb-dump

mariadb-dump cria uma cópia lógica com instruções SQL que permitem reconstruir definições e linhas. Escolha opções de leitura consistente e um caminho explícito, confira os erros e teste a restauração em outro banco: a existência do arquivo não demonstra que a cópia seja recuperável.

Definir o escopo e os objetivos de recuperação

Este exercício copia quatro tabelas InnoDB de um banco independente, backup46_lab. Uma cópia lógica representa estruturas e dados como comandos, em vez de copiar diretamente os arquivos físicos do servidor. Este exemplo não inclui todas as contas, configurações ou arquivos externos de uma instância. A perda de dados aceitável e o tempo disponível para recuperar o serviço influenciam a frequência, o armazenamento e os registros adicionais que precisam ser preservados.

Área Neste exercício O que conferir além disso
Dados Quatro tabelas InnoDB Outros mecanismos, volume e alterações estruturais simultâneas
Objetos Tabelas base e chaves Views, definidores, rotinas, gatilhos e eventos
Contas e configurações Fora desta cópia do banco Procedimentos próprios de recuperação
Verificação Restaurar em outro banco vazio Linhas, restrições, valores e acesso

Etapas: banco de origem, arquivo SQL, restauração em outro banco vazio e comparação da estrutura, das linhas, das restrições e dos valores

O arquivo é uma etapa do processo: revise seu conteúdo, restaure sem apontar para a origem e compare os resultados. Mesmo com dados em um volume de contêiner, é necessária uma estratégia de cópia separada. A referência oficial de mariadb-dump descreve os formatos e as opções.

Criar um banco de origem independente

Em uma conexão administrativa com o servidor de estudos, confira SELECT VERSION(); e SHOW DATABASES. Confirme que backup46_lab não existe. Se existir, pare e escolha outro nome exclusivo, adaptando os blocos; não substitua nem remova dados para executar o exemplo. As definições e os registros completos abaixo tornam a prática independente.

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);

Foram mantidos 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. Preserve esses valores de texto em UTF-8 ao reproduzir o exercício.

As permissões de course_user sobre shopcourse não dão acesso automaticamente ao novo banco. A administração precisa conceder o escopo necessário. ALL fica limitado aqui ao banco descartável do exercício; uma conta operacional de backup deve receber permissões ajustadas aos objetos e às opções utilizados.

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

Conferir versões, arquivo novo e código de saída

Use mariadb-dump no diretório bin instalado ou por meio de PATH, a lista de diretórios onde o sistema procura comandos. Execute os comandos seguintes no terminal do sistema operacional, fora do cliente SQL. A prática do cliente de linha de comando ajuda a distinguir esses contextos. Confira as versões das duas ferramentas:

mariadb-dump --version
mariadb --version

No Windows PowerShell, execute o bloco completo abaixo. --result-file faz a ferramenta gravar diretamente o arquivo e evita diferenças de codificação do redirecionamento de saída do PowerShell. Ajuste a porta, os caminhos e a conta conforme o servidor de estudos.

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

Informe a senha quando solicitada, sem acrescentá-la ao argumento. O bloco interrompe a execução se o arquivo já existir ou se a ferramenta retornar um código de falha. Um erro pode deixar um arquivo vazio ou parcial; não o restaure como se fosse uma cópia completa. Tamanho maior que zero e hash SHA-256, uma impressão digital dos bytes, identificam o arquivo, mas não demonstram que ele recupera o banco.

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

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
)

Um destino existente provoca uma falha em vez de ser sobrescrito. Preserve um arquivo parcial para diagnosticar o erro e tente novamente com um nome novo depois de corrigir a causa. O hash permite conferir se uma cópia posterior mantém os mesmos bytes; a recuperação exige também um teste de restauração.

Em caso de erro de TLS, protocolo que protege os dados em trânsito, confira as versões de cliente e servidor, o nome do certificado, a autoridade confiável e qualquer certificado de cliente exigido. Aplique a configuração adequada às ferramentas de backup e restauração conforme os requisitos oficiais de conexões criptografadas. A prática de conexões locais e remotas ajuda a localizar a etapa da falha. Não desative a verificação como solução de rotina.

Entender as condições da leitura consistente

--single-transaction permite uma leitura consistente de tabelas transacionais como InnoDB, ou seja, uma visão coerente dos dados durante a cópia. Coordene operações simultâneas de ALTER, CREATE, DROP, RENAME e TRUNCATE, pois podem interferir nas condições do backup. Essa opção não oferece a mesma garantia a mecanismos não transacionais.

--quick obtém as linhas progressivamente. --skip-lock-tables explicita a escolha sobre bloqueios de tabelas neste comando; não significa que o backup esteja livre de carga, bloqueios ou tráfego de rede. O comando omite --databases para facilitar a restauração das tabelas em um banco com outro nome, mas confira sempre o conteúdo efetivo do SQL antes de importar.

Inventariar outros objetos e proteger o conteúdo

Este exemplo não contém views, rotinas, eventos ou gatilhos. Em um banco real, inventarie esses objetos e confira as opções e permissões da versão utilizada, os atributos DEFINER, que indicam o definidor do objeto, e o contexto em que os objetos serão executados após a restauração. Avalie --routines e --events quando necessário e examine a saída real dos gatilhos, sem supor que todas as dependências foram copiadas pelo nome de uma opção.

O arquivo contém definições e dados do negócio. Aplique controle de acesso, criptografia, retenção e cópias em um local sujeito a falhas diferentes, conforme sua política. Um arquivo apenas no mesmo disco não protege contra a perda desse disco; não armazene dumps em repositórios públicos ou diretórios da web.

Preservar a origem até verificar a restauração

Preserve a origem e o arquivo até verificar uma restauração em outro banco vazio. Compare a estrutura, todas as linhas, as chaves e os valores, além da mensagem de importação bem-sucedida. A referência do exemplo é quatro clientes, quatro produtos, quatro pedidos, seis itens e 39000 em produtos de pedidos pagos.

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 esse resultado com as definições, as versões e o hash do arquivo. A consulta usa o preço de compra de cada item e exclui pedidos cancelados e frete. Não remova automaticamente o banco original depois de gerar o dump: preservar a origem e verificar a recuperação são decisões distintas.