Struttura del codice

si applica a:SQL Serverdatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)

È possibile usare la funzionalità struttura negli editor di query di SQL Server Management Studio per nascondere in modo selettivo il codice quando si modificano le query. In questo modo è possibile visualizzare più facilmente il codice su cui si sta lavorando, in particolare nei file di query di grandi dimensioni.

Sintesi della struttura

Per impostazione predefinita, tutto il codice è visibile quando si apre una finestra dell'editor di query. È possibile comprimere le aree del codice per nasconderlo dalla visualizzazione. Una linea verticale sul bordo sinistro della finestra dell'editor usa un quadrato con un segno meno (-) per identificare l'inizio di ogni area del codice collapsible. Quando si seleziona un segno meno, il testo dell'area del codice viene sostituito con una casella contenente tre punti (...) e il segno meno cambia in un segno più (+). Quando si seleziona un segno più, viene visualizzato il codice compresso e il segno più cambia in un segno meno. Quando si sposta il puntatore su una casella con tre punti, viene visualizzata una descrizione comando che visualizza il codice nella sezione compressa.

Abilitare o disabilitare la disposizione del codice

È possibile gestire questa impostazione passando a Strumenti>Opzioni, espandendo la sezione editor di testo e selezionando IntelliSense. Per disabilitare la struttura del codice, deselezionare la casella di controllo Struttura delle istruzioni. L'evidenziazione del codice è abilitata per impostazione predefinita.

Aree dello schema di sistema

Ogni editor di SQL Server Management Studio genera un set di regioni di struttura predefinite definite dal sistema.

Gli editor di codice MDX e DMX creano regioni di struttura per ogni istruzione multilinea. Questo è l'unico livello di struttura supportato da questi editor.

Sezioni dell'editor di query XMLA di Analysis Services

L'editor di query XMLA di Analysis Services genera una regione strutturale per ogni attributo XML multilinea. L'editor annida le aree della struttura per i tag annidati. Ad esempio, l'Editor XMLA crea tre sezioni strutturate per il documento seguente.

Quando si seleziona il segno meno sulla riga <InnerTag>, solo il InnerTag viene compresso, come illustrato nella figura seguente.

Quando si sposta il puntatore sulla casella con i tre punti (...), il codice nell'area compressa viene visualizzato nella descrizione comando, come illustrato nella figura seguente.

Quando si seleziona il segno meno sulla riga <MiddleTag>, sia il MiddleTag che il InnerTag vengono compressi, come illustrato nella figura seguente.

Quando si seleziona il segno meno sulla riga <OuterTag>, tutte e tre le righe vengono compresse, come illustrato nella figura seguente.

Aree dell'editor di query del motore di database

L'editor di query del motore di database genera aree struttura per ogni elemento nella gerarchia seguente:

1. Batch. Il primo batch è il codice dall'inizio del file al primo comando GO o alla fine del file quando non sono presenti comandi GO. Dopo il primo GO, è presente un batch da ogni comando GO al comando GO successivo o alla fine del file.

2. Blocchi delimitati dalle parole chiave seguenti:

   • BEGIN - END
   • BEGIN TRY - END TRY
   • BEGIN CATCH - END CATCH

3. Dichiarazioni su più righe.

Ad esempio, l'Editor delle Query del Motore di Database crea tre aree di struttura per la query seguente:

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

È possibile selezionare il segno meno nella riga SELECT * per comprimere solo l'istruzione SELECT. Per comprimere l'intero blocco BEGIN - END, selezionare il segno meno sulla riga BEGIN. Per comprimere l'intero batch al comando GO, selezionare il segno meno nella riga CREATE PROCEDURE. Non è possibile comprimere le righe SELECT GETDATE() o SELECT @@VERSION singolarmente perché sono istruzioni in una sola riga e non si ottengono regioni di struttura.