Es fundamental entender cómo comentar en SQL cuando estás trabajando en tu código. Los comentarios no solo te ayudan a explicar tu lógica a otros programadores, sino que también pueden ser útiles para ti mismo en el futuro cuando necesites recordar por qué escribiste cierta parte de código de una manera particular. Afortunadamente, SQL ofrece varias formas de comentar tu código, ya sea una línea o varias líneas a la vez. Aquí te explicaremos las diferentes técnicas y mejores prácticas para comentar en SQL.

¿Qué encontrarás en este post?

Aprende a comentar en SQL

Comentar una línea en SQL

Vamos a empezar con algo muy sencillo para que aprendas cómo comentar en SQL. Iniciarás comentando una sola línea en SQL. Todo lo que necesitas hacer es agregar dos guiones dobles (--) al principio de la línea que deseas comentar. Por ejemplo:

-- Esta es una consulta para obtener el nombre y la edad de los clientes
SELECT nombre, edad FROM clientes;

El comentario aquí explicaría brevemente lo que hace la consulta.

Comentar varias líneas en SQL

Ahora bien, si lo que necesitas es comentar varias líneas a la vez, SQL te permite hacerlo utilizando la sintaxis /* */. Por ejemplo:

/*
Esta es una consulta más compleja que calcula el promedio de ventas mensuales.
Utilizamos la función AVG() para calcular el promedio.
*/
SELECT AVG(ventas) AS promedio_ventas
FROM ventas
WHERE fecha BETWEEN '2023-01-01' AND '2023-12-31';

Este tipo de comentario es útil para explicar bloques de código más extensos y complejos.

Comentarios anidados en SQL

Hay un aspecto crucial y es que SQL también admite comentarios anidados, lo que significa que puedes tener comentarios dentro de otros comentarios. Sin embargo, es importante recordar cerrar correctamente todos los comentarios anidados para evitar errores en tu código. Por ejemplo:

/*
Este es un comentario principal.
/* Este es un comentario anidado dentro del comentario principal */
Este es el final del comentario principal.
*/

Al escribir comentarios anidados, asegúrate de mantener un seguimiento claro de dónde comienzan y terminan para evitar confusiones.

Poner y quitar marcas de comentario al código SQL

Imagina que estás trabajando en un proyecto de base de datos utilizando un editor de SQL como SQL Server Management Studio o DBeaver. En tu código SQL, tienes una consulta larga que deseas comentar temporalmente para probar una teoría o realizar una corrección.

Seleccionas las líneas de código que deseas comentar. Por ejemplo:

SELECT nombre, apellido, direccion
FROM clientes
WHERE ciudad = 'Madrid';

Luego, haces clic derecho sobre las líneas seleccionadas para abrir el menú emergente del editor.
En el menú emergente, buscas la opción para comentar las líneas seleccionadas. Esta opción suele estar etiquetada como “Comentar” o “Comentar líneas”.
Haces clic en esa opción y, automáticamente, el editor agrega el símbolo de comentario apropiado al inicio de cada línea seleccionada. En el caso de SQL, esto serían dos guiones dobles (--).

Después de realizar estos pasos, tu consulta quedaría comentada de esta manera:

-- SELECT nombre, apellido, direccion
-- FROM clientes
-- WHERE ciudad = 'Madrid';

Ahora, la consulta está desactivada y no se ejecutará cuando realices pruebas o pruebas de concepto adicionales. Cuando necesites volver a activarla, simplemente repites estos pasos pero eligiendo la opción para descomentar las líneas seleccionadas. Esto eliminará los símbolos de comentario y restaurará la funcionalidad original de la consulta.

¿Por qué es tan importante comentar en SQL?

Comentar en SQL es una práctica recomendada en el desarrollo de software por varias razones:

Facilitan la comprensión: Ayudan a otros programadores (y a ti mismo en el futuro) a entender rápidamente qué hace una parte específica de código.
Documentan el código: Sirven como documentación integrada, lo que facilita el mantenimiento y la depuración del código.
Fomentan buenas prácticas de programación: El hábito de comentar el código promueve una programación más clara y estructurada.

Ya has aprendido que comentar en SQL no solo es una buena práctica, sino que también puede ahorrarte tiempo y esfuerzo a largo plazo. Esta habilidad de comentar en SQL es esencial para cualquier programador que trabaje con bases de datos. Ya sea que estés explicando la lógica detrás de una consulta compleja o documentando un procedimiento almacenado, los comentarios te ayudarán a mantener tu código organizado y comprensible.

Recuerda utilizar las diferentes técnicas de comentar varias líneas y anidar comentarios según sea necesario para mantener tu código limpio y legible. También puedes aprender sobre las funciones en SQL con nuestro Curso en SQL.

Si estás interesado en dominar SQL y otras habilidades técnicas, considera unirte al Bootcamp de Big Data, Data Science, Machine Learning e IA de KeepCoding. En nuestro bootcamp, no solo aprenderás las habilidades técnicas necesarias para triunfar en el sector IT, sino que también te prepararás para una carrera emocionante y lucrativa. ¡Únete a nosotros y cambia tu vida hoy mismo!