Komentarze serwera SQL

Instrukcje SQL są znaczące dla interakcji i pracy z bazami danych. Takie stwierdzenia mogą być pojedynczą linią kodu lub zapytań wieloletnich. Jeśli masz wiele stwierdzeń SQL, trudno jest znać zamierzony cel kodu.

Świetnym sposobem na utrzymanie i poprawę czytelności w stwierdzeniach SQL jest użycie komentarzy. Na przykład możesz dodać komentarze do dokumentu lub opisać klarowność scenariusza. Ponieważ SQL Server nie wykonuje komentarzy SQL, możemy je również użyć do dezaktywacji określonego bloku kodu, umożliwiając debugowanie i refaktoryzację kodu.

Ten samouczek dowie się, jak używać i dodawać komentarze do swoich zapytań SQL. Omówimy, jak korzystać z komentarzy jednoliniowych i wieloletkowych na serwerze SQL.

Podstawy

Istnieją dwa główne sposoby użycia do tworzenia komentarzy w swoich zapytaniach SQL. Pierwszy używa podwójnej deski rozdzielczej, a drugi używa cięcia do przodu i gwiazdka.

Dowiedzmy się, jak tworzyć komentarze za pomocą opisanych składni powyżej.

Komentarze jednokierunkowe

Aby utworzyć komentarz jednoliniowy w zapytaniach SQL Server, użyj symbolu -. Składnia jest jak pokazana:

-- Comment_text

Kiedy SQL Server napotyka linię, która zaczyna się od symbolu, zignoruje całą zawartość na końcu linii. Nowa postać linii działa jako wartość końcowa dla komentarza, zaczynając od - symboli.

Rozważ przykład pokazany poniżej:

-- Uzyskaj 5 wartości z tabeli klientów
Wybierz Top 5 * od klientów;

W powyższym przykładzie zapytaniu SQL używamy komentarza jednoliniowego, aby dodać opis działania wykonanego przez instrukcję SQL, która następuje.

Warto zauważyć, że nie ma maksymalnego limitu liczby znaków, które zawiera komentarz.

Korzystając z Microsoft SQL Server Management Studio, możesz dodać komentarz jednoliniowy za pomocą skrótu klawiatury Ctrl + K, Ctrl + C.

Możesz także użyć interfejsu graficznego, klikając ikonę pokazaną poniżej na głównym pasku narzędzi.

Po wybraniu i użyciu skrótów klawiatury lub ikonę komentarza SQL Server doda dwa łączniki i skomentuje linię Set.

Komentarze wieloletnie

Innym typem komentarza to komentarze wieloletnie lub blokowe. Są to rodzaj komentarzy, które obejmują więcej niż jeden wiersz, takie jak akapit.

Powiedzmy, że chcesz skomentować następujące wiersze:

-- Zdobądź imię klienta
-- Zdobądź nazwisko klienta
Wybierz 5 nazwy pierwszej nazwy, LastName od klientów;

Zauważysz, że musimy dodać dwa komentarze jednoliniowe. Ta metoda sprawia, że ​​kod jest nieczytelny i powtarzalny.

Możemy to naprawić, wkładając komentarz wieloletnie za pomocą składni pokazanej poniżej:

/* komentarz tutaj
kolejna linia
i kolejny
*/

SQL Server używa A / * do otwarcia komentarza wieloletniego i * / do zamykania bloku komentarza. SQL Server zignoruje każdy tekst określony w tych blokach.

Rozważ przykładowy kod pokazany poniżej:

Komentarze wieloletnie są bardzo przydatne, gdy masz komentarze, które rozszerzają wiele wierszy. Możesz również użyć ich do wyświetlania przydatnych informacji, takich jak autor, data i więcej.

/*
Autor: Linuxhint;
Kategoria: SQL Server;
Pub: 2022;
*/
Wybierz 5 nazwy pierwszej nazwy, LastName od klientów;

Podobnie komentarze blokowe mogą wyłączyć wiele zapytań SQL.

Wniosek

Ten przewodnik uczy, jak pracować z komentarzami SQL Server, aby dodawać informacje do skryptów SQL. Komentowanie kodu pomaga poprawić czytelność i utrzymanie kodu przez innych programistów. Uzyskaj zwyczaj komentowania swojego kodu.

Dziękuje za przeczytanie.