Aracılığıyla paylaş

SQL deyimlerine açıklama ekleme

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime

Açıklamalar, SQL kodunu belgeleme ve SQL kodunu geçici olarak devre dışı bırakmak için kullanışlıdır.

SQL koduna deyimlerden önce, sonra ve deyimler içinde açıklamalar ekleyebilirsiniz. Açıklamalar, ipucu olarak tanınmadığı sürece Azure Databricks tarafından yoksayılır.

Aşağıdaki açıklama biçimleri desteklenir:

Basit açıklamalar

Basit açıklamalar, "--" ile başlayan bir metin satırının tamamını veya geri kalanını kapsayacak şekilde kullanılır.

Sözdizimi

-- text

Parametreler

  • text: gibi \nbir satır sonu (EOL) karakteri hariç tüm metinler.

Örnekler

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

Köşeli ayraçlı yorumlar

Köşeli ayraçlı açıklamalar, birden çok metin satırını veya metin satırının bir bölümünü kapsayacak şekilde kullanılır.

Sözdizimi

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

Parametreler

  • text: /* ve */ hariç, satır sonu (EOL) karakterleri dahil tüm metinler.

Örnekler

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