Zadanie 7. Dodawanie komentarzy.

Przy tym zadaniu pokażę Wam jak dodać komentarz w zapytaniu. Ogólnie komentarze mają dwa zadania. Pierwsze, w danym miejscu mamy możliwość napisać parę słów wyjaśnienia do kodu zapytania, żeby wracając do tego zapytania za jakiś czas pamiętać o co nam chodziło. Drugie, żeby „wyłączyć” w danym momencie odpowiednią część zapytania (np. do przetestowania działania danego wariantu) bez potrzeby kasowania kodu.

Możemy dodać dwa rodzaje komentarzy:

  • jednowierszowy, znak „– – treść komentarza”. W tym wariancie wszystko w danym wierszu po dwóch myślnikach zostanie potraktowane jako komentarz aż do końca wiersza i nie będzie brane pod uwagę w momencie uruchomienia zapytania,
  • wielowierszowy, znak „ /* treść komentarza */”. W tym wariancie wszystko co znajdzie się pomiędzy dwoma ukośnikami i gwiazdkami zostanie potraktowane jako komentarz i jak w poprzednim wariancie nie będzie brane pod uwagę w momencie uruchomienia zapytania.

Przykład zastosowania obu wariantów komentarzy w poniższym kodzie. Do zaprezentowania działania komentarzy wykorzystamy zapytanie, które stworzyliśmy w zadaniu nr 6.

kurs sql dodawanie komentarzy komentarze

Omówmy trochę to nasze zapytanie. W liniach od 1 do 6 znajduje się komentarz wielowierszowy. Ja już wspominałem wszystko co znajdzie się pomiędzy znakami /* treść komentarza*/  zostanie potraktowane jako komentarz.

W linii 8 został zaprezentowany komentarz jednowierszowy. Tutaj możemy np. wpisać informację czego dotyczy dana część kodu. Oczywiście komentarz jednowierszowy i wielowierszowy może wykorzystać do opisu jednej linii kodu bez wyłączania tej linijki, co pokazuje linia 10 i 11.

Komentarze przydają się także do tego żeby w danej chwili np. w celach testowych wyłączyć jakąś część kodu, ale nie kasować tej części, co obrazuje linia 12. Zwróćcie uwagę, że „wyłączyliśmy” kolumnę [Wynagrodzenie całkowite] i nie pokazuje się ona w wynikach zapytania, ale nie musieliśmy kasować kodu w zapytani. To bardzo przydatna funkcjonalność.

W Management Studio możemy dodawać i usuwać komentarze klikając w odpowiednie ikony. Możemy w taki sposób zaznaczać wiele linii kodu naraz. Wykorzystujemy do tego dwie ikony z paska.

kurs sql dodawanie komentarzy komentarze

Przed kliknięciem w ikonę, w celu dodania komentarza, zaznaczamy kursorem w zapytaniu wiersze które chcemy zakomentować. Pamiętaj, te wiersze staną się wtedy niewidowczne podczas uruchamiania zapytania.

I na odwrót jeśli chcemy „odkomentować” jakieś wiersze które są aktualne „zakomentowane” należy je zaznaczyć i kliknąć w ikonę do usunięcia komentarza.

UWAGA: taki typ dodawania i usuwania komentarzy tyczy się tylko komentarzy jednowierszowych, czyli znak „– – ”. Możemy takim sposobem zaznaczyć więcej wierszy, wtedy przed każdym wierszem zobaczymy znak „– – ”, co obrazuje poniższy zrzut.

kurs sql dodawanie komentarzy komentarze

Jak widzisz w szybki i łatwy sposób możemy dodawać i usuwać komentarze w różnych celach.

poprzedni | następny