Curso de MariaDB / Identificar linhas com PRIMARY KEY, AUTO_INCREMENT e UNIQUE

PRIMARY KEY identifica cada linha de forma única; UNIQUE restringe outros valores ou combinações que não devem se repetir. AUTO_INCREMENT gera identificadores inteiros, mas não substitui a declaração de uma chave nem garante uma sequência sem lacunas. Combine os recursos conforme a identidade dos dados e as regras do negócio.

Separar identidade da linha de unicidade de negócio

Duas pessoas podem ter o mesmo nome, portanto ele não é um bom identificador de linha. O exemplo usa um número gerado estável como chave primária e trata a unicidade do e-mail como regra separada. O guia de estrutura da tabela mostra onde essas definições ficam; as regras de presença e valores permitidos complementam as chaves.

Recurso Função Condição importante
PRIMARY KEY Identificar uma linha Uma definição por tabela; colunas não aceitam NULL e as combinações são únicas
UNIQUE Rejeitar valores ou combinações duplicados Pode haver várias definições; uma coluna que aceita NULL pode conter vários NULLs
AUTO_INCREMENT Gerar inteiro quando o identificador é omitido Uma coluna por tabela; precisa ser indexada e pode haver lacunas

Uma chave primária não significa necessariamente uma coluna: uma chave composta é uma definição que envolve várias colunas. AUTO_INCREMENT não precisa ser a chave primária em todo projeto possível, mas uma chave primária inteira única é um ponto de partida simples aqui.

Executar os exemplos completos de clientes e chaves

Conecte como course_user com shopcourse disponível conforme o guia do cliente e dos arquivos SQL. Execute dentro da conexão:

SELECT VERSION() AS server_version, DATABASE() AS selected_database;
USE shopcourse;
SELECT DATABASE() AS selected_database;

O banco selecionado deve ser shopcourse. Confira que customers_key_lab, product_codes_key_lab e auto_gap_lab não existam; examine qualquer objeto anterior antes de repetir CREATE. Salve o exemplo normal completo em UTF-8 e use SOURCE com seu caminho local real. Mantenha falhas intencionais separadas.

customers_key_lab é uma tabela separada para aprender identificadores antes dos relacionamentos de pedidos. O e-mail aceita ausência de informação. A chave primária é NOT NULL explícita, mas fica fora das listas de inserção para que o servidor gere o número:

