/*...*/ (Commentaire) (Transact-SQL)

Syntaxe

/*
text_of_comment
*/

Arguments

• text_of_comment
  Texte du commentaire. Correspond à une ou plusieurs chaînes de caractères.

Notes

Il est possible d'insérer des commentaires sur une ligne distincte ou à l'intérieur d'une instruction Transact-SQL. Les commentaires de plusieurs lignes doivent être signalés par /* et */. Par convention, on utilise souvent, pour les commentaires de plusieurs lignes, /* au début de la première ligne, ** au début des lignes suivantes, et */ pour signaler la fin du commentaire.

Il n'y a pas de longueur maximale pour les commentaires.

Les commentaires imbriqués ne sont pas pris en charge. Un modèle de caractère /* situé n'importe où dans un commentaire existant est traité comme le début d'un commentaire imbriqué et nécessite dès lors une marque de commentaire de fermeture */. En l'absence de marque de commentaire de fermeture, une erreur est générée.

Par exemple, le code suivant génère une erreur.

DECLARE @comment AS varchar(20);
GO
/*
SELECT @comment = '/*';
*/ 
SELECT @@VERSION;
GO 

Pour corriger cette erreur, apportez la modification suivante.

DECLARE @comment AS varchar(20);
GO
/*
SELECT @comment = '/*';
*/ */
SELECT @@VERSION;
GO 

Exemples

L'exemple suivant utilise des commentaires afin d'expliquer ce que la section du code est supposée faire.

USE AdventureWorks;
GO
/*
This section of the code joins the 
Contact table with the Address table, by using the Employee table in the middle 
to get a list of all the employees in the AdventureWorks database and their 
contact information.
*/
SELECT c.FirstName, c.LastName, a.AddressLine1, a.AddressLine2, a.City
FROM Person.Contact c 
JOIN HumanResources.Employee e ON c.ContactID = e.ContactID 
JOIN HumanResources.EmployeeAddress ea ON e.EmployeeID = ea.EmployeeID
JOIN Person.Address a ON ea.AddressID = a.AddressID;
GO

Voir aussi

Référence

Concepts