INSERT: insertar filas

En resumen: INSERT INTO … VALUES inserta una fila, INSERT … SELECT inserta filas que vienen de una consulta, y las reglas de la tabla (UNIQUE, NOT NULL, CHECK, clave foránea) rechazan las filas incorrectas.

Problema

Un cliente nuevo

Hasta ahora solo has leído de la base de datos. Pero cada día entran cosas nuevas. Hoy se registró en el sitio web Vesela Raykova, de Pleven.

El sitio web tiene que escribir una fila nueva en customers. Nadie abre la tabla a mano: el programa envía una consulta a la base de datos.

La idea

INSERT INTO

INSERT INTO dice en qué tabla y en qué columnas, y VALUES da los valores en el mismo orden:

SQLbase de datos: tienda

INSERT INTO customers (name, email, city, joined_at)
VALUES ('Vesela Raykova', 'vesela.r@example.com', 'Pleven', '2026-10-25');

SELECT * FROM customers WHERE joined_at >= '2026-09-01';

INSERT INTO customers (name, email, city, joined_at) VALUES ('Vesela Raykova', 'vesela.r@example.com', 'Pleven', '2026-10-25'); SELECT * FROM customers WHERE joined_at >= '2026-09-01';

▶ EjecutarRestaurar la consultaBase nueva

La columna id no está en la lista. Es una clave primaria del tipo INTEGER PRIMARY KEY, así que SQLite misma le da un número uno mayor que el más grande: 21. Una columna que no está en la lista recibe su valor por defecto (para stock en la tienda es 0), y si no hay, NULL.

Un campo puede contener varias sentencias. Se ejecutan una tras otra, y el SELECT del final muestra qué pasó.

Cada campo tiene su propia base de datos y la conserva entre ejecuciones. Ejecuta la consulta otra vez: la segunda vez la base de datos la rechaza, porque Vesela ya está dentro con ese correo. El botón «Base nueva» devuelve la base de datos a como estaba al principio.

Míralo

Sin la lista de columnas

La lista de columnas se puede omitir. Entonces los valores deben cubrir todas las columnas, en el orden que tienen en la tabla:

SQLbase de datos: tienda

INSERT INTO customers
VALUES (21, 'Vesela Raykova', 'vesela.r@example.com', 'Pleven', '2026-10-25');

SELECT * FROM customers WHERE id = 21;

INSERT INTO customers VALUES (21, 'Vesela Raykova', 'vesela.r@example.com', 'Pleven', '2026-10-25'); SELECT * FROM customers WHERE id = 21;

▶ EjecutarRestaurar la consultaBase nueva

Deja una fuera, y la base de datos lo rechaza:

SQLbase de datos: tienda

INSERT INTO customers
VALUES ('Vesela Raykova', 'vesela.r@example.com', 'Pleven', '2026-10-25');

INSERT INTO customers VALUES ('Vesela Raykova', 'vesela.r@example.com', 'Pleven', '2026-10-25');

▶ EjecutarRestaurar la consultaBase nueva

Aquí falta id. Sin lista, la base de datos no puede saber qué valor es para qué columna. Así que lista siempre las columnas. De esa forma ves qué va dónde, y la consulta no se rompe cuando la tabla recibe una columna nueva.

Pruébalo

Un producto nuevo

La tienda empieza a vender ayran. Añade el producto «Ayran» en la categoría 4 (Lácteos), a 1,30 €, con 30 en existencias, añadido hoy (2026-10-25).

SQLbase de datos: tienda

SELECT id, name, price, stock FROM products WHERE category_id = 4;

SELECT id, name, price, stock FROM products WHERE category_id = 4;

Comprobar▶ Ejecutar

La idea

RETURNING

Yavor Penev hace su primer pedido. El sitio web guarda el pedido y después tiene que guardar los productos que lleva. Para eso necesita el número del pedido nuevo, y ese lo reparte la base de datos.

RETURNING al final de un INSERT devuelve columnas de la fila que acaba de guardarse:

SQLbase de datos: tienda

INSERT INTO orders (customer_id, ordered_at, status)
VALUES (20, '2026-10-25', 'new')
RETURNING id;

INSERT INTO orders (customer_id, ordered_at, status) VALUES (20, '2026-10-25', 'new') RETURNING id;

▶ EjecutarRestaurar la consultaBase nueva

El pedido es el número 61. Sin RETURNING necesitarías una segunda consulta para saberlo. RETURNING acepta cualquier columna: RETURNING id, ordered_at o RETURNING *.

Más precisamente, para curiosos

RETURNING existe en SQLite (desde la versión 3.35) y en PostgreSQL. En SQL Server lo mismo se escribe con OUTPUT. MySQL no lo tiene: allí el número se lee con LAST_INSERT_ID() después de insertar. SQLite tiene una función parecida, last_insert_rowid().

La idea

Muchas filas a la vez

El pedido de Yavor lleva café y dos cartones de leche fresca. Varias filas entran con un solo INSERT: después de VALUES van varios paréntesis, separados por comas. En esta base de datos el pedido 61 ya existe:

SQLbase de datos: tienda

INSERT INTO order_items (order_id, product_id, quantity, unit_price)
VALUES (61, 17, 1, 14.9),
       (61, 5, 2, 1.6);

SELECT * FROM order_items WHERE order_id = 61;

INSERT INTO order_items (order_id, product_id, quantity, unit_price) VALUES (61, 17, 1, 14.9), (61, 5, 2, 1.6); SELECT * FROM order_items WHERE order_id = 61;

▶ EjecutarRestaurar la consultaBase nueva

