158

I want to add comment in SQL code. How can I do this? I'm using MySQL.

0

6 Answers 6

258

Several ways:

# Comment
-- Comment
/* Comment */

Remember to put the space after --.

See the documentation.

3
  • 87
    Remember to put the space after --
    – Pacerier
    Mar 13, 2015 at 11:20
  • 2
    Is 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?
    – StockB
    Nov 21, 2016 at 16:26
  • 3
    @StockB no, but it never hurts to be consistent with your coding styles.
    – gdoron
    May 23, 2017 at 8:01
34

"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;
2
  • I don't think this is what OP was asking for. Jan 4, 2018 at 22:47
  • 5
    It'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
20

You can use single-line comments:

-- this is a comment
# this is also a comment

Or a multiline comment:

/*
   multiline
   comment
*/
1
3

From here you can use:

#  For single line comments
-- Also for single line, must be followed by space/control character
/*
    C-style multiline comment
*/
1
1
/* comment here */

Here is an example:

SELECT 1 /* this is an in-line comment */ + 1;

Reference: 9.7 Comments

1

Three types of commenting are supported:

  1. Hash base single line commenting using #

    Select * from users ; # this will list users
    
  2. Double Dash commenting using --

    Select * from users ; -- this will list users
    

    Note: It's important to have single white space just after --

  3. Multi line commenting using /* */

    Select * from users ; /* this will list users */
    

Not the answer you're looking for? Browse other questions tagged or ask your own question.