یادداشت نویسی در SQL

گاهی نیاز است برای توضیح دادن بخشی از کد SQL بالای آن یادداشت گذاشت یا اینکه از اجرای بخشی از کد با تبدیل آن به یادداشت جلوگیری کرد.

یادداشت گذاری برای یک خط تکی با دو علامت -- انجام می شود.
تمام نوشته هایی که بعد از علامت -- تا انتهای خط بیایند اجرا نمی شوند و از آن ها صرف نظر می شود.

در مثال زیر یک یادداشت تک خطی به عنوان توضیحات آمده است:

-- انتخاب همه مشتریان: 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;