SQL'de Yorum (Comment) Yazma

SQL'de yorum(Comment) yazmanın iki farklı yolu vardır.

1. Sadece bir satıra yorum atmak

Satıra yorum atmak için iki tire(--) ile başlanır. Bu iki tireden sonra yazdığınız herşey yorum olarak algılanır ve program tarafından execute edilmez. Kodun çalışmasını istemediğiniz herhangi bir yerinde kullanabilirisiniz.

Example: If you want to see how many requests are success, cancelled or failed in a table called response, then you can run this query: 

 SELECT  response_result as "Result Name", count (response_result) as "Number"
       FROM response  
       --WHERE response_result='ERROR' 
         GROUP  BY response_result

   *!- As you see I made "WHERE" clause as comment with two dashes(--).
If you want to see only succes, or only fail or only cancelled requests then you can uncomment where clause and run, it will show the results with ERROR.


2. Kod bloğuna yorum atma, yorum yapma

Kod bloğunu yorum yapmak için eğik çizgi (/) ve yıldız kullanıp, sonda yıldız(*) ve eğik çizgiyi kullanıyoruz. 

Bu şekilde eğik çizgi ve yıldız ile başlayıp (/*), yıldız ve eğik çizgi(*/) arasında kalan bölge yorum olarak algılanır ve program tarafından execute edilmez. Bu comment genellikle büyük kod parçaları için kullanılır. Birden fazla satırı tek seferde yorum yapma kolaylığı sağlıyor.


Example:
              select co_id, count(*) as co_id_sayisi from customer
                  group by co_id having (count(*) >=2)
               where co_id=34627239
/* customer tablosunda arattığımız co_id değeri için farklı bir port_id bulduk.
Ve  PORT_SERİALNUM değerine de ulaştık.
*/

Burda da gördüğünüz gibi kod bloğunun altına satırlarca yorum yazabilirsiniz.

Notlar:
* Yorumlamak istediğiniz kodlar için herhangi bir limit yoktur. İstediğiniz kadar yorum yazabilirsiniz.
* İçiçe (nested) comment yazmanız da mümkündür.
* Execution time (run edilmediğinden) etki etmediği için performansı  da etkilemiyor.

Daha fazlası için buraya tıklayabilirsiniz.

Kaynak: Ercan Duman, blog.ercanduman.com