SQL comments - MaxCompute - Alibaba Cloud Dokümantasyon Merkezi

MaxCompute'de SQL yorumları, mantığı satır içi açıklayarak kod okunabilirliğini artırır. Bu konuda, MaxCompute SQL betiklerinde tek satırlı ve çok satırlı yorumların nasıl yazılacağı açıklanmaktadır.

Sınırlamalar

DataWorks veri geliştirme arayüzünde çok satırlı yorumlar kullanılamaz.
MaxCompute yerel istemcisinde (odpscmd) SQL yorumlarını kullanmak için odpscmd sürümünün 0.49.0 veya üzeri olması gerekir.
MaxCompute istemcisinde (odpscmd) ve Cloud Shell'de (odpscmd), tek satırlı bir yorumu sonlandırmak için noktalı virgül (;) gereklidir. Çok satırlı yorumlarda noktalı virgül desteklenmez.

Söz dizimi

Tek satırlı yorumlar

Tek satırlı yoruma -- ile başlayın. -- işaretinden satır sonuna kadar olan tüm içerik yorum olarak kabul edilir.

-- Comment content

Yorumu kodun üzerinde ayrı bir satıra veya kod satırının sonuna ekleyin.

Not

MaxCompute konsolunun SQL analiz arayüzünde veya DataWorks veri geliştirme arayüzünde, bir kod satırını yorum haline getirmek için Ctrl+/ kısayolunu kullanın.

Çok satırlı yorumlar

Çok satırlı bir yorumu açmak için /* ve kapatmak için */ kullanın; bu sayede bir içerik bloğunu tek seferde yorum haline getirebilirsiniz.

/*
Comment
content
*/

Önemli

MaxCompute ayrıca /*+...*/ yapısını Hint söz dizimi olarak destekler; örneğin MAPJOIN ipuçları ve SKEWJOIN HINT. İpuçları, çok satırlı yorumlara göre önceliklidir. Belirsizliği önlemek amacıyla çok satırlı yorumları açarken /* yerine /** kullanın.

Örnekler

Aşağıdaki örneklerde mevcut bir tablo olarak my_table kullanılmaktadır.

Tek satırlı yorum

Aşağıdaki örnekte, bir ifadenin üstüne ve satır sonuna eklenen tek satırlı yorum gösterilmektedir:

-- Single-line comment
DESC my_table; -- Single-line comment

Çok satırlı yorum

Aşağıdaki örnekte, bir SELECT deyimine gömülü çok satırlı bir yorum gösterilmektedir:

SELECT /* Valid
multi-line
comment
*/ * FROM my_table;

Yaygın hata: `/*+` ifadesinin Hint olarak yanlış yorumlanması

Çok satırlı bir yoruma /*+ ile başlamak, MaxCompute'ün bunu yorum yerine bir Hint başlangıcı olarak yorumlamasına neden olur:

SELECT /*+ Invalid
multi-line
comment
*/ * FROM my_table;

Bu durumu önlemek için çok satırlı yorumları açarken /** sembolünü kullanın.