Freigeben über


Hinzufügen von Kommentaren zu SQL-Anweisungen

Gilt für: durch Häkchen mit „Ja“ markiert Databricks SQL Häkchen gesetzt ja 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 */