SQL Comments: come ag­giun­ge­re commenti in un codice

La funzione SQL Comments è usata per inserire commenti di­ret­ta­men­te nel codice. Si distingue tra commenti su una sola riga, multi-riga o in linea.

Cos’è SQL Comments?

Come in molti altri linguaggi di database e linguaggi di pro­gram­ma­zio­ne, anche nello Struc­tu­red Query Language è prevista la pos­si­bi­li­tà di inserire all’interno del codice commenti che siano leggibili, ma che non abbiano alcun effetto sull’ese­cu­zio­ne. Gli scopi d’impiego sono svariati. Puoi usare la funzione dei commenti in SQL per spiegare meglio de­ter­mi­na­te parti del codice. Puoi ag­giun­ge­re commenti ed ese­cu­zio­ni per ria­na­liz­za­re il codice in un secondo momento oppure per con­sen­ti­re a un’altra persona di lavorare su di essi. I commenti possono essere usati anche per impedire l’ese­cu­zio­ne di un comando SQL.

A seconda della variante, i commenti in SQL possono essere suddivisi in due o tre categorie:

• Commenti su una sola riga: questi commenti iniziano e finiscono nella stessa riga del codice. Iniziano con --.
• Commenti multi-riga: questi commenti com­pren­do­no più di una riga. Iniziano con /* e finiscono con */.
• Commenti in linea: questi commenti sono un sottotipo dei commenti multi-riga. Vengono inseriti tra due istru­zio­ni e marcati anch’essi con /* e */.

Commenti su una sola riga

I commenti su una sola riga sono indicati da due trattini con­se­cu­ti­vi. Tutto ciò che viene scritto nella riga dopo questi due trattini non viene con­si­de­ra­to nell’ese­cu­zio­ne. La fine del commento coincide con la fine della riga. Dall’inizio della riga suc­ces­si­va il codice viene di nuovo eseguito nor­mal­men­te. I commenti su una sola riga non devono quindi essere chiusi espres­sa­men­te con un carattere.

Per com­pren­de­re meglio il fun­zio­na­men­to vale la pena di dare uno sguardo a un esempio. Nella breve sezione di codice seguente prima del comando SELECT inseriamo un commento che ne descriva meglio lo scopo di utilizzo.

-- Richiamare tutte le voci dalla tabella Collaboratori
SELECT *
FROM Collaboratori;

In questo modo viene con­si­de­ra­to solo il codice da SELECT.

È anche possibile inserire un commento su una sola riga dopo un’istru­zio­ne. Istru­zio­ne e commento possono trovarsi nella stessa riga se il commento segue l’istru­zio­ne. Al contrario non è possibile.

SELECT * -- seleziona tutte le voci
FROM Collaboratori; -- considera la tabella chiamata Collaboratori

Commenti multi-riga

I commenti in SQL che si estendono su più righe fun­zio­na­no in modo leg­ger­men­te diverso. Oltre a un punto di inizio devono avere anche un punto di fine. Tutto il testo che si trova tra questi due punti viene ignorato per l’ese­cu­zio­ne del codice. Per il nostro esempio sopra, il codice potrebbe pre­sen­tar­si come segue:

/* Seleziona tutti i campi
in tutte le righe
dell'intera tabella chiamata Collaboratori: */
SELECT *
FROM Collaboratori;

La funzione SQL Comments può essere usata anche per impedire l’ese­cu­zio­ne di una de­ter­mi­na­ta istru­zio­ne. Può essere utile se l’hai già uti­liz­za­ta, ma vuoi ignorarla tem­po­ra­nea­men­te. Di seguito un esempio:

/ *SELECT*  FROM fatturazione;
SELECT * FROM merci in entrata;
SELECT * FROM resi;
SELECT  *FROM lista clienti;* /
SELECT * FROM collaboratori;

Anche se qui abbiamo inserito cinque istru­zio­ni, il sistema ri­chia­me­rà solo la tabella dei col­la­bo­ra­to­ri. Le voci “fat­tu­ra­zio­ne”, “merce in entrata”, “resi” e “lista clienti”, essendo inseriti all’interno del commento, saranno ignorati.

Commenti in linea

I commenti in linea sono un sottotipo dei normali commenti multi-riga. Avendo un chiaro punto di inizio e di fine possono essere collocati anche in mezzo alle istru­zio­ni. L’im­por­tan­te è che non com­pli­chi­no ec­ces­si­va­men­te la lettura. I commenti in linea possono essere un’ottima scelta per spiegare meglio una de­ter­mi­na­ta parte di una riga. Di seguito un facile esempio che mostra come fun­zio­na­no i commenti di questo tipo:

SELECT *
FROM / *Inserire qui il nome della tabella* / Collaboratori;

Il sistema vi­sua­liz­ze­rà li­be­ra­men­te tutta la tabella chiamata “Col­la­bo­ra­to­ri” e tutti i suoi campi e colonne. Il commento è visibile soltanto a te o a un altro utente del codice.