SQL Comments: come aggiungere commenti in un codice

La funzione SQL Comments è usata per inserire commenti direttamente 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 programmazione, anche nello Structured Query Language è prevista la possibilità di inserire all’interno del codice commenti che siano leggibili, ma che non abbiano alcun effetto sull’esecuzione. Gli scopi d’impiego sono svariati. Puoi usare la funzione dei commenti in SQL per spiegare meglio determinate parti del codice. Puoi aggiungere commenti ed esecuzioni per rianalizzare il codice in un secondo momento oppure per consentire a un’altra persona di lavorare su di essi. I commenti possono essere usati anche per impedire l’esecuzione 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 comprendono 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 istruzioni e marcati anch’essi con /* e */.

Commenti su una sola riga

I commenti su una sola riga sono indicati da due trattini consecutivi. Tutto ciò che viene scritto nella riga dopo questi due trattini non viene considerato nell’esecuzione. La fine del commento coincide con la fine della riga. Dall’inizio della riga successiva il codice viene di nuovo eseguito normalmente. I commenti su una sola riga non devono quindi essere chiusi espressamente con un carattere.

Per comprendere meglio il funzionamento 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 considerato solo il codice da SELECT.

È anche possibile inserire un commento su una sola riga dopo un’istruzione. Istruzione e commento possono trovarsi nella stessa riga se il commento segue l’istruzione. 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 funzionano in modo leggermente 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’esecuzione del codice. Per il nostro esempio sopra, il codice potrebbe presentarsi 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’esecuzione di una determinata istruzione. Può essere utile se l’hai già utilizzata, ma vuoi ignorarla temporaneamente. 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 istruzioni, il sistema richiamerà solo la tabella dei collaboratori. Le voci “fatturazione”, “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 istruzioni. L’importante è che non complichino eccessivamente la lettura. I commenti in linea possono essere un’ottima scelta per spiegare meglio una determinata parte di una riga. Di seguito un facile esempio che mostra come funzionano i commenti di questo tipo:

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

Il sistema visualizzerà liberamente tutta la tabella chiamata “Collaboratori” e tutti i suoi campi e colonne. Il commento è visibile soltanto a te o a un altro utente del codice.