Curso de MariaDB / Identificar filas con PRIMARY KEY, AUTO_INCREMENT y UNIQUE
PRIMARY KEY identifica cada fila de forma única, mientras que UNIQUE impide repetir otros valores o combinaciones de columnas. AUTO_INCREMENT genera identificadores enteros, pero no sustituye la definición de una clave ni garantiza una secuencia sin huecos; combine estas herramientas según la identidad y las reglas de sus datos.
Separar la identidad de la fila y la unicidad del negocio
Dos clientes distintos pueden tener el mismo nombre, por lo que el nombre no es un identificador fiable. Aquí se utiliza un número generado como clave primaria y se trata la unicidad del correo como una regla independiente. La guía de estructura de tablas muestra dónde declarar estas reglas; la guía de NULL y restricciones explica cómo combinarlas con las condiciones de presencia y rango.
| Herramienta | Función | Condición importante |
|---|---|---|
| PRIMARY KEY | Identificar una fila | Una definición por tabla; sus columnas no admiten NULL y sus combinaciones no se repiten |
| UNIQUE | Impedir valores o combinaciones duplicados | Puede haber varias definiciones; una columna nullable con UNIQUE puede contener varios NULL |
| AUTO_INCREMENT | Generar un entero cuando se omite el identificador | Una columna por tabla; necesita un índice y puede dejar huecos |
Una clave primaria no significa necesariamente una sola columna: una clave compuesta sigue siendo una definición, aunque incluya varias columnas. AUTO_INCREMENT tampoco tiene que ser siempre la clave primaria en cualquier diseño. Para empezar, este ejercicio utiliza una clave primaria entera con generación automática.
Ejecutar el ejemplo completo de clientes y claves
Conéctese como course_user al servidor de prácticas con acceso a shopcourse. La guía del cliente y los archivos SQL explica la conexión y SOURCE. Ejecute dentro de esa conexión:
SELECT VERSION() AS server_version, DATABASE() AS selected_database;
USE shopcourse;
SELECT DATABASE() AS selected_database;
Después de USE, DATABASE() debe devolver shopcourse. Utilice una instancia de aprendizaje sin datos de producción. El archivo crea tres tablas independientes: customers_key_lab, product_codes_key_lab y auto_gap_lab. Si ya existen, revise su estructura y sus datos antes de reiniciarlas. Guarde el bloque completo siguiente como archivo UTF-8 con extensión .sql y ejecútelo con SOURCE y su ruta local real.
En customers_key_lab, email admite NULL para representar un correo desconocido. La clave primaria se declara NOT NULL de forma explícita, y las inserciones de clientes omiten su identificador. Los resultados numéricos mostrados corresponden a tablas nuevas con los ajustes habituales auto_increment_increment=1 y auto_increment_offset=1; una configuración distinta puede producir otros números.
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 |
En esa tabla nueva, los clientes reciben los identificadores 1, 2 y 3. UNIQUE(email) permite los dos correos NULL y no obliga a proporcionar una dirección. Si el correo debe ser obligatorio, necesita una política NOT NULL adecuada y revisar los NULL existentes antes de imponerla a una tabla con datos.
Consulte la referencia de AUTO_INCREMENT y las reglas de PRIMARY KEY y UNIQUE para sus condiciones. Las direcciones example.com son datos de ejemplo, no destinatarios para enviar mensajes.
Probar correos y claves primarias duplicados
Después del archivo normal, ejecute estas instrucciones por separado. La primera repite un correo existente:
INSERT INTO customers_key_lab (customer_name, email) VALUES ('Another Alex', 'alex@example.com');
La segunda proporciona explícitamente el identificador de cliente 1, que ya existe:
INSERT INTO customers_key_lab (customer_id, customer_name) VALUES (1, 'Duplicate ID');
Compare los nombres de las claves que aparecen en los errores. Después de cada fallo, SELECT COUNT(*) FROM customers_key_lab; debe seguir devolviendo tres filas. Mantenga estos errores intencionados fuera del archivo normal para que no interrumpan las instrucciones posteriores.
No cambie inmediatamente a INSERT IGNORE o REPLACE para ocultar el problema. REPLACE puede sustituir una fila que entra en conflicto, por lo que no es una forma inocua de ignorar un duplicado.
La intercalación de email influye en qué valores se consideran iguales. Con utf8mb4_unicode_ci, ALEX@example.com puede entrar en conflicto con alex@example.com. Decida la política de normalización y comparación; escribir una cadena de otra forma no garantiza que UNIQUE la considere distinta. La guía de texto e intercalaciones explica esa separación.
Entender una clave primaria compuesta
Suponga que dos proveedores usan el código de producto N001. Una clave sobre el código por sí solo rechazaría el producto válido del segundo proveedor. Por eso el ejemplo define como clave primaria la combinación (supplier_id, supplier_code):
| supplier_id | supplier_code | Resultado |
|---|---|---|
| 1 | N001 | Código del primer proveedor |
| 2 | N001 | Permitido: la combinación es distinta |
| 1 | N001 otra vez | Rechazado: se repite la combinación |
INSERT INTO product_codes_key_lab VALUES (1, 'N001', 'Duplicate code');
La combinación es única, pero cada componente no tiene por qué serlo por separado. Un proveedor puede tener varios códigos y distintos proveedores pueden compartir un código. Las consultas y las referencias mediante claves foráneas pueden necesitar la combinación completa. Si el identificador del negocio puede cambiar, valore un identificador generado estable y una combinación UNIQUE independiente.
Prever huecos en los identificadores generados
La sección auto_gap_lab inserta una fila dentro de una transacción, la revierte con ROLLBACK y guarda después otra fila. En el ejemplo InnoDB nuevo y con los ajustes indicados, la fila guardada tiene identificador 2 y etiqueta Saved row. El número reservado por la inserción revertida no vuelve a la secuencia.
Las eliminaciones, los intentos fallidos y el trabajo concurrente también pueden dejar huecos. AUTO_INCREMENT no es un recuento de filas ni un mecanismo que garantice numeración consecutiva sin saltos. COUNT(*) cuenta las filas; MAX(id) solo devuelve el identificador visible más alto.
Para recuperar el identificador generado, consulte LAST_INSERT_ID() en la misma conexión inmediatamente después de una inserción pertinente y correcta. En una inserción de varias filas, devuelve el primer identificador generado, no una lista de todos ellos. La referencia de LAST_INSERT_ID describe ese alcance y el comportamiento tras errores.
No mezcle el resultado con el trabajo de otra conexión ni interprete un valor tras un fallo como prueba de éxito. Calcular MAX(id)+1 permite que dos clientes concurrentes elijan el mismo siguiente número y no sustituye una generación de identificadores adecuada.
Revisar las claves y reiniciar las tablas de prácticas
SHOW CREATE TABLE customers_key_lab;
SHOW INDEX FROM customers_key_lab;
SHOW CREATE TABLE product_codes_key_lab;
Compruebe que PRIMARY y uq_customers_key_email son claves diferentes y que la clave primaria compuesta incluye las dos columnas previstas. El campo Extra de DESCRIBE y SHOW INDEX responden a preguntas distintas: generar un valor e imponer unicidad son funciones separadas.
Antes de repetir, compruebe SELECT DATABASE(); y SHOW CREATE TABLE con los nombres completos de las tres tablas: shopcourse.customers_key_lab, shopcourse.product_codes_key_lab y shopcourse.auto_gap_lab. Guarde los datos necesarios y confirme que son las tablas desechables creadas aquí antes de eliminarlas:
DROP TABLE shopcourse.customers_key_lab, shopcourse.product_codes_key_lab, shopcourse.auto_gap_lab;
La instrucción elimina las tres tablas y sus filas. Un ROLLBACK ordinario no las recupera. Después puede volver a ejecutar el ejemplo completo; la tabla products de la primera práctica de productos queda fuera de este reinicio.




