Commenti del server SQL

Le dichiarazioni SQL sono significative per interagire e lavorare con i database. Tali affermazioni possono essere una singola riga di codice o domande multiple. Se hai molte dichiarazioni SQL, può diventare difficile conoscere lo scopo previsto del codice.

Un ottimo modo per aiutare a mantenere e migliorare la leggibilità sulle tue dichiarazioni SQL è l'uso dei commenti. Ad esempio, è possibile aggiungere commenti al documento o descrivere la lucidità dello script. Poiché il server SQL non esegue i commenti SQL, possiamo anche usarli per disattivare un blocco di codice specifico, consentendo a debug e refactor sul codice.

Questo tutorial imparerà come utilizzare e aggiungere commenti alle tue query SQL. Discuteremo di come utilizzare commenti a linea singola e multipla in SQL Server.

Le basi

Esistono due modi principali che puoi utilizzare per creare commenti nelle tue query SQL. Il primo utilizza un doppio trattino e l'altro utilizza una barra in avanti e un asterisco.

Impariamo come creare commenti usando le sintassi descritte sopra.

Commenti a linea singola

Per creare un commento a linea singola nelle query SQL Server, utilizzare il simbolo -. La sintassi è come mostrata:

-- comment_text

Quando SQL Server incontra una riga che inizia con il simbolo -, ignorerà tutto il contenuto fino alla fine della linea. Il personaggio della nuova linea funge da valore finale per un commento che inizia con - simboli.

Considera l'esempio mostrato di seguito:

-- Ottieni 5 valori dalla tabella dei clienti
Seleziona Top 5 * dai clienti;

Nell'esempio di query SQL sopra, utilizziamo un commento a linea singola per aggiungere una descrizione dell'azione eseguita dall'istruzione SQL che segue.

È bene notare che non esiste un limite massimo per il numero di caratteri che un commento contiene.

Utilizzando Microsoft SQL Server Management Studio, è possibile aggiungere un commento a linea singola utilizzando il collegamento tastiera CTRL + K, CTRL + C.

È inoltre possibile utilizzare l'interfaccia grafica facendo clic sull'icona mostrata di seguito nella barra degli strumenti principale.

Una volta selezionati e utilizzati le scorciatoie da tastiera o l'icona del commento, il server SQL aggiungerà due trattini e commenterà la riga set.

Commenti multi-line

L'altro tipo di commento è commenti multi-line o blocchi. Questi sono il tipo di commenti che si estendono più di una singola riga, come un paragrafo.

Diciamo che desideri commentare le seguenti righe:

-- Ottieni il nome del cliente
-- Ottieni cognome del cliente
Seleziona Top 5 FirstName, LastName dai clienti;

Noti che dobbiamo aggiungere due commenti a linea singola. Questo metodo rende il codice illeggibile e ripetitivo.

Possiamo risolvere questo problema inserendo un commento multilinea usando la sintassi mostrata di seguito:

/* Commenta qui
Un'altra riga
e un altro
*/

SQL Server utilizza A / * per aprire un commento multi-line e * / per chiudere il blocco dei commenti. SQL Server ignorerà qualsiasi testo specificato all'interno di tali blocchi.

Considera il codice di esempio mostrato di seguito:

I commenti multi-line sono molto utili quando si hanno commenti che estendono più righe. Puoi anche usarli per visualizzare informazioni utili come autore, data e altro ancora.

/*
Autore: Linuxhint;
Categoria: SQL Server;
Pub: 2022;
*/
Seleziona Top 5 FirstName, LastName dai clienti;

Allo stesso modo, i commenti del blocco possono disabilitare più query SQL.

Conclusione

Questa guida ti insegna come lavorare con i commenti SQL Server per aggiungere informazioni ai tuoi script SQL. Il commento del codice aiuta a migliorare la leggibilità e la manutenzione del codice da parte di altri sviluppatori. Prendi l'abitudine di commentare il tuo codice.

Grazie per aver letto.