Comentario de MySQL en profundidad

Resumen: en este tutorial, aprenderá a usar el comentario de MySQL para documentar una declaración SQL o un bloque de código en MySQL.

Los comentarios se pueden usar para documentar el propósito de una instrucción SQL o la lógica de un bloque de código en un procedimiento almacenado. Al analizar el código SQL, MySQL ignora la parte de comentarios. Solo ejecuta la parte SQL excepto el comentario ejecutable, que discutiremos en la siguiente sección.

MySQL admite tres estilos de comentarios:

1. Desde un "-- " hasta el final de la línea. El estilo de comentario de doble guión requiere al menos un espacio en blanco o un carácter de control (espacio, tabulación, nueva línea, etc.) después del segundo guión.

   SELECT * FROM users; -- This is a comment

   Tenga en cuenta que el SQL estándar no requiere un espacio en blanco después del segundo guión. MySQL usa un espacio en blanco para evitar problemas con alguna construcción SQL como:

   SELECT 10--1;

   La declaración devuelve 11. Si MySQL no usara el espacio en blanco, lo haría devuelve 10 en su lugar.

2. Desde "#" hasta el final de la línea.

   SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1002; # get subordinates of Diane

3. El comentario de estilo C /**/ puede abarcar varias líneas. Utiliza este estilo de comentario para documentar un bloque de código SQL.

   /* Get sales rep employees that reports to Anthony*/SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1143 AND jobTitle = "Sales Rep";

Tenga en cuenta que MySQL no admite comentarios anidados.

Comentarios ejecutables

MySQL proporciona comentarios ejecutables para admitir la portabilidad entre diferentes bases de datos. Estos comentarios le permiten incrustar código SQL que se ejecutará solo en MySQL pero no en otras bases de datos.

Lo siguiente ilustra la sintaxis del comentario ejecutable:

Code language: SQL (Structured Query Language) (sql)

Por ejemplo, la siguiente declaración usa un comentario ejecutable:

Code language: SQL (Structured Query Language) (sql)

La declaración devuelve 2 en lugar de 1. Sin embargo, devolverá 1 si ejecuta en otros sistemas de bases de datos.

Si desea ejecutar un comentario desde una versión específica de MySQL, use la siguiente sintaxis:

Code language: SQL (Structured Query Language) (sql)