Hinzufügen von Kommentaren zu SQL-Anweisungen
Gilt für:
Databricks SQL Databricks Runtime
Kommentare sind nützlich zum Dokumentieren von SQL-Code und zum vorübergehenden Deaktivieren von SQL-Code.
Sie können dem SQL-Code Kommentare vor, nach und innerhalb von Anweisungen hinzufügen. Kommentare werden von Azure Databricks ignoriert, es sei denn, sie werden als Hinweise erkannt.
Die folgenden Arten von Kommentaren werden unterstützt:
Einfache Kommentare
Einfache Kommentare werden verwendet, um eine gesamte Textzeile oder den Rest einer Textzeile abzudecken, beginnend mit --
Syntax
-- text
Parameter
text: Beliebiger Text, ausgenommen Zeilenendezeichen (End-of-Line, EOL), z. B.\n.
Beispiele
> -- 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
Kommentare in Klammern
Kommentare in Klammern werden verwendet, um mehrere Textzeilen oder einen Teil einer Textzeile abzudecken.
Syntax
bracketed_comment
/* text [ bracketed_comment [...] ] text */
Parameter
text: Beliebiger Text, einschließlich Zeilenendezeichen (End-of-Line, EOL), ausgenommen/*und*/.
Beispiele
> /* 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 */