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.

Por JaviPublicado 10 min de lecturaPrincipiante

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:

Consulta SQL: Insertar una fila con una lista de columnasT-SQL
SELECT DB_NAME() AS CurrentDatabase;

SELECT CustomerId, FirstName, LastName
FROM dbo.Customers
WHERE CustomerId = 11;
T-SQL5 líneasVista de solo lectura. No está conectada a ninguna base de datos.

Para continuar, la primera consulta debe mostrar JaviBuildsLab y la segunda no debe devolver filas. Entonces puedes añadir el registro:

Consulta SQL: Insertar una fila con una lista de columnasT-SQL
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'
);
T-SQL20 líneasVista de solo lectura. No está conectada a ninguna base de datos.

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:

Consulta SQL: Omitir una columna que permite NULLT-SQL
INSERT INTO dbo.Customers
    (CustomerId, FirstName, LastName, City, State, CreatedDate)
VALUES
    (12, N'Rosa', N'Chen', N'Phoenix', 'AZ', '2026-10-21');
T-SQL4 líneasVista de solo lectura. No está conectada a ninguna base de datos.

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:

Consulta SQL: Agregar unas pocas filasT-SQL
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');
T-SQL5 líneasVista de solo lectura. No está conectada a ninguna base de datos.

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:

Consulta SQL: Verificar la fila insertadaT-SQL
SELECT
    CustomerId,
    FirstName,
    LastName,
    City,
    State,
    Email,
    CreatedDate
FROM dbo.Customers
WHERE CustomerId = 11;
T-SQL10 líneasVista de solo lectura. No está conectada a ninguna base de datos.

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.

  1. Añade el cliente 15, Imani Brooks, en Boise, Idaho, sin correo electrónico.
  2. Añade dos clientes con los ID 16 y 17 en una instrucción; el segundo debe tener Email NULL.
  3. Sin valores predeterminados, ¿qué columnas son obligatorias? Consulta la definición y encuentra las columnas NOT NULL.
  4. ¿Por qué el ejemplo proporciona CustomerId mientras que muchas tablas con identidad omiten la clave?
  5. Escribe una consulta para verificar el cliente 15.

Respuestas

Consulta SQL: RespuestasT-SQL
-- 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;
T-SQL14 líneasVista de solo lectura. No está conectada a ninguna base de datos.

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.

  1. Nuevos valores
  2. INSERT INTO dbo.Customers
  3. Nueva fila agregada
  4. Verificación SELECT
  5. Confirmar fila insertada
Insertar una fila y volver a leerla para verificar

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

Pregunta 1 de 2¿Qué añade INSERT a una tabla?
Pregunta 2 de 2¿Por qué conviene indicar las columnas de destino en INSERT?

Fundamentos de SQL Server

Lección 16 de 25

Continuar a la siguiente lección

Fundamentos de UPDATE en SQL Server

Continuar a la lección 17

Etiquetas

  • SQL Server
  • Fundamentos de SQL
  • SSMS
  • T-SQL