Ajout de commentaires à des instructions SQL

S’applique à : Databricks SQL 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 */

Rubriques connexes

• Indicateurs
• Comment lire un diagramme de syntaxe