Megosztás a következőn keresztül:

Megjegyzések hozzáadása SQL-utasításokhoz

  • Cikk

A következőkre vonatkozik:check marked yes Databricks SQL check marked yes Databricks Runtime

A megjegyzések hasznosak az SQL-kód dokumentálására és az SQL-kód ideiglenes letiltására.

Megjegyzéseket fűzhet az SQL-kódhoz utasítások előtt, után és belül. Az Azure Databricks csak akkor hagyja figyelmen kívül a megjegyzéseket, ha nem ismeri fel őket tippekként.

A megjegyzések alábbi formái támogatottak:

Egyszerű megjegyzések

Az egyszerű megjegyzések egy teljes szövegsort vagy egy szövegsor fennmaradó részét fedik le a következővel kezdődően: --

Szintaxis

-- text

Paraméterek

  • text: Minden szöveg, amely nem tartalmazza a sorvégi (EOL) karaktert, például \n.

Példák

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

Szögletes megjegyzések

A szögletes megjegyzések több sornyi szöveget vagy szövegsor egy részét fedik le.

Szintaxis

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

Paraméterek

  • text: Minden szöveg, beleértve a sorvégi (EOL) karaktereket, kivéve /* és */.

Példák

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