SQL Server
Errores habituales de SQL para principiantes y cómo evitarlos
Detecta errores comunes de SQL con filtros, NULL, JOIN, ordenación y cambios de datos, y sustitúyelos por hábitos más seguros.
En este artículo
SQL es lo bastante legible como para que alguien que empieza escriba una consulta antes de comprender todas sus consecuencias. Una instrucción puede ejecutarse sin errores y, aun así, responder a otra pregunta, devolver más o menos filas de las esperadas o modificar más datos de los previstos. La mejor defensa consiste en repetir algunos hábitos: confirmar el contexto, especificar las columnas y filas que interesan, revisar las relaciones y comprobar el resultado.
Esta lección es una guía de diagnóstico, no sustituye las lecciones anteriores. Úsala cuando un resultado te sorprenda o antes de incorporar una consulta a un script. Los ejemplos usan la base sintética JaviBuildsLab y las tablas dbo.Customers y dbo.Orders. Puedes empezar por tu primera consulta SELECT y consultar después las lecciones de filtrado con WHERE, ordenación con ORDER BY, NULL, JOIN, filas repetidas después de un JOIN y prácticas seguras de UPDATE y DELETE.
Error: ejecutar una consulta en la base de datos equivocada
Una ventana de consultas de SSMS está conectada a un servidor y tiene un contexto de base de datos actual. Puedes elegir otra base en la barra de herramientas, abrir una ventana desde un contexto distinto o suponer que el nombre de una pestaña sigue seleccionado. Una consulta a una tabla con el mismo nombre en otra base puede ejecutarse y devolver filas plausibles que no tienen relación con lo que buscabas. Si la tabla no existe, obtendrás un error de objeto no encontrado.
Antes de explorar o modificar datos, comprueba la sesión directamente:
SELECT DB_NAME() AS CurrentDatabase;Compara el resultado con la base prevista. Si no es JaviBuildsLab, detente y selecciona la base correcta. USE cambia el contexto de la conexión, pero no crea una base ni demuestra que su contenido sea el esperado. En un entorno compartido o de producción, sigue el proceso de conexión aprobado por el equipo.
Mejor hábito: confirma el servidor y la base antes de ejecutar un script que dependa de ambos. Añade una comprobación de contexto si ejecutarlo en la base equivocada puede tener consecuencias importantes.
Error: usar SELECT * en todas partes
SELECT * resulta cómodo para conocer una tabla, pero solicita todas sus columnas. Puede incluir campos que un informe no necesita, dificultar la lectura y crear una dependencia de columnas que nunca formaban parte del resultado previsto. Si alguien agrega una columna más adelante, la forma de la salida puede cambiar aunque la consulta no lo haga.
Es mejor indicar las columnas:
SELECT CustomerId, FirstName, LastName, City
FROM dbo.Customers;Así se revisa mejor el resultado y queda clara la intención. Durante una exploración, SELECT TOP (10) * puede servir para conocer datos nuevos; añade ORDER BY si necesitas una muestra repetible. No arrastres ese atajo a código de aplicaciones, exportaciones o informes guardados sin revisarlo.
Mejor hábito: nombra las columnas que responden a la pregunta. Asigna alias útiles a las expresiones y califica una columna con el alias de su tabla si varias fuentes comparten el mismo nombre.
Error: olvidar WHERE
Un UPDATE o DELETE sin una condición WHERE puede afectar a todas las filas de la tabla. Un SELECT sin el filtro previsto puede devolver muchos más datos de los que esperabas. SQL Server ejecuta la instrucción escrita; no puede adivinar qué subconjunto querías.
Antes de cambiar datos, previsualiza las filas:
SELECT CustomerId, FirstName, State
FROM dbo.Customers
WHERE CustomerId = 11;Comprueba que la vista previa contiene exactamente las filas deseadas. Reutiliza la misma tabla y condición en el cambio y después verifica el resultado. Un filtro que parece preciso puede coincidir con varios registros, así que revisa las filas reales y cuenta las coincidencias.
Mejor hábito: escribe y ejecuta primero el SELECT. Para modificar datos, sigue el flujo que empieza con SELECT y practica solo en una base de pruebas conocida. Nunca quites un WHERE para hacer que una consulta funcione.
Error: suponer que las filas tienen un orden
Las tablas no prometen un orden de presentación. Una consulta puede parecer ordenada por inserción o por clave primaria en una ejecución, pero no es una garantía. Otro plan, índice, versión del servidor o cambio de datos puede devolverlas en otro orden.
Si el orden importa, decláralo:
SELECT TOP (5) OrderId, OrderDate, Amount
FROM dbo.Orders
ORDER BY OrderDate DESC, OrderId DESC;La segunda columna de ordenación hace deterministas los empates. TOP sin ORDER BY limita el resultado, pero no significa “los más recientes”, “los primeros” ni ningún otro subconjunto concreto. La lección de ordenación con ORDER BY explica cómo definir el orden deseado.
Mejor hábito: considera que el orden no está definido si falta ORDER BY. Cuando uses TOP, define qué filas quieres antes de limitar el resultado.
Error: comparar NULL con el signo igual
NULL representa información ausente o desconocida. No es un valor normal, por lo que Email = NULL no busca direcciones de correo ausentes. La comparación produce un resultado desconocido y no selecciona las filas que espera un principiante. Una cadena vacía ('') es un valor; NULL es distinto.
Usa los predicados correspondientes:
SELECT CustomerId, Email
FROM dbo.Customers
WHERE Email IS NULL;Usa IS NOT NULL para encontrar filas que tienen un valor. No sustituyas los datos ausentes por una cadena vacía solo para facilitar una comparación; cambiarías su significado. Consulta Entender NULL en SQL Server para ver cómo afecta lo desconocido a las condiciones y los agregados.
Mejor hábito: usa IS NULL o IS NOT NULL y decide explícitamente cómo debe mostrar la aplicación la información ausente.
Error: confundir WHERE y HAVING
WHERE filtra filas de origen antes de formar grupos. HAVING filtra grupos después de calcular agregados. Poner COUNT(*) dentro de WHERE no es válido porque los grupos todavía no existen en esa etapa. Una condición de fila en HAVING puede funcionar en algunos casos, pero esconde la secuencia prevista y puede realizar trabajo innecesario.
En este ejemplo, primero se seleccionan pedidos completos y luego los clientes con al menos dos pedidos que cumplen el filtro:
SELECT CustomerId, COUNT(*) AS OrderCount
FROM dbo.Orders
WHERE Status = N'Complete'
GROUP BY CustomerId
HAVING COUNT(*) >= 2;El estado describe cada pedido; el recuento describe cada grupo de clientes. La lección WHERE frente a HAVING explica la diferencia.
Mejor hábito: pregunta si una condición describe una fila de origen o un grupo agregado. Coloca las condiciones de fila en WHERE y las de grupo en HAVING.
Error: esperar que un JOIN de uno a varios mantenga una fila por cliente
Un cliente puede realizar varios pedidos. Al unir Customers y Orders por CustomerId, se devuelve una fila por cada par de cliente y pedido coincidente. Por eso, un cliente con tres pedidos aparece tres veces. No son necesariamente registros duplicados: cada fila representa una relación.
Decide qué debe representar una fila antes de escribir el JOIN. Si necesitas una fila por pedido, repetir los datos del cliente es normal. Si necesitas una fila por cliente, agrega los pedidos o elige otra forma de consulta. Un LEFT JOIN también conserva a los clientes sin pedidos y muestra NULL en las columnas del pedido. Consulta la lección de JOIN y la guía de filas repetidas después de un JOIN.
Mejor hábito: define el grano en palabras sencillas, por ejemplo, “una fila por pedido”. Haz que el JOIN y el agrupamiento respeten esa intención.
Error: añadir DISTINCT para ocultar un JOIN incorrecto
DISTINCT elimina filas idénticas en las columnas seleccionadas. No corrige una condición de unión ausente ni demuestra que dos tablas estén relacionadas correctamente. Si un JOIN combina por error todos los clientes con todos los pedidos, DISTINCT puede ocultar algunas repeticiones, pero la relación sigue siendo incorrecta. También puede eliminar repeticiones legítimas cuando las columnas seleccionadas no identifican de forma única el evento del negocio.
Revisa la condición ON, compara los recuentos de filas antes y después del JOIN e inspecciona algunas claves. Si el resultado debe tener una fila por entidad, usa un agrupamiento o una comprobación de existencia que exprese ese objetivo.
Mejor hábito: averigua por qué se repiten las filas antes de usar DISTINCT. Úsalo cuando la unicidad forme parte del resultado solicitado, no como arreglo cosmético.
Error: no calificar columnas con el mismo nombre
Tanto Customers como Orders pueden contener CustomerId. Al incluir las dos tablas, escribir solo ese nombre puede ser ambiguo. SQL Server informa del error en vez de adivinar. Aunque todavía sea único, calificar el nombre deja claro su origen.
SELECT c.CustomerId, c.FirstName, o.OrderId, o.Amount
FROM dbo.Customers AS c
INNER JOIN dbo.Orders AS o
ON o.CustomerId = c.CustomerId;c y o son alias de tabla que solo existen durante esta instrucción. No cambian el nombre de las tablas en la base. La lección de alias de tablas y columnas explica la diferencia.
Mejor hábito: califica las columnas compartidas y usa alias que ayuden a leer consultas con varias tablas.
Error: ejecutar UPDATE o DELETE sin comprobar las filas objetivo
Una instrucción sintácticamente válida aún puede ser peligrosa. Una condición mal escrita o demasiado amplia, o una base equivocada, puede cambiar los registros incorrectos. El mensaje “filas afectadas” no demuestra que el cambio sea correcto; solo indica cuántas filas se modificaron.
Usa el mismo filtro en una vista previa y en el cambio. Comprueba las filas y su número, ejecuta la modificación en un entorno seguro y verifica el resultado. Para practicar, usa una transacción y revierte el cambio, salvo que quieras conservarlo deliberadamente. En producción, sigue los procedimientos de revisión y copia de seguridad de la organización.
Mejor hábito: previsualiza, cuenta, cambia y verifica; después decide. Sigue las prácticas seguras de UPDATE y DELETE.
Error: tratar NULL como una cadena vacía
Una cadena vacía indica que existe un valor de texto con cero caracteres. NULL indica que no hay un valor conocido o registrado. Pueden tener sentidos diferentes: un cliente quizá no quiso indicar su correo (NULL), mientras que un sistema de origen pudo importar una cadena vacía. Las comparaciones, los recuentos y la presentación pueden tratarlos de distinta manera.
Por ejemplo, COUNT(Email) omite valores NULL, mientras que COUNT(*) cuenta las filas. Sustituir NULL por '' cambia los datos y puede reducir la precisión del análisis. En cambio, la capa de presentación puede mostrar una etiqueta amable para un dato ausente sin modificar el valor almacenado.
Mejor hábito: define qué significa “ausente” en el dominio. Mantén deliberado el significado almacenado y usa COALESCE o formato de presentación solo cuando la salida necesite un sustituto.
Error: suponer que un alias cambia el nombre de un objeto del esquema
SELECT Amount AS OrderTotal cambia la etiqueta de la columna en el resultado de esa consulta. FROM dbo.Orders AS o da un nombre corto a la tabla mientras se ejecuta la instrucción. Ninguna de las dos cosas cambia el nombre de una columna o tabla en la base. Otra consulta sigue teniendo que usar el objeto almacenado, como dbo.Orders.
Los cambios de objetos de base de datos son tareas administrativas distintas y pueden afectar a aplicaciones, permisos y dependencias. No uses un alias como prueba de que se modificó el esquema.
Mejor hábito: diferencia las etiquetas del resultado y los alias locales de las definiciones permanentes. Gestiona los cambios del esquema mediante migraciones revisadas.
Error: copiar SQL sin entender sus supuestos
Un ejemplo de un foro, un script antiguo o una respuesta generada puede usar otros nombres de tablas y columnas, otros valores de clave o supuestos distintos sobre los datos. Quizá no incluya un filtro porque su autor lo ejecutaba sobre datos desechables. Incluso podría usar una sintaxis válida en otro producto de base de datos, pero no en SQL Server.
Antes de adaptar el SQL, identifica el motor, las tablas y columnas requeridas, las filas que podría afectar y el resultado que esperas. Siempre que sea posible, prueba primero una versión de solo lectura. Compara la salida con un ejemplo conocido y revisa cada cláusula en vez de pegar toda la instrucción en una ventana de producción.
Mejor hábito: explica cada cláusula antes de ejecutarla. Si no puedes prever el resultado, prueba la idea con una muestra segura y consulta la lección correspondiente o la documentación oficial.
Una rutina rápida de diagnóstico
Cuando el resultado parezca incorrecto, detente y revisa lo básico en orden. Confirma el servidor y DB_NAME(). Comprueba las columnas, las tablas y los filtros. Revisa la lógica de NULL. Averigua si un JOIN puede devolver varias filas por entidad y decide qué representa cada una. Añade ORDER BY si importa el orden. Antes de modificar datos, previsualiza y cuenta las filas objetivo. Por último, compara el resultado con la pregunta original.
- Detectar el error
- Revisar contexto y grano
- Adoptar un mejor hábito
- Previsualizar y verificar
La práctica hace que estas comprobaciones sean más rápidas. Ten la lista a mano mientras aprendes y después conviértela en una parte normal de la revisión de consultas. La próxima lección presenta un objeto de base de datos que permite reutilizar una consulta con un nombre estable: vistas en SQL Server. También puedes volver a la hoja de ruta de SQL Server Foundations.
Comprueba lo que has aprendido
2 preguntas rápidas
Fundamentos de SQL Server
Lección 20 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 FoundationsDetecta errores comunes de SQL con filtros, NULL, JOIN, ordenación y cambios de datos, y sustitúyelos por hábitos más seguros.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.