SQL Server -kommentarer

SQL -uttalelser er viktige for å samhandle og jobbe med databasene dine. Slike utsagn kan være en enkelt kodelinje eller spørsmål med flere linjer. Hvis du har mange SQL -setninger, kan det bli vanskelig å vite det tiltenkte formålet med koden.

En flott måte å bidra til å opprettholde og forbedre lesbarheten på SQL -uttalelsene dine er bruken av kommentarer. For eksempel kan du legge til kommentarer til dokumentet eller beskrive skriptets klarhet. Siden SQL -serveren ikke utfører SQL -kommentarer, kan vi også bruke dem til å deaktivere en spesifikk kodeblokk, slik at du kan feilsøke og refaktorere koden din.

Denne opplæringen vil lære å bruke og legge til kommentarer til SQL -spørsmålene dine. Vi vil diskutere hvordan du bruker en-linje og flerlinjekommentarer i SQL Server.

Det grunnleggende

Det er to hovedmåter du kan bruke til å lage kommentarer i SQL -spørsmålene dine. Den første bruker en dobbel strek, og den andre bruker en fremover skråstrek og en stjerne.

La oss lære å lage kommentarer ved hjelp av de beskrevne syntaksene ovenfor.

Enkeltlinje kommentarer

For å lage en enkeltlinjekommentar i SQL Server -spørsmål, bruk - Symbolet. Syntaksen er som vist:

-- KOMMENTAR_TEXT

Når SQL Server møter en linje som starter med - symbolet, vil den ignorere alt innholdet til slutten av linjen. Den nye linjekarakteren fungerer som sluttverdien for en kommentar som starter med - symboler.

Tenk på eksemplet som er vist nedenfor:

-- Få 5 verdier fra kundetabellen
Velg Topp 5 * fra kunder;

I eksemplet SQL-spørring ovenfor bruker vi en enkeltlinjekommentar for å legge til en beskrivelse av handlingen utført av SQL-setningen som følger.

Det er godt å merke seg at det ikke er noen maksimal grense for antall tegn en kommentar inneholder.

Ved hjelp av Microsoft SQL Server Management Studio kan du legge til en enkeltlinjekommentar ved hjelp av tastatursnarveien Ctrl + K, Ctrl + C.

Du kan også bruke det grafiske grensesnittet ved å klikke på ikonet som vises nedenfor i hovedverktøylinjen.

Når du har valgt og bruker tastatursnarveiene eller kommentarikonet, vil SQL -serveren legge til to bindestreker og kommentere setelinjen.

Kommentarer med flere linjer

Den andre typen kommentarer er flere linjer eller blokkerer kommentarer. Dette er den typen kommentarer som spenner over mer enn en enkelt linje, for eksempel et avsnitt.

La oss si at du ønsker å kommentere følgende linjer:

-- Få kundenavn
-- Få kunde etternavn
Velg Topp 5 FirstName, etternavn fra kunder;

Du legger merke til at vi må legge til to enkeltlinjekommentarer. Denne metoden gjør koden uleselig og repeterende.

Vi kan fikse dette ved å sette inn en flerlinjekommentar ved hjelp av syntaks vist nedenfor:

/* Kommentar her
en annen linje
og en til
*/

SQL Server bruker A / * for å åpne en multi-line kommentar og * / for å lukke kommentarblokken. SQL Server vil ignorere enhver tekst som er spesifisert i disse blokkene.

Tenk på eksempelkoden vist nedenfor:

Kommentarer med flere linjer er veldig nyttige når du har kommentarer som utvider flere linjer. Du kan også bruke dem til å vise nyttig informasjon som forfatter, dato og mer.

/*
Forfatter: Linuxhint;
Kategori: SQL Server;
Pub: 2022;
*/
Velg Topp 5 FirstName, etternavn fra kunder;

Tilsvarende kan blokkere kommentarer deaktivere flere SQL -spørsmål.

Konklusjon

Denne guiden lærer deg hvordan du jobber med SQL Server -kommentarer for å legge til informasjon i SQL -skriptene dine. Å kommentere kode hjelper til med å forbedre lesbarheten og vedlikeholdet av koden av andre utviklere. Få for vane å kommentere koden din.

Takk for at du leste.