/*...*/ (Commentaire) (Transact-SQL)
Indique un texte défini par l'utilisateur. Le texte placé entre /* et */ n'est pas évalué par le serveur.
.gif "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