SQL deyimlerine açıklama ekleme

  • Makale

Şunlar için geçerlidir:check marked yes Databricks SQL check marked yes 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, bir metin satırının tamamını veya metin satırının 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ı açıklamalar

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