Strukturyzacja kodu

Dotyczy: SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Możesz użyć funkcji konspektowania w edytorach zapytań programu SQL Server Management Studio, aby selektywnie ukryć kod podczas edytowania zapytań. Dzięki temu można łatwiej wyświetlić kod, nad którym pracujesz, zwłaszcza w dużych plikach zapytań.

Przegląd konspektowania

Domyślnie cały kod jest widoczny po otwarciu okna edytora zapytań. Regiony kodu można zwinąć, aby ukryć go przed widokiem. Pionowa linia po lewej stronie okna edytora używa kwadratu ze znakiem minus (-), aby zidentyfikować początek każdego zwijanego regionu kodu. Po wybraniu znaku minus tekst regionu kodu jest zastępowany polem zawierającym trzy kropki (...), a znak minus zmienia się na znak plus (+). Po wybraniu znaku plus zostanie wyświetlony zwinięty kod, a znak plus zmieni się na znak minus. Po najechaniu wskaźnikiem na pole zawierające trzy kropki, pojawi się podpowiedź pokazująca kod w zwiniętej sekcji.

Włączanie lub wyłączanie konspektowania kodu

To ustawienie można zarządzać, przechodząc do Tools>Options, rozwijając sekcję Text Editor i wybierając pozycję IntelliSense. Aby wyłączyć tworzenie konspektu kodu, wyczyść pole wyboru Instrukcje konspektu. Konspektowanie kodu jest domyślnie włączone.

Regiony konspektu systemu

Każdy edytor programu SQL Server Management Studio generuje zestaw domyślnych regionów konspektu zdefiniowanych przez system.

Edytory kodu MDX i DMX tworzą regiony konspektu dla każdej instrukcji wielowierszowej. To jest jedyny poziom zarysu, który te edytory obsługują.

Regiony edytora zapytań XMLA usług Analysis Services

Edytor zapytań XMLA dla usług Analysis Services generuje region konspektu dla każdego wielowierszowego atrybutu XML. Edytor zagnieżdża regiony odniesień dla zagnieżdżonych tagów. Na przykład edytor XMLA tworzy trzy regiony konspektu dla następującego dokumentu.

Przy zaznaczeniu znaku minus w wierszu <InnerTag>, tylko InnerTag jest zwinięty, zgodnie z poniższą ilustracją.

Po przeniesieniu wskaźnika do pola zawierającego trzy kropki (...) kod w zwiniętym regionie zostanie wyświetlony w etykietce narzędzia, jak pokazano na poniższej ilustracji.

Po wybraniu symbolu minus w wierszu <MiddleTag>, zarówno MiddleTag, jak i InnerTag zostają zwinięte, jak to pokazano na ilustracji poniżej.

Po wybraniu znaku minus w wierszu <OuterTag> wszystkie trzy wiersze są zwinięte, jak pokazano na poniższej ilustracji.

Regiony edytora zapytań aparatu bazy danych

Edytor zapytań aparatu bazodanowego generuje regiony konspektu dla każdego elementu w następującej hierarchii:

1. Partii. Pierwsza partia to kod od początku pliku do pierwszego polecenia GO lub końca pliku, gdy nie ma GO poleceń. Po pierwszym GOjest jedna partia z każdego polecenia GO do następnego polecenia GO lub do końca pliku.

2. Bloki rozdzielane następującymi słowami kluczowymi:

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

3. Instrukcje wielowierszowe.

Na przykład Edytor zapytań silnika bazy danych tworzy trzy regiony konspektu dla następującego zapytania.

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

Możesz wybrać znak minus w wierszu SELECT *, aby zwinąć tylko instrukcję SELECT. Aby zwinąć cały blok BEGIN - END, kliknij znak minus w wierszu BEGIN. Aby zwinąć całą partię do polecenia GO, wybierz znak minus w wierszu CREATE PROCEDURE. Nie można zwinąć poszczególnych wierszy SELECT GETDATE() lub SELECT @@VERSION, ponieważ są to instrukcje pojedynczego wiersza i nie tworzą regionów konturowych.