Oracle PL/SQL kommentarer

I databaser refererer kommentarer til teksten som ikke blir utført som en del av en kommando eller spørring. Databasekommentarer brukes hovedsakelig til å legge til forklarende notater, dokumentasjon eller annen metainformasjon i en database og kan bidra til å avklare kodens formål og intensjon.

Du vil også finne kommentarene i forskjellige databasekontekster som lagrede prosedyrer, funksjoner, triggere og visninger. De kan gi forklaringene på kode, dokumentendringer eller modifikasjoner, eller legge igjen notater for de andre utviklerne som jobber med samme kodebase.

I denne opplæringen lærer du hvordan du bruker og jobber med de forskjellige kommentarene på PL/SQL -språk.

Enkeltlinje kommentarer

Den første typen kommentarer i Oracle-databaser er en-linje kommentarer. Enkeltlinje kommentarer er kommentarer som spenner over en enkelt linje.

I PL/SQL starter en enkeltlinjekommentar med to bindestreker (-) og spenner til slutten av linjen. Databasemotoren ignorerer all tekst eller tegn som kommer etter bindestrekene når koden blir utført.

Følgende viser eksemplet på en enkelt linjekommentar i Oracle:

BEGYNNE
-- Dette er en enkeltlinje kommentar
ERKLÆRE
Navn varchar2 (30);
BEGYNNE
Navn: = 'Peter';
SLUTT;
SLUTT;

I dette tilfellet blir teksten etter kommentaren behandlet som en kommentar og ignorert under utførelse av kommandoen.

Bortsett fra å legge til metainformasjonen til en gitt kodeblokk, hjelper enkeltlinjekommentarer til å deaktivere et stykke kode.

Et eksempel er som følger:

-- Sett inn i produkter (produktnavn, mengde, pris) verdier ('Microsoft Volterra', 0, 599);

Selv om den forrige uttalelsen er en gyldig PL/SQL -kommando, utfører ikke databasemotoren den slik den blir behandlet som en kommentar.

Oracle Mult-Line kommentar

Den andre typen kommentarer i Oracle-databaser er multi-line kommentarer. Dette er den typen kommentarer som kan spenne over flere linjer.

En flerlinjekommentar i Oracle starter med en fremover skråstrek og en stjerne (/*). Kommentaren kan deretter spenne over så mange linjer som mulig. For å avslutte en multi-linjekommentar, kan du starte med en stjerne og en fremover skråstrek (*/).

Eksempel:

BEGYNNE
/*
Dette er en multi-linjerkommentar.
Den kan spenne over flere linjer og kan brukes til å gi mer detaljerte forklaringer eller dokumentasjon.
*/
ERKLÆRE
Navn varchar2 (30);
BEGYNNE
Navn: = Peter ';
SLUTT;
SLUTT;

Vi kan også bruke en kommentar med flere linjer som en enkeltlinjekommentar:

Velg * fra ansatte; / * Dette er en flerlinjekommentar som spenner over en enkelt linje */

Der lærte du hvordan du jobber med enkeltlinje- og flerlinjekommentarer i PL/SQL.

Det er godt å merke seg at Oracle ikke støtter de nestede kommentarene til flere linjer. For eksempel er følgende kode ugyldig:

BEGYNNE
/* Dette er en multi-linjekommentar
/ * Dette er en nestet flerlinjekommentar */
*/
ERKLÆRE
Navn varchar2 (30);
BEGYNNE
Navn: = 'Peter';
SLUTT;
SLUTT;

Den forrige spørringen mislykkes siden de nestede kommentarene med flere linjer ikke støttes.

Hvis du ønsker å legge til en nestet kommentar, kan du kombinere kommentarer med flere linjer og enkeltlinjer som vist på følgende:

BEGYNNE
/* Dette er en multi-linjekommentar
-- Dette er en enkeltlinjekommentar innen multi-line kommentar
*/
ERKLÆRE
Navn varchar2 (30);
BEGYNNE
Navn: = 'Peter';
SLUTT;
SLUTT;

Konklusjon

I denne opplæringen lærte du hvordan du bruker de forskjellige kommentarene i PL/SQL for å legge til en dokumentasjon i koden din.