/*...*/ (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 de 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
'-- (Comment) (Transact-SQL)
Langage de contrôle de flux (Transact-SQL)