Ajout de commentaires à des instructions SQL

  • Article

S’applique à : case marquée oui Databricks SQL case marquée oui Databricks Runtime

Les commentaires sont utiles pour documenter le code SQL et pour désactiver temporairement du code SQL.

Vous pouvez ajouter des commentaires au code SQL au début, à la fin ou dans les instructions. Les commentaires sont ignorés par Azure Databricks, sauf s’ils sont reconnus comme étant des indicateurs.

Les formes de commentaires suivantes sont prises en charge :

Commentaires simples

Les commentaires simples sont utilisés pour couvrir une ligne de texte entière ou le reste d’une ligne de texte commençant par --

Syntaxe

-- text

Paramètres

  • text : n’importe quel texte, sauf un caractère de fin de ligne (EOL), comme \n.

Exemples

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

Commentaires entre crochets

Les commentaires entre crochets sont utilisés pour couvrir plusieurs lignes de texte ou une partie d’une ligne de texte.

Syntaxe

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

Paramètres

  • text : n’importe quel texte, y compris des caractères de fin de ligne (EOL), sauf /* et */.

Exemples

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