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 | |
|---|---|---|
| 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.




