Curso de MariaDB / Alterar colunas e restrições com ALTER TABLE

ALTER TABLE modifica colunas, tipos e restrições de uma tabela existente. Confira primeiro se os registros atendem às novas regras e separe a inclusão da coluna, o preenchimento dos dados existentes e a aplicação de restrições para identificar falhas e perdas de informação.

Conservar a definição atual e uma forma de recuperação

Alterar a estrutura vai além de trocar um rótulo. Reduzir tipos ou acrescentar NOT NULL e UNIQUE pode falhar com registros existentes ou transformar valores. Conserve a definição obtida por SHOW CREATE TABLE, um backup adequado dos dados e a lista de consultas dependentes. Reproduza a alteração primeiro em ambiente separado.

O guia de NULL, DEFAULT, NOT NULL e CHECK ajuda a definir as condições novas. Antes de uma alteração que possa perder dados, prepare e confira sua recuperação; inverter o nome de uma operação não recupera necessariamente valores removidos.

Alteração O que examinar antes Risco
Acrescentar NOT NULL Quantidade e significado dos NULL Exige uma política para dados ausentes
Acrescentar UNIQUE Grupos de valores duplicados Conflitos podem impedir a alteração
Encurtar textos Comprimento máximo em caracteres Rejeição ou truncamento
Remover uma coluna Consultas dependentes e conservação Remove os valores armazenados

Preparar produtos existentes antes de acrescentar um código

Conecte ao servidor de prática como course_user e selecione shopcourse. O guia do cliente e de arquivos SQL UTF-8 explica como salvar os blocos e executar dentro do cliente SOURCE C:/mariadb-lab/lesson.sql;, substituindo o caminho pelo real. Execute SQL dentro do cliente MariaDB.

Confira SELECT VERSION(), DATABASE(); e SHOW TABLES; antes de criar products_38_lab. O nome pertence somente a este exercício. Se a tabela existir, examine definição e registros e confirme que é prescindível antes de removê-la; preserve tabelas de aplicações. A conta precisa das permissões necessárias para criar, consultar, modificar e alterar essa tabela de prática.