Las filas también pueden venir de una consulta. Maria hace clic en «Pedir otra vez» en su último pedido (60). El pedido nuevo es el 61, y los productos vienen de un SELECT en lugar de VALUES:

SQLbase de datos: tienda

INSERT INTO order_items (order_id, product_id, quantity, unit_price)
SELECT 61, oi.product_id, oi.quantity, p.price
FROM order_items oi
JOIN products p ON p.id = oi.product_id
WHERE oi.order_id = 60;

SELECT * FROM order_items WHERE order_id = 61;

INSERT INTO order_items (order_id, product_id, quantity, unit_price) SELECT 61, oi.product_id, oi.quantity, p.price FROM order_items oi JOIN products p ON p.id = oi.product_id WHERE oi.order_id = 60; SELECT * FROM order_items WHERE order_id = 61;

▶ EjecutarRestaurar la consultaBase nueva

Esto es INSERT … SELECT: lo que devuelve el SELECT se guarda. Las columnas del SELECT deben coincidir con la lista después de INSERT INTO. El precio se toma de products, no del pedido antiguo, porque puede haber cambiado desde entonces.

Míralo

La base de datos dice que no

Las tablas de la tienda tienen reglas. Rompe una, y la base de datos rechaza la fila y dice qué regla se rompió.

El correo de un cliente debe ser único (UNIQUE):

SQLbase de datos: tienda

INSERT INTO customers (name, email, joined_at)
VALUES ('Maria Ivanova', 'maria.ivanova@example.com', '2026-10-25');

INSERT INTO customers (name, email, joined_at) VALUES ('Maria Ivanova', 'maria.ivanova@example.com', '2026-10-25');

▶ EjecutarRestaurar la consultaBase nueva

El nombre no puede faltar (NOT NULL):

SQLbase de datos: tienda

INSERT INTO customers (email, joined_at)
VALUES ('new.client@example.com', '2026-10-25');

INSERT INTO customers (email, joined_at) VALUES ('new.client@example.com', '2026-10-25');

▶ EjecutarRestaurar la consultaBase nueva

El precio no puede ser negativo (CHECK):

SQLbase de datos: tienda

INSERT INTO products (name, category_id, price, stock, added_at)
VALUES ('Ayran', 4, -1.3, 30, '2026-10-25');

INSERT INTO products (name, category_id, price, stock, added_at) VALUES ('Ayran', 4, -1.3, 30, '2026-10-25');

▶ EjecutarRestaurar la consultaBase nueva

Un pedido debe pertenecer a un cliente que exista. customer_id es una clave foránea hacia customers, y no hay cliente 99:

SQLbase de datos: tienda

INSERT INTO orders (customer_id, ordered_at, status)
VALUES (99, '2026-10-25', 'new');

INSERT INTO orders (customer_id, ordered_at, status) VALUES (99, '2026-10-25', 'new');

▶ EjecutarRestaurar la consultaBase nueva

Cada vez la fila no se guarda y nada cambia en la base de datos. Eso es bueno: un error del programa no puede llenar la base de datos de pedidos que no pertenecen a nadie.

Estas reglas se escriben en la propia tabla cuando se crea. En el módulo siguiente las escribirás tú.

Pruébalo

Una reseña sin texto

Simona Yordanova (cliente 17) da hoy, 2026-10-25, 5 estrellas a la leche fresca (producto 5), sin escribir ningún texto. Guarda la reseña.

SQLbase de datos: tienda

SELECT * FROM reviews WHERE product_id = 5;

SELECT * FROM reviews WHERE product_id = 5;

Comprobar▶ Ejecutar

Ejercicio

Dos tareas

1. La tienda amplía su sección «Hogar» (categoría 2). Añade dos subcategorías con una sola consulta: «Jardín» y «Baño».

Las dos categorías nuevas en «Hogar»:

SQLbase de datos: tienda

SELECT * FROM categories;

SELECT * FROM categories;

Comprobar▶ Ejecutar

2. Ognyan Slavov, de Varna, se registra hoy con el correo ognyan.s@example.com. El sitio web quiere mostrarle su perfil enseguida, con el número que le dio la base de datos. Guárdalo y devuelve la fila nueva completa con la misma consulta.

El cliente nuevo, la fila completa:

SQLbase de datos: tienda

SELECT id, name, joined_at FROM customers WHERE city = 'Varna';

SELECT id, name, joined_at FROM customers WHERE city = 'Varna';

Comprobar▶ Ejecutar

Test

Ponte a prueba

1. Falta la columna stock en INSERT INTO products. ¿Qué tendrá?

El valor por defecto de la columna (0 en la tienda), o NULL si no haySiempre un errorEl valor de la fila anterior

2. ¿Por qué es mejor listar las columnas en un INSERT?

La consulta va más rápidoLos valores van a las columnas correctas, y la consulta no se rompe cuando la tabla recibe una columna nuevaINSERT no funciona sin lista

3. ¿Qué hace RETURNING id al final de un INSERT?

Cancela la inserción si el id existeDevuelve el número que la base de datos dio a la fila nuevaMuestra todos los id de la tabla

4. Insertas un pedido con customer_id = 99, y no hay cliente 99. ¿Qué pasa?

Un error de FOREIGN KEY, y el pedido no se guardaEl pedido se guarda sin clienteLa base de datos crea el cliente 99

Comprobar

Empezar la lección de nuevo

Lecciones relacionadas

• Se basa en: WHERE: filtrar filas · NULL: sin valor · Clave primaria y clave foránea · JOIN: dos tablas en una consulta
• Continúa en: UPDATE: cambiar valores · DELETE: borrar filas · Upsert: insertar o cambiar · La base de datos: de CREATE a DROP
• Ejercicios sobre el tema: Cambiar los datos