مشاركة عبر

إضافة تعليقات إلى عبارات SQL

  • مقالة

ينطبق على:check marked yes Databricks SQL check marked yes Databricks Runtime

التعليقات مفيدة لتوثيق التعليمات البرمجية SQL وتعطيل التعليمات البرمجية SQL مؤقتا.

يمكنك إضافة تعليقات إلى التعليمات البرمجية SQL قبل العبارات وبعدها وداخلها. يتم تجاهل التعليقات من قبل Azure Databricks ما لم يتم التعرف عليها كتلميحات.

يتم دعم أشكال التعليقات التالية:

تعليقات بسيطة

تستخدم التعليقات البسيطة لتغطية سطر نص كامل أو باقي سطر من النص يبدأ ب --

بناء الجملة

-- text

المعلمات

  • text: أي نص باستثناء حرف نهاية السطر (EOL) مثل \n.

الأمثلة

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

تعليقات بين قوسين

تستخدم التعليقات بين قوسين لتغطية أسطر متعددة من النص أو جزء من سطر من النص.

بناء الجملة

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

المعلمات

  • text: أي نص يتضمن أحرف نهاية السطر (EOL)، باستثناء /* و */.

الأمثلة

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