Структурирование кода

применимо:SQL ServerБаза данных Azure SQLУправляемый экземпляр Azure SQLAzure Synapse AnalyticsAnalytics Platform System (PDW)

Вы можете использовать функцию структурирования в редакторах запросов SQL Server Management Studio для выборочного скрытия кода при редактировании запросов. Это позволяет более легко просматривать код, над которым вы работаете, особенно в больших файлах запросов.

Обзор схемы

По умолчанию при открытии окна редактора запросов отображается весь код. Области кода можно свернуть, чтобы скрыть его от представления. Вертикальная линия в левом краю окна редактора использует квадрат со знаком минус (-) для идентификации начала каждого свертываемого региона кода. При выборе знака минус текст области кода заменяется полем, содержащим три периода (...), а знак минуса изменяется на знак плюса (+). При выборе знака плюса отображается свернутый код, а знак плюса изменяется на знак минуса. При перемещении указателя на поле с тремя периодами появится подсказка, показывающая код в свернутом разделе.

Включение или отключение структурирования кода

Вы можете управлять этим параметром, перейдя к разделу"Инструменты>", расширив раздел текстового редактора и выбрав IntelliSense. Чтобы отключить структурирование кода, снимите флажок Контур кода. Настройка кода включена по умолчанию.

Области контура системы

Каждый редактор SQL Server Management Studio создает набор областей структуры по умолчанию, определенных системой.

Редакторы кода MDX и DMX создают контурные области для каждого многострочного выражения. Это единственный уровень структурирования, который поддерживают эти редакторы.

Регионы редактора запросов XMLA в службах Analysis Services

Редактор запросов XMLA служб Analysis Services создает область структуры для каждого многострочного XML-атрибута. Редактор группирует области структуры для вложенных тегов. Например, редактор XMLA создает три области структуры для следующего документа.

Если вы выберете знак минуса на линии <InnerTag>, будет свернута только InnerTag, как показано на следующем рисунке.

При перемещении указателя на поле с тремя периодами (...), код в свернутом регионе отображается в подсказке, как показано на следующем рисунке.

При выборе знака минуса в строке <MiddleTag>, оба элемента MiddleTag и InnerTag сворачиваются, как показано на следующем рисунке.

При нажатии на знак минус в строке <OuterTag> все три строки сворачиваются, как это показано на следующем рисунке.

Регионы редактора запросов ядра СУБД

Редактор запросов СУБД генерирует контурные области для каждого элемента в следующей иерархии:

1. Пакетов. Первый пакет — это код от начала файла до команды GO или до конца файла, если команд GO нет. После первого GOвыполняется один пакет из каждой команды GO до следующей команды GO или до конца файла.

2. Блоки, разделенные следующими ключевыми словами:

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

3. Многостроковые выражения.

Например, редактор запросов ядра СУБД создает три региона структуры для следующего запроса:

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

Вы можете выбрать знак минуса в строке SELECT *, чтобы свернуть только этот оператор SELECT. Чтобы свернуть весь блок BEGIN - END, нажмите на знак минуса в строке BEGIN. Чтобы скрыть весь пакет команд до команды GO, нажмите на знак минус в строке CREATE PROCEDURE. Вы не можете свернуть SELECT GETDATE() строки или SELECT @@VERSION строки по отдельности, так как они — однострочные операторы и не получают выстраивание регионов.