Komentarze Oracle PL/SQL

W bazach danych komentarze odnoszą się do tekstu, który nie jest wykonywany jako część polecenia lub zapytania. Komentarze bazy danych są głównie używane do dodawania notatek objaśniających, dokumentacji lub innych meta informacji do bazy danych i mogą pomóc wyjaśnić cel i intencję kodu.

Komentarze znajdziesz także w różnych kontekstach bazy danych, takich jak procedury przechowywane, funkcje, wyzwalacze i widoki. Mogą podać wyjaśnienia kodu, zmian dokumentów lub modyfikacji lub zostawić notatki dla innych programistów, którzy pracują nad tym samym bazą kodeksu.

W tym samouczku dowiesz się, jak używać i pracować z różnymi rodzajami komentarzy w języku PL/SQL.

Komentarze z pojedynczym wierszem

Pierwszym rodzajem komentarza w bazach danych Oracle to komentarze jednoliniowe. Komentarze jednokierunkowe to komentarze, które obejmują jedną linię.

W PL/SQL komentarz jednokierunkowy zaczyna się od dwóch łączników (-) i rozciąga się na koniec linii. Silnik bazy danych ignoruje dowolny tekst lub znaki, które pojawiają się po łącznikach po wykonaniu kodu.

Poniżej pokazuje przykład jednego komentarza w Oracle:

ZACZYNAĆ
-- To jest komentarz jednoliniowy
OGŁOSIĆ
Nazwa varchar2 (30);
ZACZYNAĆ
nazwa: = „Peter”;
KONIEC;
KONIEC;

W takim przypadku tekst po komentarzu jest traktowany jako komentarz i ignorowany podczas wykonywania poleceń.

Oprócz dodawania metain.

Przykład jest następujący:

-- Wstaw do produktów (nazwa_produktu, ilość, cena) wartości („Microsoft Volterra”, 0, 599);

Chociaż poprzednia instrukcja jest prawidłowym poleceniem PL/SQL, silnik bazy danych nie wykonuje go, ponieważ jest traktowany jako komentarz.

Oracle Mult-Line Comment

Drugi typ komentarzy w bazach danych Oracle to komentarze wieloletnie. Są to rodzaj komentarzy, które mogą obejmować wiele wierszy.

Komentarz wieloletni w Oracle zaczyna się od cięcia do przodu i gwiazdka (/*). Komentarz może następnie obejmować jak najwięcej wierszy. Aby zakończyć komentarz wieloletnie, zacznij od gwiazdki i ukośnego cięcia (*/).

Przykład:

ZACZYNAĆ
/*
To jest komentarz wieloletni.
Może obejmować wiele linii i może być używany do podania bardziej szczegółowych wyjaśnień lub dokumentacji.
*/
OGŁOSIĆ
Nazwa varchar2 (30);
ZACZYNAĆ
Nazwa: = Peter ';
KONIEC;
KONIEC;

Możemy również użyć komentarza wieloletniego jako komentarza jednoliniowego:

Wybierz * od pracowników; / * To jest wieloletni komentarz, który obejmuje pojedynczy wiersz */

Tam nauczyłeś się pracować z komentarzami jednoliniowymi i wieloma w PL/SQL.

Warto zauważyć, że Oracle nie obsługuje zagnieżdżonych komentarzy wieloletnich. Na przykład następujący kod jest nieprawidłowy:

ZACZYNAĆ
/* To jest komentarz wieloletni
/ * To jest zagnieżdżony komentarz wieloletni */
*/
OGŁOSIĆ
Nazwa varchar2 (30);
ZACZYNAĆ
nazwa: = „Peter”;
KONIEC;
KONIEC;

Poprzednie zapytanie nie powiada się, ponieważ zagnieżdżone komentarze wieloletnie nie są obsługiwane.

Jeśli chcesz dodać zagnieżdżony komentarz, możesz połączyć komentarze wieloletnie i jednokierunkowe, jak pokazano następująco:

ZACZYNAĆ
/* To jest komentarz wieloletni
-- To jest komentarz jednoliniowy w komentarzu wieloletnim
*/
OGŁOSIĆ
Nazwa varchar2 (30);
ZACZYNAĆ
nazwa: = „Peter”;
KONIEC;
KONIEC;

Wniosek

W tym samouczku nauczyłeś się używać różnych rodzajów komentarzy w PL/SQL, aby dodać dokumentację do kodu.