Delen via

Opmerkingen toevoegen aan SQL-instructies

  • Artikel

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Opmerkingen zijn handig voor het documenteren van SQL-code en voor het tijdelijk uitschakelen van SQL-code.

U kunt opmerkingen toevoegen aan SQL-code vóór, na en binnen instructies. Opmerkingen worden genegeerd door Azure Databricks, tenzij ze worden herkend als hints.

De volgende vormen van opmerkingen worden ondersteund:

Eenvoudige opmerkingen

Eenvoudige opmerkingen worden gebruikt om een hele regel tekst of de rest van een regel tekst te behandelen die begint met --

Syntaxis

-- text

Parameters

  • text: alle tekst met uitzondering van een EOL-teken (end-of-line), zoals \n.

Voorbeelden

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

Opmerkingen tussen haakjes

Opmerkingen tussen haakjes worden gebruikt om meerdere regels tekst of een deel van een tekstregel te behandelen.

Syntaxis

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

Parameters

  • text: alle tekst, inclusief EOL-tekens (end-of-line), exclusief /* en */.

Voorbeelden

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