Esquematización de código

se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Puede usar la característica de esquematización en los editores de consultas de SQL Server Management Studio para ocultar de forma selectiva el código al editar las consultas. Esto le permite ver más fácilmente el código en el que trabaja, especialmente en archivos de consulta grandes.

Introducción a la esquematización

De forma predeterminada, todo el código es visible cuando se abre una ventana del editor de consultas. Las regiones del código se pueden contraer para ocultarlas de la vista. Una línea vertical en el borde izquierdo de la ventana del editor usa un cuadrado con un signo menos (-) para identificar el inicio de cada región de código contraíble. Al seleccionar un signo menos, el texto de la región de código se reemplaza por un cuadro que contiene tres puntos (...) y el signo menos cambia a un signo más (+). Al seleccionar un signo más, aparece el código contraído y el signo más cambia a un signo menos. Al mover el puntero sobre una caja que tiene tres puntos suspensivos, aparece un tooltip que muestra el código de la sección contraída.

Habilitar o deshabilitar la esquematización de código

Para administrar esta configuración, vaya a Herramientas>Opciones, expanda la sección Editor de texto y seleccione IntelliSense. Para deshabilitar la esquematización de código, desactive la casilla Outline. La esquematización de código está habilitada de forma predeterminada.

Áreas del esquema del sistema

Cada editor de SQL Server Management Studio genera un conjunto de regiones de esquema predeterminadas definidas por el sistema.

Los editores de código MDX y DMX crean regiones de esquema para cada instrucción de varias líneas. Este es el único nivel de esquematización que admiten estos editores.

Regiones del editor de consultas XMLA de Analysis Services

El Editor de consultas XMLA de Analysis Services genera una región de esquema para cada atributo XML de varias líneas. El editor anida las regiones de esquema de etiquetas anidadas. Por ejemplo, el Editor XMLA crea tres regiones de esquema para el siguiente documento.

Al seleccionar el signo menos en la línea <InnerTag>, solo se contrae el InnerTag, como se muestra en la ilustración siguiente.

Al mover el puntero sobre el cuadro que tiene los tres puntos (...), el código de la región contraída aparece en una ventana emergente, como se muestra en la ilustración siguiente.

Al seleccionar el signo menos en la línea <MiddleTag>, se contraen los MiddleTag y InnerTag, como se muestra en la ilustración siguiente.

Al seleccionar el signo menos en la línea <OuterTag>, las tres líneas se contraen, como se muestra en la ilustración siguiente.

Regiones del editor de consultas del motor de base de datos

El Editor de consultas del motor de base de datos genera regiones de esquema para cada elemento de la jerarquía siguiente:

1. Lotes. El primer lote es el código desde el inicio del archivo hasta el primer comando GO o el final del archivo cuando no hay comandos GO. Después del primer GO, hay un lote de cada comando GO hacia el siguiente comando GO o hasta el final del archivo.

2. Bloques delimitados por las siguientes palabras clave:

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

3. Sentencias de varias líneas.

Por ejemplo, el Editor de consultas del motor de base de datos crea tres regiones de esquema para la consulta siguiente:

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

Puede seleccionar el signo menos en la línea SELECT * para contraer solo esa instrucción SELECT. Para contraer el bloque BEGIN - END por completo, seleccione el signo menos en la línea BEGIN. Para contraer el lote completo al comando GO, seleccione el signo menos en la línea CREATE PROCEDURE. No se pueden contraer las líneas de SELECT GETDATE() o SELECT @@VERSION individualmente porque son instrucciones de una sola línea y no se obtienen regiones de esquematización.