10 - Definición de comentarios

Para aclarar algunas instrucciones, en ocasiones, necesitamos agregar comentarios. También para evitar que se ejecuten uno o más comandos podemos marcar dichas instrucciones con comentarios.
Es posible ingresar comentarios en la línea de comandos, es decir, un texto que no se ejecuta; para ello se emplean dos guiones (--) al comienzo de la línea:

 select * from libros; -- mostramos los registros de libros

en la línea anterior, todo lo que está luego de los guiones (hacia la derecha) no se ejecuta.

Para agregar varias líneas de comentarios, se coloca una barra seguida de un asterisco (/*) al comienzo del bloque de comentario y al finalizarlo, un asterisco seguido de una barra (*/).

 select titulo, autor 
 /*mostramos títulos y
 nombres de los autores*/
 from libros;

todo lo que está entre los símbolos "/*" y "*/" no se ejecuta.

Problema resuelto

Trabajamos con la tabla "libros" que almacena los datos de los libros de una librería.
Borrar la tabla "libros" si ya existe

drop table if exists libros;

Creamos la tabla:

create table libros(
        titulo text,
        autor text,
        editorial text
 );

Agregamos un registro:

 insert into libros (titulo,autor,editorial)
  values ('El aleph','Borges','Emece');

Mostramos todos los libros y agregamos un comentario de linea:

select * from libros; --mostramos los registros de libros 

vamos a mostrar el título y autor de todos los libros y agregamos un bloque de comentarios:

 select titulo, autor 
 /*mostramos títulos y
 nombres de los autores*/
 from libros;

Disponemos el comando select con el objetivo de mostrar todos los datos, pero lo comentamos por el momento:

--select * from libros;

Cualquier editor de SQL nos muestra con un color distinto los bloques de comentarios, en SQLite Browser aparece:

Comentarios en SQLite Browser