Udostępnij za pośrednictwem

Dodawanie komentarzy do instrukcji SQL

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Komentarze są przydatne do dokumentowania kodu SQL i tymczasowego wyłączania kodu SQL.

Komentarze można dodawać do kodu SQL przed instrukcjami i w ramach instrukcji. Komentarze są ignorowane przez usługę Azure Databricks, chyba że są rozpoznawane jako wskazówki.

Obsługiwane są następujące formy komentarzy:

Proste komentarze

Proste komentarze są używane do pokrycia całego wiersza tekstu lub pozostałej części wiersza tekstu rozpoczynającego się od --

Składnia

-- text

Parametry

  • text: Dowolny tekst z wyłączeniem znaku końca wiersza (EOL), takiego jak \n.

Przykłady

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

Komentarze w nawiasach

Komentarze w nawiasach są używane do pokrycia wielu wierszy tekstu lub części wiersza tekstu.

Składnia

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

Parametry

  • text: dowolny tekst, w tym znaki końca wiersza (EOL), z wyłączeniem /* i */.

Przykłady

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