Cómo comentar en SQL

Problema:

Le gustaría hacer algunos comentarios en su código SQL.

Ejemplo:

Aquí está el código de ejemplo:

SELECT
  name,
  COUNT(*) AS count_items
FROM products
GROUP BY name
HAVING COUNT(*) > 5
ORDER BY name DESC;

Solución 1:

Usar --. Esto es lo que parece:

-- product names along with the number of items
-- products ordered by name in descending order
SELECT
  name,
  COUNT(*) -- AS count_items
FROM products
GROUP BY name
-- HAVING COUNT(*) > 5
ORDER BY name DESC;

Discusión:

Puede escribir comentarios de una sola línea en SQL usando --. Después de --, puede escribir cualquier comentario que desee, siempre que esté en una sola línea. Si desea escribir un comentario que abarque varias líneas, puede usar -- al principio de cada línea de comentario, tal como en el ejemplo:

-- product names along with the number of items
-- products ordered by name in descending order

También puede usar -- para comentar una línea completa de código o una parte de una línea desde algún lugar en el medio de la línea hasta el final de la línea. Por ejemplo, puede comentar AS count_item s pero deja el COUNT(*) en.

COUNT(*) -- AS count_items

Tenga en cuenta que cuando usa --, comenta el código hasta el final de la línea, por lo que no puede usar -- para comentar, por ejemplo, solo la palabra clave AS. Si quiere hacer esto, eche un vistazo a la Solución 2.

Solución 2:

Utilice /*...*/ . Esto es lo que parece:

/* product names along with the number of items
   this time, the products aren't sorted */
SELECT
  name,
  COUNT(*) /*AS*/ count_items
FROM products
GROUP BY name
/* HAVING COUNT(*) > 5
ORDER BY name DESC */;

Discusión:

/*...*/ es mucho más poderoso que --. Con /*...*/ , puede comentar cualquier parte del código que desee. El comentario puede ser de varias líneas y usted puede decidir dónde termina. Solo escribe /* al principio del comentario, y */ al final.

Por ejemplo, puede comentar una sola palabra del código, como AS palabra clave:

COUNT(*) /*AS*/ count_items

O puede comentar dos líneas pero dejar el punto y coma al final:

/* HAVING COUNT(*) > 5
ORDER BY name DESC */;