Curso de MariaDB / Definir y comprobar la estructura de una tabla con CREATE TABLE

CREATE TABLE define las columnas, los tipos de datos, las restricciones y las claves de una tabla nueva en MariaDB. Para comprobar que la estructura es la prevista, revise DESCRIBE y SHOW CREATE TABLE y consulte una fila guardada; que la instrucción termine sin errores no basta.

Decidir qué representa cada columna

El esquema es la definición de una estructura de datos. En este ejercicio, cada fila representa un producto y las columnas separan su identificador, nombre, categoría, precio y existencias. Guardar esos valores juntos en un único texto obligaría a separarlos antes de calcular, ordenar o validar los datos.

Dato Definición Motivo
Identificador del producto product_id INT; clave primaria; incremento automático Distinguir filas aunque dos productos tengan el mismo nombre
Nombre product_name VARCHAR(100) NOT NULL Permitir una longitud variable y exigir un valor no nulo
Categoría category VARCHAR(30) NOT NULL Guardar una etiqueta sencilla
Precio price DECIMAL(10,2) NOT NULL Representar un importe decimal exacto con dos cifras decimales
Existencias stock INT NOT NULL DEFAULT 0 Usar cero cuando se omite la columna; impedir negativos exige una regla adicional

Elija las longitudes según los datos previstos y las necesidades de la aplicación. Cien caracteres es una decisión del ejemplo, no una longitud universal para los nombres de productos. VARCHAR limita caracteres y permite longitudes variables; DECIMAL fija la precisión y la escala de un valor decimal. Elegir un tipo numérico no determina por sí solo si el negocio admite precios o existencias negativos. NOT NULL tampoco impide guardar una cadena vacía.

Comprobar la conexión y los nombres existentes

Conéctese como course_user al servidor de prácticas y compruebe que dispone de la base shopcourse. La guía del cliente de consola y los archivos SQL explica la conexión y el comando SOURCE. Ejecute estas instrucciones dentro del cliente conectado, no en la consola del sistema operativo:

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

Después de USE, DATABASE() debe devolver shopcourse. Guarde el ejemplo completo de creación que aparece más abajo en un archivo UTF-8 con extensión .sql y ejecútelo mediante SOURCE seguido de su ruta local real. Mantenga las pruebas que provocan errores en otro archivo o ejecútelas por separado: un error puede interrumpir la ejecución del archivo. Utilice una instancia de aprendizaje sin datos de producción.

Conserve la tabla products de la práctica anterior. Aquí se emplea otro nombre, products_schema_lab, para estudiar la estructura sin modificarla. Compruebe si ya existe:

SHOW TABLES LIKE 'products_schema_lab';

Antes de la primera creación, el resultado debe estar vacío. Si aparece una tabla, revise su definición y sus filas antes de reiniciarla. Utilice de forma coherente nombres en minúsculas con guiones bajos y evite palabras reservadas. Esta convención reduce confusiones relacionadas con el sistema operativo y la configuración del servidor; los valores de texto siguen sus propias reglas y se escriben entre comillas simples en el ejemplo.

Ejecutar el ejemplo completo de creación

USE shopcourse;
CREATE TABLE products_schema_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,
  PRIMARY KEY (product_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_schema_lab (product_name, category, price)
VALUES ('Notebook', 'Stationery', 3500.00);
SHOW TABLES LIKE 'products_schema_lab';
DESCRIBE products_schema_lab;
SHOW CREATE TABLE products_schema_lab;
SELECT product_id, product_name, price, stock FROM products_schema_lab;

Dentro de los paréntesis de CREATE TABLE, las comas separan las columnas y las reglas de la tabla. No se escribe una coma después de la última definición. PRIMARY KEY (product_id) establece la clave primaria que identifica cada fila. AUTO_INCREMENT genera un número cuando una inserción omite ese identificador; la clave y la generación automática cumplen funciones distintas.

Un motor de almacenamiento es el componente que guarda y procesa los datos de una tabla. El ejemplo selecciona InnoDB de forma explícita para trabajar con transacciones y con las relaciones que se practicarán en el curso. utf8mb4 especifica el juego de caracteres y utf8mb4_unicode_ci la intercalación, es decir, las reglas de comparación y ordenación del texto. Esta elección hace explícita la configuración del ejercicio; cada aplicación debe decidir qué comparaciones necesita.

INSERT proporciona el nombre, la categoría y el precio. Al omitir el identificador y las existencias, la tabla recién creada asigna el identificador 1 y aplica el valor predeterminado 0 a stock. Conserve todos los puntos y coma al guardar el ejemplo completo en el archivo.

Revisar la definición guardada y la primera fila

Comprobación Resultado que debe revisar
DESCRIBE Field, Type, Null, Key, Default y Extra; localice la clave primaria y auto_increment
SHOW CREATE TABLE Definición completa, motor, juego de caracteres e intercalación
SELECT product_id 1, product_name Notebook, price 3500.00 y stock 0

El servidor puede mostrar un entero como int(11). El 11 no amplía el intervalo del tipo ni indica que cada valor ocupe once bytes. La presentación de la definición puede variar según la versión y los modos SQL; compare su significado en lugar de exigir un texto idéntico.

SHOW CREATE TABLE permite revisar o registrar la estructura, pero su salida no contiene una copia de las filas. La referencia oficial de CREATE TABLE detalla la sintaxis y las opciones de creación.

Entender qué conserva IF NOT EXISTS

Crear de nuevo una tabla con el mismo nombre normalmente produce un error que indica que ya existe. IF NOT EXISTS evita esa creación, pero no transforma la estructura existente para adaptarla a la nueva declaración. Después del ejemplo anterior, ejecute:

CREATE TABLE IF NOT EXISTS products_schema_lab (only_column INT);
SHOW WARNINGS;
DESCRIBE products_schema_lab;

SHOW WARNINGS permite consultar el aviso de tabla existente. DESCRIBE sigue mostrando las cinco columnas originales; no las sustituye por only_column. Tampoco se pierde la fila Notebook. Para modificar una estructura se necesita una migración apropiada, por ejemplo con ALTER TABLE, y un plan para conservar los datos.

No elimine una tabla de producción para resolver una diferencia de estructura. CREATE OR REPLACE TABLE también puede sustituir una tabla y sus datos: no es una solución de uso indiscriminado para el error de nombre duplicado.

Diagnosticar errores y repetir la práctica

Síntoma Qué comprobar
No hay una base seleccionada Ejecute USE shopcourse y consulte DATABASE()
La tabla ya existe Revise su estructura y las filas guardadas antes de modificarla
Error de sintaxis Compruebe las comas, la ausencia de coma final, los paréntesis y los puntos y coma
Error de permisos Verifique la cuenta, el host de conexión y sus permisos limitados a shopcourse

Antes de repetir el ejercicio, ejecute SELECT DATABASE(); y SHOW CREATE TABLE shopcourse.products_schema_lab;. Confirme que la tabla es la de esta práctica y guarde los datos que necesite conservar. Solo después de comprobar ese destino desechable, elimínelo con:

DROP TABLE shopcourse.products_schema_lab;

La instrucción elimina esa tabla y sus filas. Un ROLLBACK ordinario no recupera una tabla eliminada mediante DROP TABLE. Después puede volver a ejecutar el ejemplo completo de creación. La tabla products de la primera práctica de productos queda fuera de este reinicio.