SQL Server
Fundamentos de INSERT en SQL Server
Aprende a insertar una o varias filas en SQL Server con columnas explícitas y a comprobar el resultado mediante SELECT.
En este artículo
Después de aprender a leer filas con tu primera consulta SELECT, el siguiente paso es aprender a agregar una fila. SQL Server usa INSERT para añadir datos a una tabla. Esta lección utiliza solo la base sintética JaviBuildsLab y su tabla dbo.Customers. Un INSERT correcto modifica la tabla, así que comprueba el destino y consulta el resultado en vez de dar por hecho que funcionó.
Insertar una fila con una lista de columnas
El script de demostración crea los identificadores de cliente del 1 al 10. La fila de práctica siguiente usa el ID 11, fuera de ese rango. Primero confirma la base de datos actual y que la clave esté libre:
SELECT DB_NAME() AS CurrentDatabase;
SELECT CustomerId, FirstName, LastName
FROM dbo.Customers
WHERE CustomerId = 11;Para continuar, la primera consulta debe mostrar JaviBuildsLab y la segunda no debe devolver filas. Entonces puedes añadir el registro:
INSERT INTO dbo.Customers
(
CustomerId,
FirstName,
LastName,
City,
State,
Email,
CreatedDate
)
VALUES
(
11,
N'Maya',
N'Rivera',
N'Orlando',
'FL',
N'maya.rivera@example.com',
'2026-10-21'
);INSERT INTO nombra la tabla de destino. La lista entre paréntesis indica las columnas que recibirán valores; VALUES proporciona uno para cada columna, en el mismo orden. La N delante del texto indica Unicode, adecuado para las columnas NVARCHAR. La columna State es CHAR(2), por lo que 'FL' cabe. La fecha usa año-mes-día, un formato claro en este ejemplo.
Este ID es un valor de práctica, no una fila nueva del script de preparación. Ejecuta el ejemplo una sola vez en tu base local. Si lo repites, la clave primaria ya existirá; compruébalo y elige otro ID disponible en vez de cambiar el script. La preparación sigue siendo determinista y aditiva, y el sitio no añade registros de clientes automáticamente.
Por qué enumerar las columnas
Una forma más corta, como INSERT INTO dbo.Customers VALUES (...), exige recordar todas las columnas y su orden físico. Un cambio de esquema o un valor omitido puede provocar un error o colocar un valor válido en la columna equivocada. La lista explícita documenta la intención, vincula cada valor a un nombre y permite omitir columnas que aceptan NULL o tienen un valor predeterminado real.
La lista también facilita la revisión. Otra persona puede ver que City recibe Orlando y que CreatedDate recibe la fecha sin buscar la definición de la tabla. Mantén las listas de columnas y valores en el mismo orden. SQL Server los asocia por posición, no por significado.
Omitir una columna que permite NULL
En el esquema de demostración, Email permite NULL y no tiene un valor predeterminado. Puedes omitirla si no conoces el correo. SQL Server asignará NULL a esa columna nullable omitida:
INSERT INTO dbo.Customers
(CustomerId, FirstName, LastName, City, State, CreatedDate)
VALUES
(12, N'Rosa', N'Chen', N'Phoenix', 'AZ', '2026-10-21');Es otro ejemplo de práctica con el ID 12, no un cambio del script inicial. Omitir la columna no crea una dirección por defecto: queda en NULL porque la definición lo permite. Si se omite una columna NOT NULL sin valor predeterminado, la inserción falla. Consulta el esquema en vez de adivinar qué completará SQL Server.
Agregar unas pocas filas
Un INSERT puede añadir más de una fila. Cada fila debe tener un valor compatible por cada columna indicada:
INSERT INTO dbo.Customers
(CustomerId, FirstName, LastName, City, State, Email, CreatedDate)
VALUES
(13, N'Noah', N'Patel', N'Boulder', 'CO', N'noah.patel@example.com', '2026-10-21'),
(14, N'Leila', N'Morgan', N'Raleigh', 'NC', NULL, '2026-10-21');Este es otro ejemplo alternativo de práctica, no una modificación de los datos iniciales. La segunda fila usa la palabra clave SQL NULL para un correo desconocido. NULL no es texto: escribe NULL, no 'NULL'. El texto entre comillas serían las cuatro letras N-U-L-L. No ejecutes cada ejemplo ilustrativo repetidamente; verifica primero que el identificador esté disponible.
Respetar los tipos de datos SQL
El texto se escribe entre comillas simples. El prefijo N corresponde a columnas NVARCHAR, como N'Maya'. Los números, como la clave entera, se escriben sin comillas: 11, no '11'. SQL Server puede convertir algunos textos automáticamente, pero depender de conversiones implícitas hace más difíciles de detectar ciertos errores. Escribe las fechas con un formato inequívoco, por ejemplo '2026-10-21'. Para un dato ausente, usa la palabra sin comillas NULL, solo si la columna lo permite.
Cada columna tiene un tipo y, a menudo, una longitud máxima. FirstName y LastName admiten hasta 50 caracteres Unicode; State admite dos. Un valor demasiado largo o incompatible puede generar un error y, según el contexto, truncarse. Respeta los límites de la definición y comprueba los tipos reales al adaptar un ejemplo.
Columnas IDENTITY y restricciones
Una columna IDENTITY está configurada para generar un número al insertar una fila. Muchas tablas la usan como clave sustituta, así que normalmente se omite esa columna en el INSERT. En esta demostración, CustomerId no es IDENTITY: es una clave primaria INT NOT NULL que el INSERT debe proporcionar. No supongas que una tabla genera sus identificadores sin revisar el esquema. No hace falta modificar el script de preparación para esta lección.
Las restricciones protegen la tabla frente a valores y relaciones no válidos. CustomerId es clave primaria, así que un ID duplicado hace que falle la inserción. En dbo.Orders, CustomerId es una clave externa hacia dbo.Customers; se rechaza un pedido para un cliente inexistente. Un valor NULL no puede entrar en una columna NOT NULL, y un tipo o longitud incorrectos también pueden provocar errores. Estos controles evitan que los datos incumplan las reglas de la tabla.
Si aparece un error, lee qué tabla, columna o restricción menciona SQL Server. Comprueba la base, inspecciona las columnas de destino y compara sus nombres con la lista. Corrige la causa antes de volver a intentarlo. No cambies datos iniciales sin relación para resolver una colisión de clave: escoge un identificador de práctica libre.
Verificar la fila insertada
Cuando termine la instrucción, vuelve a consultar la fila mediante su clave:
SELECT
CustomerId,
FirstName,
LastName,
City,
State,
Email,
CreatedDate
FROM dbo.Customers
WHERE CustomerId = 11;Confirma que los valores devueltos coincidan con lo que querías insertar. Si no aparece ninguna fila, revisa el mensaje de SSMS, confirma la base activa y comprueba el identificador. Esta práctica continúa la lección sobre filtrar con WHERE: una condición concreta permite inspeccionar un registro con facilidad.
SQL Server también permite INSERT ... SELECT, que inserta las filas devueltas por una consulta. Sirve para copiar o transformar varias filas, pero combina lectura y escritura. Por eso hay que revisar tanto la consulta de origen como la lista de destino. Primero aprende la forma explícita con VALUES; la misma disciplina de columnas se aplica al patrón posterior.
INSERT agrega filas a la tabla; no modifica una fila existente solo porque coincida su clave. Si la clave ya está ocupada, la restricción de clave primaria rechaza el duplicado. Comprueba si el registro existe antes de decidir si tu tarea consiste en agregar uno nuevo o cambiar uno existente. Son objetivos distintos y usan instrucciones y verificaciones distintas. Para un registro existente, utiliza el flujo que empieza con SELECT de UPDATE, en lugar de intentar resolver el error modificando la clave de otro cliente.
Al insertar varias filas, cuenta los grupos de valores y compáralos con la lista de columnas. Si hay siete columnas, cada tupla necesita siete valores, incluido un NULL explícito cuando no se conoce un campo opcional. Revisa todo el conjunto antes de ejecutarlo: una tupla mal formada puede impedir que termine la inserción prevista. Después, consulta los identificadores insertados y confirma que estén todas las filas esperadas. Esta revisión cobra más valor cuando INSERT contiene más que una sola fila de ejemplo.
Errores habituales y práctica
Los errores comunes son olvidar la lista de columnas, cambiar el orden de los valores, escribir 'NULL', reutilizar una clave primaria, insertar en la base equivocada y asumir que una consulta terminada garantiza que exista la fila correcta. Comprueba el contexto, enumera las columnas y consulta la fila por su ID. INSERT modifica datos incluso en una base de práctica.
Practica en JaviBuildsLab. Antes de cada inserción, confirma la base y elige un ID libre. Los ejemplos son independientes y no deben ejecutarse repetidamente como un único lote.
- Añade el cliente 15, Imani Brooks, en Boise, Idaho, sin correo electrónico.
- Añade dos clientes con los ID 16 y 17 en una instrucción; el segundo debe tener Email NULL.
- Sin valores predeterminados, ¿qué columnas son obligatorias? Consulta la definición y encuentra las columnas
NOT NULL. - ¿Por qué el ejemplo proporciona
CustomerIdmientras que muchas tablas con identidad omiten la clave? - Escribe una consulta para verificar el cliente 15.
Respuestas
-- 1
INSERT INTO dbo.Customers (CustomerId, FirstName, LastName, City, State, CreatedDate)
VALUES (15, N'Imani', N'Brooks', N'Boise', 'ID', '2026-10-21');
-- 2
INSERT INTO dbo.Customers (CustomerId, FirstName, LastName, City, State, Email, CreatedDate)
VALUES
(16, N'Eli', N'Park', N'Juneau', 'AK', N'eli.park@example.com', '2026-10-21'),
(17, N'Sara', N'Bell', N'Madison', 'WI', NULL, '2026-10-21');
-- 5
SELECT CustomerId, FirstName, LastName, Email
FROM dbo.Customers
WHERE CustomerId = 15;En el ejercicio 3, CustomerId, FirstName, LastName y CreatedDate son NOT NULL; los demás campos de cliente admiten NULL. El ejercicio 4 depende del esquema real: aquí se asigna la clave manualmente. Cuando la fila esté creada, continúa con los fundamentos de UPDATE y aprende a previsualizar las filas antes de modificarlas.
- Nuevos valores
- INSERT INTO dbo.Customers
- Nueva fila agregada
- Verificación SELECT
- Confirmar fila insertada
Para los valores ausentes, consulta también la lección sobre NULL. Consulta tu progreso en la hoja de ruta SQL Server Foundations.
Comprueba lo que has aprendido
2 preguntas rápidas
Fundamentos de SQL Server
Lección 16 de 25
¿Te resultó útil este contenido?
¿Qué podríamos mejorar?
Gracias — esto me ayuda a mejorar Javi Builds.
Sigue aprendiendo
- Guía rápidaComprobar el uso de índicesRevisa la actividad de lectura y escritura de los índices de SQL Server, identifica los índices de poco valor y decide cuáles merecen un análisis más profundo antes de eliminar ninguno.Abrir guía rápida
- Hoja de rutaSQL Server FoundationsAprende a insertar una o varias filas en SQL Server con columnas explícitas y a comprobar el resultado mediante SELECT.Ver hoja de ruta
¿Qué debería crear después?
Estoy construyendo Javi Builds alrededor de problemas reales que enfrentan los ingenieros de datos. Dime qué tema te gustaría ver después.
Mantente al día
Recibe solo las novedades de Javi Builds que realmente te interesan.
Revisa tu bandeja de entrada
Te he enviado un enlace de confirmación. Tu suscripción se activará cuando la confirmes.