Esquisse du code

2025-02-21

s’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Vous pouvez utiliser la fonctionnalité de plan dans les éditeurs de requête SQL Server Management Studio pour masquer de manière sélective le code lorsque vous modifiez des requêtes. Cela vous permet d’afficher plus facilement le code sur lequel vous travaillez, en particulier dans les fichiers de requête volumineux.

Aperçu général

Par défaut, tout le code est visible lorsque vous ouvrez une fenêtre d’éditeur de requête. Les régions du code peuvent être réduites pour la masquer de l’affichage. Une ligne verticale sur le bord gauche de la fenêtre de l'éditeur utilise un carré avec un signe moins (-) pour identifier le début de chaque zone de code repliable. Lorsque vous sélectionnez un signe moins, le texte de la zone de code est remplacé par une zone contenant trois points (...), et le signe moins passe à un signe plus (+). Lorsque vous sélectionnez un signe plus, le code réduit s’affiche et le signe plus passe à un signe moins. Lorsque vous déplacez le pointeur sur une zone comportant trois périodes, une info-bulle s’affiche qui affiche le code dans la section réduite.

Activer ou désactiver le plan du code

Vous pouvez gérer ce paramètre en accédant à Outils>Options, en développant la section éditeur de texte et en sélectionnant IntelliSense. Pour désactiver la structuration du code, décochez la case instructions de structuration. Le repli du code est activé par défaut.

Régions d'aperçu du système

Chaque éditeur de SQL Server Management Studio génère un ensemble de régions hiérarchiques systématiquement définies par défaut.

Les éditeurs de code MDX et DMX créent des régions de contour pour chaque déclaration multiligne. Il s'agit du seul niveau de structuration pris en charge par ces éditeurs.

Régions de l’éditeur de requête XMLA Analysis Services

L'Éditeur de requête XMLA de Analysis Services génère une zone structurée pour chaque attribut XML multiligne. L’éditeur imbrique les zones hiérarchiques pour les balises imbriquées. Par exemple, l’éditeur XMLA crée trois régions de plan pour le document suivant.

Capture d’écran du code XML montrant le plan.

Lorsque vous sélectionnez le signe moins sur la ligne de <InnerTag>, seule la InnerTag est réduite, comme indiqué dans l'illustration suivante.

Capture d’écran du code XML avec nœud interne masqué.

Lorsque vous déplacez le pointeur sur la zone contenant les trois points (...), le code de la région réduite apparaît dans une info-bulle, comme illustré dans l’illustration suivante.

Capture d’écran du code XML avec info-bulle montrant le code masqué.

Lorsque vous sélectionnez le signe moins sur la ligne <MiddleTag>, les MiddleTag et les InnerTag sont réduits, comme illustré dans l’illustration suivante.

Capture d’écran du code XML avec des balises internes et intermédiaires masquées.

Lorsque vous sélectionnez le signe moins sur la ligne <OuterTag>, les trois lignes sont réduites, comme illustré dans l’illustration suivante.

Capture d’écran du code XML montrant les trois balises masquées.

Régions de l’éditeur de requête du moteur de base de données

L’Éditeur de requête du moteur de base de données génère des régions hiérarchiques pour chaque élément de la hiérarchie suivante :

Lots. Le premier lot est le code du début du fichier vers la première commande GO ou la fin du fichier lorsqu’il n’y a pas de commandes GO. Après la première GO, il y a un lot de la commande GO à la commande GO suivante ou jusqu'à la fin du fichier.
Blocs délimités par les mots clés suivants :
- BEGIN - END
- BEGIN TRY - END TRY
- BEGIN CATCH - END CATCH
Déclarations multilignes.

Par exemple, l'Éditeur de requête du moteur de base de données crée trois sections pour la requête suivante :

CREATE PROCEDURE Sales.SampleProc --Outline region 1
AS
BEGIN --Outline region 2
    SELECT GETDATE() AS TimeOfQuery;

    SELECT * --Outline region 3
    FROM sys.transmission_queue;

    SELECT @@VERSION;
END;
GO

Vous pouvez sélectionner le signe moins sur la ligne SELECT * pour réduire uniquement cette instruction SELECT. Pour replier l'ensemble du bloc BEGIN - END, sélectionnez le signe moins sur la ligne BEGIN. Pour réduire tout le lot à la commande GO, sélectionnez le signe moins sur la ligne CREATE PROCEDURE. Vous ne pouvez pas plier les lignes SELECT GETDATE() ou SELECT @@VERSION individuellement, car elles sont des instructions d'une seule ligne et ne génèrent pas de régions de délimitation.

Partager via