Barre oblique étoile (bloc de commentaire) (Transact-SQL)

Article
10/16/2024

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric

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

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 AdventureWorks2022;  
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 AdventureWorks2022 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

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

Partager via