Curso de MariaDB / Projeto final: pedidos, permissões, backup e restauração

Esta prática final cria um banco de pedidos, verifica uma transação de pedido e estoque com uma conta restrita e testa uma cópia do estado confirmado por meio de uma restauração separada. A estrutura, as mudanças do negócio, as permissões e a recuperação precisam de verificações próprias; uma única mensagem de SQL bem-sucedido não as substitui.

Definir as funções das contas e os resultados esperados

Use um banco novo, final48_lab, separado de serviços reais de pedidos ou pagamentos. Crie clientes, produtos, pedidos e itens e confirme o pedido 105 antes de copiar. Diferencie a conta administrativa, a conta de estudos com permissões de estrutura e a conta restrita da aplicação. Um programa real também precisa validar entradas, vincular parâmetros, autenticar requisições e impedir que uma requisição repetida duplique seu efeito.

A prática de transações InnoDB explica os limites de confirmação e cancelamento; a prática de usuários e permissões mostra como verificar recusas pela conta correta.

Etapa Verificação de conclusão
Estrutura Quatro tabelas InnoDB com referências e restrições
Pedido novo Estoque do produto 1: 20 → 18; produtos do pedido 105: 7000
Permissões Leituras, inserções e mudanças de estoque necessárias
Restauração Outro banco vazio: contagens 4, 4, 5 e 7
Conciliação Valor pago 46000; linhas e restrições correspondentes

Criar um banco dedicado e o conjunto inicial completo

Em uma conexão administrativa com o servidor de estudos, confira SELECT VERSION();, SHOW DATABASES e as contas. Confirme que final48_lab, final48_restore e 'final48_app'@'127.0.0.1' não estão em uso. Se existirem, escolha nomes exclusivos e adapte os blocos; não sobrescreva nem remova esses objetos para executar o exemplo.

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

Pela conexão administrativa, conceda a course_user acesso de gestão a este banco de estudos se necessário. A permissão anterior sobre shopcourse não se estende automaticamente a ele.

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

As contagens iniciais são quatro clientes, quatro produtos, quatro pedidos e seis itens. Examine as chaves estrangeiras e as condições de quantidade e preço com SHOW CREATE TABLE. O preço atual do catálogo e unit_price, preço registrado em cada compra, representam fatos diferentes.

Conectar com uma conta limitada ao fluxo previsto

Como administrador, substitua a senha de demonstração por uma exclusiva e crie a conta abaixo. O fluxo precisa ler produtos, inserir pedidos e itens e atualizar estoque; não precisa remover estruturas, administrar usuários, alterar preços ou apagar pedidos. Preserve a saída de SHOW GRANTS em particular, pois ela pode incluir informações de autenticação.

CREATE USER 'final48_app'@'127.0.0.1' IDENTIFIED BY 'Replace_With_Unique_Lab_Password!';
GRANT SELECT ON final48_lab.* TO 'final48_app'@'127.0.0.1';
GRANT INSERT ON final48_lab.c48_orders TO 'final48_app'@'127.0.0.1';
GRANT INSERT ON final48_lab.c48_items TO 'final48_app'@'127.0.0.1';
GRANT UPDATE(stock) ON final48_lab.c48_products TO 'final48_app'@'127.0.0.1';
SHOW GRANTS FOR 'final48_app'@'127.0.0.1';

No terminal do sistema operacional, abra uma conexão nova com essa conta e informe a senha quando solicitada. Ajuste a porta se necessário:

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=final48_app --password --default-character-set=utf8mb4 final48_lab

Dentro do cliente, confirme SELECT CURRENT_USER(); e uma leitura de produtos. Uma operação ALTER TABLE não concedida deve ser recusada. Em uma aplicação, restrinja mais o acesso conforme as tabelas, colunas e funções realmente necessárias; SELECT sobre todo este banco é uma escolha explícita do exercício. A referência oficial de GRANT documenta os escopos das permissões.

Verificar e confirmar estoque, pedido e item juntos

USE final48_lab;
START TRANSACTION;
SELECT product_id,price,stock FROM c48_products WHERE product_id=1 FOR UPDATE;
UPDATE c48_products SET stock=stock-2 WHERE product_id=1 AND stock>=2;
SELECT ROW_COUNT() AS reserved_rows;

Execute o bloco seguinte somente se reserved_rows for 1. Se for zero ou ocorrer um erro, execute ROLLBACK; nesta conexão e não insira o pedido nem seus itens. A condição impede descontar unidades quando o estoque mínimo não está disponível; o bloqueio é mantido dentro da transação.

INSERT INTO c48_orders(order_id,customer_id,ordered_at,status,shipping_fee)
VALUES(105,4,'2026-03-01 10:00:00','paid',1000);
INSERT INTO c48_items(order_id,product_id,quantity,unit_price)
VALUES(105,1,2,3500);
SELECT order_id,SUM(quantity*unit_price) AS goods_total
FROM c48_items WHERE order_id=105 GROUP BY order_id;

