Condividi tramite

  • Articolo

Commenti

I commenti sono stringhe di testo, note anche come osservazioni, incluse nel codice nel programma, che tuttavia non vengono eseguite. I commenti possono essere utilizzati per documentare il codice o disabilitare temporaneamente parti di istruzioni e batch Transact-SQL a fini diagnostici. L'utilizzo dei commenti per documentare il codice semplifica la manutenzione del codice di programmi creati successivamente. I commenti vengono in molti casi utilizzati per registrare il nome del programma e dell'autore, nonché le date in cui vengono apportate le principali modifiche del codice. È possibile utilizzare i commenti per descrivere calcoli complessi o illustrare un metodo di programmazione.

In SQL Server sono supportati due tipi di caratteri di commento:

  • -- (trattino doppio). Questi caratteri di commento possono essere inseriti nella stessa riga di codice da eseguire oppure in una riga distinta. Il testo compreso tra il trattino doppio e la fine della riga corrisponde al commento. Se un commento occupa più righe, è necessario inserire il trattino doppio all'inizio di ogni riga del commento. Per ulteriori informazioni sull'utilizzo dei caratteri di commento, vedere -- (commento) (Transact-SQL).

  • /* ... */ (coppia di caratteri barra-asterisco). Questi caratteri di commento possono essere inseriti nella stessa riga di codice da eseguire oppure in una riga distinta o all'interno del codice eseguibile. Il testo compreso tra la coppia di caratteri di apertura (/*) e la coppia di caratteri di chiusura (*/) viene considerato parte del commento. I commenti che occupano più righe devono iniziare con la coppia di caratteri di apertura (/*) e terminare con la coppia di caratteri di chiusura (*/). Per ulteriori informazioni sull'utilizzo dei caratteri di commento /* ... */, vedere /*...*/ (commento) (Transact-SQL).

Considerazioni

Di seguito sono riportate alcune informazioni relative ai commenti:

  • In un commento è possibile utilizzare tutti i simboli e i caratteri alfanumerici. In SQL Server vengono ignorati tutti i caratteri inclusi in un commento, mentre nell'editor del codice di SQL Server Management Studio e nell'utilità sqlcmd vengono cercate le occorrenze di GO, ovvero i primi due caratteri utilizzati nelle righe di un commento su più righe.

  • Per i commenti di un batch non è prevista una lunghezza massima. Un commento può contenere una o più righe.

Esempi

Di seguito sono riportati alcuni esempi di commenti validi.

USE AdventureWorks2008R2;
GO
-- Single line comment.

SELECT BusinessEntityID, Title
FROM HumanResources.Employee;
GO

/* First line of a multiple-line comment.
   Second line of a multiple-line comment. */
SELECT Name, ProductNumber, Color
FROM Production.Product;
GO

-- Using a comment in a Transact-SQL statement
-- during diagnosis.
SELECT BusinessEntityID, /* FirstName, */ LastName
FROM Person.Person;

-- Using a comment after the code on a line.
USE AdventureWorks2008R2;
GO
UPDATE Production.Product
SET ListPrice = ListPrice * .9; -- Reduce price to build market share.
GO