Lorsque vous écrivez des instructions SQL dans l'éditeur SQL et XQuery,
vous pouvez rapidement mettre en commentaire le code SQL à l'aide d'une commande du menu
contextuel. Vous pouvez utiliser la même commande pour annuler rapidement la mise en commentaire du code SQL.
Avant de commencer
Le script SQL doit être ouvert dans l'éditeur SQL et XQuery.
Pourquoi et quand exécuter cette tâche
Vous pouvez mettre en commentaire ou annuler la mise en commentaire d'une seule ligne de code
dans une instruction SQL, de plusieurs lignes de code juxtaposées, d'une instruction SQL
complète ou de plusieurs instructions SQL juxtaposées.
La syntaxe d'un commentaire
dans une ligne de code SQL est un double trait d'union (--)
au début de la ligne. Tout le code SQL de la ligne est mis en commentaire.
Remarque : Ce procédé ne tente pas de fusionner un nouveau commentaire avec un commentaire existant. Par exemple, si vous mettez la ligne 4 en commentaire dans une
instruction SQL, puis mettez toute l'instruction SQL en commentaire,
la ligne 4 possédera une double notation de commentaire (c'est-à-dire
deux double traits d'union dans les positions 1 à 4 de la ligne). Si vous annulez la mise en commentaire de l'instruction SQL, la ligne 4 sera toujours mise en commentaire.
Procédure
Pour mettre en commentaire ou annuler la mise en commentaire du code SQL dans l'éditeur SQL et XQuery :
- Sélectionnez le code SQL que vous souhaitez mettre en commentaire ou pour lequel vous souhaitez annuler la mise en commentaire.
- Pour une seule ligne, cliquez n'importe où dans la ligne de code.
- Pour plusieurs lignes, faites glisser le pointeur sur les lignes de
code.
- Cliquez avec le bouton droit de la souris sur le code SQL sélectionné, puis sélectionnez Toggle Comment (Basculer le commentaire).
Résultats
Les résultats de ce processus dépendent de l'état d'origine du code
SQL sélectionné :
- Pour une ligne de code simple :
- Si la ligne était active, elle est désormais un commentaire.
- Si la ligne était un commentaire, elle est désormais active.
- Pour plusieurs lignes de code :
- Toutes les lignes actives sont désormais des commentaires.
Remarque : toutes les lignes qui étaient mises en commentaire possèdent désormais une double notation de commentaire.
- Si toutes les lignes étaient mises en commentaire, toutes les lignes sont désormais actives.