I want to add comment in SQL code. How can I do this? I'm using MySQL.
6 Answers
Several ways:
# Comment
-- Comment
/* Comment */
Remember to put the space after --
.
See the documentation.
-
87
-
2Is there any general best practice or style guideline for when to use these different syntaxes? Obviously the last one is ideal for multi-line comments, but is there any rule of thumb for single-line comments?– StockBNov 21, 2016 at 16:26
-
3@StockB no, but it never hurts to be consistent with your coding styles.– gdoronMay 23, 2017 at 8:01
"A comment for a column can be specified with the COMMENT
option. The comment is displayed by the SHOW CREATE TABLE
and SHOW FULL COLUMNS
statements. This option is operational as of MySQL 4.1. (It is allowed but ignored in earlier versions.)"
As an example
--
-- Table structure for table 'accesslog'
--
CREATE TABLE accesslog (
aid int(10) NOT NULL auto_increment COMMENT 'unique ID for each access entry',
title varchar(255) default NULL COMMENT 'the title of the page being accessed',
path varchar(255) default NULL COMMENT 'the local path of teh page being accessed',
....
) TYPE=MyISAM;
-
-
5It's what I was looking for :) Incidentally, I found the COMMENT argument had to be before any AFTER argument; order is important, evidently. Feb 9, 2018 at 9:15
You can use single-line comments:
-- this is a comment
# this is also a comment
Or a multiline comment:
/*
multiline
comment
*/
-
The
#
form is not accepted by the syntax highlighter here ("lang-sql
"). Is it the syntax highlighter's fault or is that form special for MySQL? Jan 31, 2022 at 13:56
From here you can use:
# For single line comments
-- Also for single line, must be followed by space/control character
/*
C-style multiline comment
*/
-
The
#
form is not accepted by the syntax highlighter here ("lang-sql
"). Is it the syntax highlighter's fault or is that form special for MySQL? Jan 31, 2022 at 13:58
/* comment here */
Here is an example:
SELECT 1 /* this is an in-line comment */ + 1;
Reference: 9.7 Comments
Three types of commenting are supported:
Hash base single line commenting using #
Select * from users ; # this will list users
Double Dash commenting using
--
Select * from users ; -- this will list users
Note: It's important to have single white space just after
--
Multi line commenting using /* */
Select * from users ; /* this will list users */