Sdílet prostřednictvím

Přidání komentářů k příkazům SQL

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime

Komentáře jsou užitečné pro dokumentaci kódu SQL a pro dočasné zakázání kódu SQL.

Do kódu SQL můžete přidat komentáře před, za a v příkazech. Azure Databricks komentáře ignoruje, pokud se nerozpozná jako rady.

Podporují se následující formy komentářů:

Jednoduché komentáře

Jednoduché komentáře slouží k pokrytí celého řádku textu nebo zbytku řádku textu začínajícího na --

Syntaxe

-- text

Parametry

  • text: Jakýkoli text s výjimkou znaku konce řádku (EOL), například \n.

Příklady

> -- 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

Komentáře v hranatých závorkách

Komentáře v hranatých závorkách slouží k pokrytí více řádků textu nebo části řádku textu.

Syntaxe

bracketed_comment
  /* text [ bracketed_comment [...] ] text */

Parametry

  • text: Jakýkoli text včetně znaků konce řádku (EOL), s výjimkou /* a */.

Příklady

> /* 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 */