Una de las primeras cosas que se hacen al empezar a aprender algún lenguaje, es ver el tema de los comentarios. Pues eso es lo que haremos en este capítulo, los comentarios SQL.
¿Para qué sirven los comentarios en SQL?
En SQL, los comentarios sirven para describir el propósito y funcionamiento de un bloque de código o consulta.
De momento, puesto que no vamos a escribir consultas muy elaboradas, no le encontrarás gran utilidad, pero cuando empieces a escribir código complejo, te será de gran ayuda para visualizar lo que hace cada parte de este.
Además, ten en cuenta, que puede que otros editen o lean tu código. De esta forma, facilitarás mucho el trabajo.
Empecemos a ver la sintaxis de los comentarios SQL.
Te recomiendo que todo lo que vaya utilizando durante el curso, lo vayas probando, no te limites solo a mirar lo que hago. De esta forma, recordarás más cosas.
Sintaxis de los comentarios SQL
Para empezar a escribir, abre MySQL Workbench. Todo el código que escriba, será en la sección del editor de código, la parte blanca central del programa.
Comentarios de una línea
Los comentarios de una línea, son los que podemos escribir para comentar una sola línea de código.
Para crear uno de estos comentarios, debes poner dos guiones (--). A partir de eso, podrás escribir lo que quieras, pero solo sobre la misma línea.
Es importante que dejes un espacio entre los dos guiones y el texto del comentario, de otra forma, no te lo reconocerá.
Para saber si un comentario es aceptado como tal (está correctamente especificado en el código), verás que en los diferentes editores de código, no solo en Workbench, estas líneas cambian de color.
En workbench la línea se vuelve azul, aunque es frecuente ver los comentarios en color gris, como los que te escribo en las cajas de código de aquí abajo.
No te preocupes por entender la segunda línea de código. Solo fíjate en los comentarios en este capítulo.
-- Este es un comentario de línea SELECT * FROM Clientes;
Los comentarios, también se pueden usar para anular una línea de código. Esto lo necesitaremos cuando queramos probar cierto código, anulando una línea, de forma que sea como si la hubiéramos borrado, pero sin borrarla.
En este caso, seguimos manteniendo la línea de código, por si la necesitamos más tarde, pero será como si no estuviera al ejecutar la consulta.
-- SELECT * FROM Clientes;
Fuera del estándar SQL, tenemos un tipo de comentario de una línea empleado solo en algunas implementaciones SQL, como es el caso de MySQL. Se trata del símbolo '#'.
# Este es un comentario de línea SELECT * FROM Clientes;
Además, debes saber que puedes comentar sin problemas al final de una instrucción. Aquí tienes un ejemplo:
SELECT * FROM Clientes; -- Este es un comentario de línea
SELECT * FROM Clientes; # Este es un comentario de línea
Los comentarios multilínea
Los comentarios multilínea funcionan de la misma forma que los de una línea, con la gran diferencia, de que estos los puedes utilizar en más de una línea a la vez.
Este tipo de comentarios se escribe con una apertura /* y un cierre */. Mira unos ejemplos:
/* Las siguientes consultas muestran los registros de las tablas city, country y countrylanguage. */ SELECT * FROM world.city; SELECT * FROM world.country; SELECT * FROM world.countrylanguage;
Los puedes escribir como quieras. Solo tienes que colocar primero el cierre y luego la apertura.
Otra forma que se suele usar para hacer el comentario un poco más atractivo y visible, es añadir un asterisco extra en cada línea:
/* * Las siguientes consultas muestran * los registros de las tablas * city, country y countrylanguage. */ SELECT * FROM world.city; SELECT * FROM world.country; SELECT * FROM world.countrylanguage;
Gracias a esta sintaxis de comentarios, si queremos anular varias líneas de código que estén juntas, lo podemos hacer así, rodeando con la apertura y cierre todo lo que queramos anular.
/* Anulamos dos línea de código. SELECT * FROM world.city; SELECT * FROM world.country; */ -- Esta en cambio, sigue activa. SELECT * FROM world.countrylanguage;
Otra cosa que puedes hacer con los multilínea, es meter un comentario entre medio de una instrucción. Algo para nada recomendable, ya que no tiene sentido alguno, pero que sepas qué se puede hacer:
SELECT * FROM /*Seleccionamos todo de la tabla: */ world.city;
Esto funciona, pero como puedes ver, hace que el código sea mucho más confuso. Una solución mejor es la mostrada anteriormente, poner un comentario a la derecha de la instrucción:
SELECT * FROM world.city; # Seleccionamos todo de la tabla city.
Esto es todo para este capítulo.
No te pierdas nada del curso. Aquí tienes el índice con todo el contenido.
