Partager via

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

  • Article

Indique un texte défini par l'utilisateur. Le texte placé entre /* et */ n'est pas évalué par le serveur.

Icône Lien de rubrique Conventions de la syntaxe 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 AdventureWorks2012;
GO
/*
This section of the code joins the Person table with the Address table, 
by using the Employee and BusinessEntityAddress tables in the middle to 
get a list of all the employees in the AdventureWorks2012 database 
and their contact information.
*/
SELECT p.FirstName, p.LastName, a.AddressLine1, a.AddressLine2, a.City, a.PostalCode
FROM Person.Person AS p
JOIN HumanResources.Employee AS e ON p.BusinessEntityID = e.BusinessEntityID 
JOIN Person.BusinessEntityAddress AS ea ON e.BusinessEntityID = ea.BusinessEntityID
JOIN Person.Address AS a ON ea.AddressID = a.AddressID;
GO

Voir aussi

Référence

'-- (Comment) (Transact-SQL)

Langage de contrôle de flux (Transact-SQL)