کامنت ها (Comments)
کامنت (Comment) یعنی توضیح داخل کد. اجرا نمی شود، فقط به انسان کمک می کند. مثل یادداشت کنار تمرین ریاضی. بنابراین، خوانایی بالا می رود و خطا کمتر می شود.
کامنت تک خطی با --
هر چیزی بعد از «--» تا انتهای همان خط، نادیده می شود.
-- Select all:
SELECT *
FROM Customers;
می توان انتهای یک خط را هم بی اثر کرد.
SELECT *
FROM Customers -- WHERE City='Berlin';
حتی می توان کل یک دستور را با کامنت، غیرفعال کرد.
-- SELECT * FROM Customers;
SELECT *
FROM Products;
کامنت چندخطی با /* ... */
هر چیزی بین «/*» و «*/» نادیده می شود. برای توضیح بلند عالی است.
/* Select all the columns
of all the records
in the Customers table: */
SELECT *
FROM Customers;
می توان چند دستور را یکجا غیرفعال کرد.
/* SELECT * FROM Customers;
SELECT * FROM Products;
SELECT * FROM Orders;
SELECT * FROM Categories; */
SELECT *
FROM Suppliers;
بی اثر کردن بخشی از دستور
می توان فقط یک قسمت را با /* ... */ حذف موقت کرد.
SELECT CustomerName,
/* City, */
Country
FROM Customers;
یا بخش هایی از شرط ها را موقتاً کنار بگذار.
SELECT *
FROM Customers
WHERE (
CustomerName LIKE 'L%'
OR CustomerName LIKE 'R%'
/* OR CustomerName LIKE 'S%'
OR CustomerName LIKE 'T%' */
OR CustomerName LIKE 'W%'
)
AND Country = 'USA'
ORDER BY CustomerName;
گام های عملی
- قبل از هر کوئری حساس، توضیح کوتاه بنویس.
- برای تست، بخش ها را با کامنت غیرفعال کن.
- بعد از اطمینان، کامنت های آزمایشی را پاک کن.
- قوانین تیمی برای سبک کامنت تعیین کن.
نکته: از "-- " برای توضیح های کوتاه، و از /* ... */ برای چند خط استفاده کن.
لینک های داخلی پیشنهادی
- توابع Null (Null Functions) برای مدیریت NULL کنار کامنت های آزمایشی.
- عملگرها (Operators) برای نوشتن شرط های خواناتر.
جمع بندی سریع
- -- برای یک خط، سریع و ساده است.
- /* ... */ برای چند خط عالی است.
- کامنت اجرا نمی شود؛ فقط توضیح می دهد.
- برای تست، بخش ها را موقتاً کامنت کن.