USE shopcourse;
CREATE TABLE customers_key_lab (
  customer_id INT NOT NULL AUTO_INCREMENT,
  customer_name VARCHAR(100) NOT NULL,
  email VARCHAR(254) NULL,
  PRIMARY KEY (customer_id),
  CONSTRAINT uq_customers_key_email UNIQUE (email)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO customers_key_lab (customer_name, email) VALUES
  ('Alex Chen', 'alex@example.com'),
  ('Sam Patel', NULL),
  ('Jordan Lee', NULL);
SELECT customer_id, customer_name, email FROM customers_key_lab ORDER BY customer_id;
CREATE TABLE product_codes_key_lab (
  supplier_id INT NOT NULL,
  supplier_code VARCHAR(30) NOT NULL,
  label VARCHAR(100) NOT NULL,
  PRIMARY KEY (supplier_id, supplier_code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO product_codes_key_lab VALUES
  (1, 'N001', 'Notebook'),
  (2, 'N001', 'Notebook from supplier two');
SELECT supplier_id, supplier_code, label FROM product_codes_key_lab ORDER BY supplier_id;
CREATE TABLE auto_gap_lab (
  item_id INT PRIMARY KEY AUTO_INCREMENT,
  label VARCHAR(30) NOT NULL
) ENGINE=InnoDB;
START TRANSACTION;
INSERT INTO auto_gap_lab (label) VALUES ('Rolled-back row');
ROLLBACK;
INSERT INTO auto_gap_lab (label) VALUES ('Saved row');
SELECT item_id, label FROM auto_gap_lab;
customer_id customer_name email
1 Alex Chen alex@example.com
2 Sam Patel NULL
3 Jordan Lee NULL

Na tabela nova, os números são 1, 2 e 3 com incremento e deslocamento padrão 1. UNIQUE(email) permite dois e-mails NULL; não exige um e-mail. Se ele for obrigatório, acrescente uma política NOT NULL apropriada e revise valores ausentes antes de aplicá-la a dados existentes.

As referências AUTO_INCREMENT e PRIMARY KEY e UNIQUE explicam as definições. Endereços example.com são valores de exemplo, não destinos para envio de mensagens.

Testar e-mail e chave primária duplicados

Depois do arquivo normal, execute as falhas separadamente. A primeira repete um e-mail e a segunda informa explicitamente o identificador 1 já existente:

INSERT INTO customers_key_lab (customer_name, email) VALUES ('Another Alex', 'alex@example.com');
INSERT INTO customers_key_lab (customer_id, customer_name) VALUES (1, 'Duplicate ID');

Compare os nomes das chaves nos erros. Depois de cada falha, SELECT COUNT(*) FROM customers_key_lab deve continuar em três. Não troque imediatamente por INSERT IGNORE ou REPLACE para ocultar o problema. REPLACE pode substituir uma linha conflitante e não é uma forma inofensiva de ignorar a duplicidade.

A collation do e-mail afeta a comparação de duplicados. Com utf8mb4_unicode_ci, mudar maiúsculas pode continuar causando conflito: ALEX@example.com não é um valor seguramente distinto de alex@example.com nessa regra. Defina normalização e comparação deliberadamente, como discutido no guia de texto e collation.

Entender uma chave primária com várias colunas

Dois fornecedores podem usar o mesmo código N001. Uma chave somente no código impediria o produto válido do segundo fornecedor. O arquivo define o par (supplier_id, supplier_code) como chave primária:

supplier_id supplier_code Resultado
1 N001 Código do primeiro fornecedor
2 N001 Permitido: combinação diferente
1 N001 novamente Rejeitado: mesma combinação
INSERT INTO product_codes_key_lab VALUES (1, 'N001', 'Duplicate code');

A chave composta torna a combinação única, não cada parte individualmente. Um fornecedor pode ter vários códigos, e fornecedores diferentes podem compartilhar um código. Consultas e referências por chave estrangeira podem precisar do par completo. Se uma chave de negócio puder mudar, considere um identificador estável gerado e uma combinação UNIQUE separada.

Os rótulos ingleses preservam o SQL: Notebook é caderno, Notebook from supplier two é caderno do segundo fornecedor e Duplicate code identifica o teste de código duplicado.

Esperar lacunas nos identificadores gerados

auto_gap_lab insere uma linha em uma transação, desfaz essa inserção e salva outra linha. Na tabela InnoDB nova deste exemplo, a linha persistida tem identificador 2 e rótulo Saved row, linha salva. Rolled-back row, linha revertida, não permanece, mas o identificador reservado não volta à sequência.

Exclusões, falhas de inserção e trabalho simultâneo também podem deixar lacunas. AUTO_INCREMENT não é contagem de linhas nem garantia de numeração contínua de documentos fiscais. Conte com COUNT(*); MAX(id) informa somente o maior identificador visível.

Para obter o valor gerado, consulte LAST_INSERT_ID() na mesma conexão logo após a inserção relevante bem-sucedida. Não misture com o trabalho de outra conexão nem interprete um valor após falha como prova de sucesso. Em uma inserção de várias linhas, ele informa o primeiro identificador gerado. Calcular MAX(id)+1 por conta própria permite que clientes simultâneos escolham o mesmo próximo número.

Conferir as chaves e reinicializar as tabelas isoladas

SHOW CREATE TABLE customers_key_lab;
SHOW INDEX FROM customers_key_lab;
SHOW CREATE TABLE product_codes_key_lab;

Confira que PRIMARY e uq_customers_key_email são chaves distintas e que a primária composta contém as duas colunas na ordem pretendida. O campo Extra de DESCRIBE e SHOW INDEX respondem a perguntas diferentes: gerar valores e garantir unicidade são recursos distintos.

Antes de repetir, use SELECT DATABASE() e SHOW CREATE TABLE com cada nome real para confirmar as três tabelas prescindíveis deste exercício. Copie os dados necessários e somente depois remova esses destinos:

DROP TABLE shopcourse.customers_key_lab, shopcourse.product_codes_key_lab, shopcourse.auto_gap_lab;

DROP TABLE remove as tabelas nomeadas e suas linhas e não é desfeito por ROLLBACK comum. Depois você pode executar o arquivo normal novamente. A tabela products da primeira prática de produtos fica fora desta reinicialização.