Esboço de Código

Você pode usar o recurso de estrutura de tópicos nos editores de consultas do SQL Server Management Studio para ocultar seletivamente o código ao editar consultas. Isso permite que você exiba com mais facilidade o código no qual está trabalhando, especialmente em arquivos de consulta grandes.

Visão geral do esboço

Por padrão, todo o código fica visível quando você abre uma janela do editor de consultas. Regiões do código podem ser recolhidas para ocultá-lo da visualização. Uma linha vertical na borda esquerda da janela do editor usa um quadrado com um sinal de menos (-) para identificar o início de cada região de código recolhível. Quando você clica em um sinal de menos, o texto da região de código é substituído por uma caixa que contém três períodos (...) e o sinal de subtração é alterado para um sinal de adição (+). Quando você clica em um sinal de adição, o código recolhido é exibido e o sinal de adição é alterado para um sinal de menos. Quando você move o ponteiro sobre uma caixa que tem três períodos, uma dica de ferramenta é exibida que mostra o código na seção recolhida.

Regiões de Delineamento do Sistema

Cada editor do SQL Server Management Studio gera um conjunto de regiões de esboço padrão definidas pelo sistema.

Os editores de código MDX e DMX criam regiões de estrutura para cada instrução multilinha. Esse é o único nível de estrutura de tópicos que esses editores suportam.

Regiões do Editor de Consultas XMLA do Analysis Services

O Editor de Consultas XMLA do Analysis Services gera uma região de esboço para cada atributo XML multilinha. O editor organiza as regiões de estrutura para marcas aninhadas. Por exemplo, o Editor XMLA cria três regiões de tópicos para o documento a seguir.

Quando você clica no sinal de menos na linha <InnerTag>, apenas o InnerTag é recolhido, conforme mostrado na ilustração a seguir.

Quando você move o ponteiro sobre a caixa que tem os três períodos (...), o código na região recolhida aparece em uma dica de ferramenta, conforme mostrado na ilustração a seguir.

Quando você clica no sinal de menos na <linha MiddleTag>, o MiddleTag e o InnerTag são recolhidos, como mostrado na ilustração a seguir.

Quando você clica no sinal de menos na <linha OuterTag>, todas as três linhas são recolhidas, como mostrado na ilustração a seguir.

Regiões do Editor de Consultas do Banco de Dados

O Editor de Consultas do Mecanismo de Banco de Dados gera regiões de estrutura de tópicos para cada elemento na seguinte hierarquia:

1. Lotes. O primeiro lote é o código desde o início do arquivo até o primeiro comando GO ou o final do arquivo quando não há comandos GO. Após o primeiro GO, há um lote associado a cada comando GO que vai até o próximo comando GO ou até o final do arquivo.

2. Blocos delimitados pelas seguintes palavras-chave:

   • INÍCIO – FIM

   • BEGIN TRY - END TRY

   • BEGIN CATCH - END CATCH

3. Instruções multilinha.

Por exemplo, o Editor de Consultas do Mecanismo de Banco de Dados cria três regiões de delineamento para a consulta a seguir.

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

Você pode clicar no sinal de menos na SELECT * linha para recolher apenas essa SELECT instrução. Para recolher todo o bloco BEGIN - END, clique no sinal de menos na linha BEGIN. Para recolher todo o lote até o comando GO, clique no sinal de menos na linha CREATE PROCEDURE. Você não pode colapsar as linhas SELECT GETDATE() ou SELECT @@VERSION individualmente porque são instruções de linha única e não possuem regiões de estrutura de tópicos.