USE shopcourse;
CREATE TABLE products_38_lab (
  product_id INT NOT NULL AUTO_INCREMENT,
  product_name VARCHAR(100) NOT NULL,
  category VARCHAR(30) NOT NULL,
  price DECIMAL(10,2) NOT NULL,
  stock INT NOT NULL DEFAULT 0,
  note VARCHAR(100) NULL DEFAULT NULL,
  PRIMARY KEY (product_id),
  CONSTRAINT ck_p38_price CHECK (price >= 0),
  CONSTRAINT ck_p38_stock CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_38_lab (product_id,product_name,category,price,stock,note) VALUES (1, '노트', '문구', 3500.00, 20, NULL),
  (2, '볼펜', '문구', 1500.00, 0, ''),
  (3, '머그컵', '생활', 8000.00, 12, '선물 포장'),
  (4, '스탠드', '생활', 25000.00, 5, NULL),
  (5, '파일', '문구', 1500.00, 50, ''),
  (6, '케이블', '전자', 8000.00, 0, '호환 확인');

Os textos originais em coreano são mantidos para praticar UTF-8. Os IDs 1–6 representam caderno, caneta, caneca, luminária, pasta e cabo; as categorias correspondem a papelaria, casa e eletrônicos. Introduza os literais como apresentados e compare pelos IDs.

A prática acrescenta um código de produto sku às seis linhas. Primeiro permite NULL para preenchê-lo antes de torná-lo obrigatório. A convenção P001–P006 serve somente a este conjunto: em uma aplicação, defina comprimento, estabilidade e alcance da unicidade do código.

Acrescentar coluna opcional, preencher e conferir contagens

SHOW CREATE TABLE products_38_lab;
ALTER TABLE products_38_lab ADD COLUMN sku VARCHAR(20) NULL;
UPDATE products_38_lab SET sku=CONCAT('P',LPAD(product_id,3,'0'))
WHERE sku IS NULL;
SELECT COUNT(*) AS rows_total,COUNT(sku) AS known_sku,
 COUNT(DISTINCT sku) AS unique_sku FROM products_38_lab;

Após ADD COLUMN, as seis linhas existentes têm NULL em sku. O UPDATE preenche somente os valores ausentes com P001–P006. Depois, rows_total, known_sku e unique_sku precisam valer 6. O primeiro conta linhas, o segundo códigos não nulos e o terceiro valores distintos não nulos.

Se as contagens não coincidirem, pare e examine os códigos ausentes ou repetidos antes de impor as restrições finais. A execução do UPDATE não comprova sozinha que a regra nova pode ser aplicada.

Não presuma que ALTER e o UPDATE seguinte formam uma transação reversível como unidade. Operações estruturais têm limites próprios de confirmação. Registre qual etapa terminou para retomar ou recuperar deliberadamente uma migração interrompida.

Aplicar restrições e testar uma rejeição separadamente

ALTER TABLE products_38_lab
 MODIFY COLUMN sku VARCHAR(20) NOT NULL,
 ADD CONSTRAINT uq_p38_sku UNIQUE(sku),
 ADD CONSTRAINT ck_p38_name CHECK(CHAR_LENGTH(product_name)>0);
SHOW CREATE TABLE products_38_lab;
SELECT product_id,product_name,sku FROM products_38_lab ORDER BY product_id;

O código se torna obrigatório e único; CHECK também exige pelo menos um caractere no nome do produto. Essa condição rejeita texto vazio, mas não remove espaços nem torna inválido um nome formado somente por espaços. Defina outra regra se precisar excluí-los.

Ao usar MODIFY, examine e especifique novamente tipo, comprimento, regra NULL, valores padrão e demais atributos que precisam permanecer. Evite presumir que todo atributo omitido conservará a definição anterior. A referência oficial de ALTER TABLE detalha definições de colunas e opções de alteração.

Execute a falha deliberada seguinte separadamente. Ela tenta atribuir ao produto 2 o código P001 já usado pelo produto 1. Espere um erro de unicidade e consulte depois o produto 2 para confirmar que mantém P002. Mantenha essa instrução fora do arquivo que precisa continuar sem erros.

UPDATE products_38_lab SET sku='P001' WHERE product_id=2;

Confira com SELECT product_id,sku FROM products_38_lab WHERE product_id=2;. Teste também a rejeição de um nome vazio em uma transação de prática, mantendo as verificações ativas, e termine com ROLLBACK. Diferencie a falha esperada de uma restrição de uma falha imprevista da migração.

Examinar bloqueios e custo de implantação

A alteração pode exigir cópia de dados ou bloqueios conforme versão, motor e operação. As opções ALGORITHM e LOCK não tornam qualquer alteração livre de interrupções. Confira as combinações aceitas e como falham na versão usada antes de depender delas.

Uma transação longa pode manter um bloqueio de metadados e atrasar ALTER. O tempo observado nestas seis linhas não prevê o de uma tabela de produção. Considere volume de dados e índices, espaço em disco, tempo de recuperação e janela de manutenção ou implantação em etapas compatível com a aplicação.

Distinguir remoção de coluna de recuperação dos dados

Remover a coluna nova destrói os códigos acumulados nela; isso não equivale necessariamente a recuperar o estado anterior da aplicação. Alterações que possam perder informações exigem cópia prévia e procedimento de recuperação verificado. Aqui, confirme que os seis nomes, preços e estoques originais permanecem iguais antes da limpeza.

Antes de repetir a preparação, examine banco selecionado, definição e registros e copie o que precisar conservar. Remova a tabela seguinte somente se continuar sendo um objeto prescindível do exercício. DROP TABLE remove estrutura e dados e não é desfeito por um ROLLBACK comum; mantenha essa limpeza fora dos testes transacionais.

DROP TABLE shopcourse.products_38_lab;