'-- (Comment) (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Indique un texte défini par l'utilisateur. Il est possible d'introduire des commentaires sur une ligne distincte, imbriquée à la fin d'une ligne de commande Transact-SQL, ou à l'intérieur d'une instruction Transact-SQL. Le serveur n'évalue pas ces commentaires.

Conventions de la syntaxe Transact-SQL

Syntaxe

-- text_of_comment

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

text_of_comment
Chaîne de caractères contenant le texte du commentaire.

Notes

Utilisez deux tirets ( -- ) pour un commentaire d’une seule ligne ou imbriqué. Les commentaires insérés avec -- se terminent par une nouvelle ligne, qui est spécifiée par un caractère de retour chariot (U+000A), un caractère de saut de ligne (U+000D) ou une combinaison des deux. Il n'y a pas de longueur maximale pour les commentaires. Le tableau suivant répertorie les raccourcis clavier que vous pouvez utiliser pour commenter du texte ou annuler les marques de commentaire de ce dernier.

Action Standard
Mettre le texte sélectionné en commentaire Ctrl+K, Ctrl+C
Ne pas commenter le texte sélectionné Ctrl+K, Ctrl+U

Pour plus d’informations sur les raccourcis clavier, consultez Raccourcis clavier dans SQL Server Management Studio.

Pour les commentaires multilignes, consultez Barre oblique étoile (bloc de commentaire) (Transact-SQL).

Exemples

L'exemple suivant utilise les caractères d'indication de commentaire --.

-- Choose the AdventureWorks2022 database.  
USE AdventureWorks2022;  
GO  
-- Choose all columns and all rows from the Address table.  
SELECT *  
FROM Person.Address  
ORDER BY PostalCode ASC; -- We do not have to specify ASC because   
-- that is the default.  
GO

Voir aussi

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