Com os dados iniciais, a reserva deve afetar uma linha e o total do pedido 105 deve ser 7000.00. Se alguma instrução falhar, pare antes de continuar e cancele toda a tentativa. A sequência usa entradas conhecidas e supervisão manual: um programa deve implementar essas decisões e passar os valores por parâmetros do driver.

Somente depois das verificações bem-sucedidas, confirme:

COMMIT;
SELECT stock FROM c48_products WHERE product_id=1;
SELECT COUNT(*) FROM c48_orders;
SELECT COUNT(*) FROM c48_items;

O estoque do produto 1 passa a ser 18, com cinco pedidos e sete itens. Repetir o ID 105 provoca um erro de chave duplicada. Planeje a identificação de requisições repetidas em vez de ocultar o erro com IGNORE ou REPLACE. Se já descontou estoque em uma tentativa com falha, ROLLBACK precisa cancelar esse desconto antes de tentar novamente. Um ROLLBACK posterior não desfaz a operação já confirmada corretamente.

Copiar o estado confirmado e preparar outro banco para restaurar

Use uma conexão course_user com permissões para copiar, em vez da conta restrita da aplicação. No Windows PowerShell, escolha um arquivo novo, confira o código de saída e examine o dump para identificar mudanças de banco. O bloco seguinte é executado no terminal, fora do cliente SQL.

New-Item -ItemType Directory -Path 'C:/mariadb-lab' -Force | Out-Null
$courseBackupPath='C:/mariadb-lab/final48-checked.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 final48_lab
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

Como administrador, crie o banco de restauração cujo nome confirmou disponível e conceda apenas o acesso de estudos necessário:

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

No terminal, conecte ao destino com interrupção de SOURCE em caso de erro:

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

Dentro do cliente, confira o banco e a ausência de tabelas antes de importar o arquivo confiável. Se o destino não estiver vazio, pare.

SELECT DATABASE();
SHOW TABLES;
SOURCE C:/mariadb-lab/final48-checked.sql;

As condições de mariadb-dump se aplicam à leitura consistente de InnoDB e às alterações estruturais simultâneas; a prática de restauração e verificação explica a compatibilidade do cliente e as falhas parciais. O dump do banco não restaura todas as contas ou configurações do servidor. Não direcione automaticamente a conta da aplicação à restauração de teste.

Alternativa de backup em um terminal Ubuntu: escolha este bloco ou o de PowerShell. O subshell, execução delimitada pelos parênteses, limita as permissões restritas e a proteção contra sobrescrita a esta operação.

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

Se o arquivo já existir, o comando deve falhar sem sobrescrevê-lo. Não restaure um arquivo parcial depois de um erro: diagnostique a causa e use um nome novo ao tentar novamente. O tamanho e o hash SHA-256 identificam o arquivo, mas não demonstram que ele seja recuperável.

Para restaurar a partir do Ubuntu, abra o mesmo destino com o comando abaixo e substitua o caminho de SOURCE pelo caminho absoluto real do arquivo. learner é um nome de usuário de exemplo.

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

Execute uma única variante de restauração em cada destino. Interromper SOURCE impede as instruções seguintes do arquivo, mas não desfaz objetos ou mudanças anteriores. Após uma falha, corrija a causa e use outro destino recém-preparado e vazio.

Em caso de erro de TLS, protocolo que protege dados em trânsito, confira versões, nome do certificado, autoridade confiável e qualquer certificado de cliente necessário conforme os requisitos oficiais de criptografia. Aplique as opções adequadas às duas ferramentas, sem desativar a verificação por rotina. A referência oficial de mariadb-dump detalha as condições e opções.

Comparar a origem, a restauração e os acessos recusados

SELECT (SELECT COUNT(*) FROM final48_restore.c48_customers) AS customers,
 (SELECT COUNT(*) FROM final48_restore.c48_products) AS products,
 (SELECT COUNT(*) FROM final48_restore.c48_orders) AS orders_count,
 (SELECT COUNT(*) FROM final48_restore.c48_items) AS detail_rows;
SELECT SUM(i.quantity*i.unit_price) AS paid_goods
FROM final48_restore.c48_orders o JOIN final48_restore.c48_items i ON i.order_id=o.order_id
WHERE o.status='paid';
SELECT stock FROM final48_restore.c48_products WHERE product_id=1;
SHOW CREATE TABLE final48_restore.c48_items;

As contagens esperadas são 4, 4, 5 e 7, o valor pago é 46000.00 e o estoque do produto 1 é 18. Compare os valores das linhas pelas chaves, as restrições e as consultas JOIN importantes, além de um estado de sucesso ou contagens iguais. Verifique separadamente a recusa de referências inexistentes, chaves duplicadas e alterações não autorizadas.

Guarde versões, hash do arquivo, consultas e resultados da validação e escopo das permissões. Feche as sessões de estudo e revise a propriedade e a retenção antes de remover contas ou bancos. A prática não remove automaticamente a origem, a cópia ou o banco de verificação.