Opmerkingen toevoegen aan SQL-instructies
Van toepassing op:
Databricks SQL Databricks Runtime
Opmerkingen zijn handig voor het documenteren van SQL-code en voor het tijdelijk uitschakelen van SQL-code.
U kunt opmerkingen toevoegen aan SQL-code vóór, na en binnen instructies. Opmerkingen worden genegeerd door Azure Databricks, tenzij ze worden herkend als hints.
De volgende vormen van opmerkingen worden ondersteund:
Eenvoudige opmerkingen
Eenvoudige opmerkingen worden gebruikt om een hele regel tekst of de rest van een regel tekst te behandelen die begint met --
Syntaxis
-- text
Parameters
text: alle tekst met uitzondering van een EOL-teken (end-of-line), zoals\n.
Voorbeelden
> -- This is a comment
> SELECT 1; -- This is also a comment
1
> SELECT -- This is a comment
1;
1
> SELECT -- Comments are not limited to Latin characters: 评论 😊
1;
1
> SELECT '-- This is not a comment';
-- This is not a comment
> SELECT -- This is a bad comment because the "one" should be on the next line... 1
Syntax error
> SELECT -- this is a bad
comment because it contains an EOL character
1;
Syntax error
Opmerkingen tussen haakjes
Opmerkingen tussen haakjes worden gebruikt om meerdere regels tekst of een deel van een tekstregel te behandelen.
Syntaxis
bracketed_comment
/* text [ bracketed_comment [...] ] text */
Parameters
text: alle tekst, inclusief EOL-tekens (end-of-line), exclusief/*en*/.
Voorbeelden
> /* This is a comment */
> SELECT 1; /* This is also a comment */
> SELECT /* This is a comment
that spans multiple lines */ 1;
> SELECT /* Comments are not limited to Latin characters: 评论 😊 */ 1;
> SELECT /* Comments /* can be */ nested */ 1;
> SELECT /* Quotes in '/*' comments "/*" are not special */ */ */ 1;
> /* A prefixed comment */ SELECT 1;
> SELECT '/* This is not a comment */';
/* This is not a comment */