Formatting T-SQL in SSMS 2012

by user11512   Last Updated August 14, 2019 13:06 PM

According to this Microsoft document:

http://msdn.microsoft.com/en-us/library/ms174205.aspx

I am supposed to be able to use ctrl+K then ctrl+D to format my SQL documents in SQL Server Management Studio 2012 but when I use that combo I get the error:

The key combination (Ctrl+K, Ctrl+D) is bound to command (Format Document) which is not currently available.

I am trying to make modifications to an existing SQL document that has no formatting to it at all which makes it extremely difficult to read. Does anyone know how to make the Format Document command available so I can have SQL format this code for me?

Tags : sql-server ssms


Answers 4


I don't believe this is possible in SSMS. There was a Connect item opened up for this feature.

What I personally like to use for poorly formatted SQL code is the web application on Poor SQL. It does a really nice job of formatting SQL code to your specifications. Even generates HTML if you so desire. I don't use the SSMS plug-in or any other deliverables they advertise, I always just hop on the site to do the quick formatting and then copy/paste right into SSMS.

Thomas Stringer
Thomas Stringer
June 21, 2013 15:26 PM

The keyboard combination you're after (Ctrl+K, Ctrl+D) is for "formatting" - but not to the extent you seem to expect. It is not a prettifier, it is just used to insert correct spacing and tabs as found in Tools > Options > Text Editor > Transact-SQL > General/Tabs - so if you highlight a portion of text and hit the keyboard combination, it is supposed to convert tabs to 4 spaces (if you've selected insert spaces), apply the type of indenting you've specified, etc.

This option is NOT intended to make code more readable - this is not functionality that Management Studio currently offers natively. Though there are several 3rd party options - some are external to Management Studio, like:

And there are add-ins as well for various levels of formatting assistance within the editor:

Now, the reason you are getting the message...

The key combination (Ctrl+K, Ctrl+D) is bound to command (Format Document) which is not currently available.

...is because SSMS has mapped that key combination to a different context. The way you should be able to "fix" this - again, it still wouldn't do what you want it to do, even if the "fix" worked - is by doing the following:

  1. Go to Tools > Options > Environment > Keyboard
  2. Place your cursor into the Press shortcut keys: box
  3. Hit Ctrl+K, Ctrl+D
  4. Change the Shortcut currently used by: drop-down from DataWarehouse Designer to Text Editor

    enter image description here

  5. Press OK

Now, this is supposed to map the keyboard combination to the text editor, but Management Studio reverts it after hitting OK (you will continue to get the error message. So, I think the problem is that the documentation believes this functionality exists, but Management Studio knows better and simply doesn't offer it (and Microsoft will likely write this off as a bug in the documentation, and correct it, rather than a shortcoming in the tool). There may be hope in the future but, for now, this is a known and largely ignored issue. You'll note that the Formatting tab that the documentation refers to is simply not present (though it is there for XML, where the keyboard combination does work). The documentation should probably state:

Applies the indenting and space formatting for the language specified on the Formatting pane of the language in the Text Editor section of the Options dialog. Available only in the text editor and only for certain languages.

Another way to get an idea of what type of formatting options SSMS offers natively is to go to Tools > Customize > Commands > Edit > Add Command... > Format and look at the list of possible commands there. Nothing that indicates there is any knowledge of the actual language, so it wouldn't know where to insert line breaks or add additional indents or assist with parentheses etc.

enter image description here

If you want language-specific formatting to make existing T-SQL code more readable, you won't get much from SSMS, and you'll need to seek other options.

Aaron Bertrand
Aaron Bertrand
June 21, 2013 17:32 PM

Install an add-on that does this. I use the Free Edition of SQL Complete: http://www.devart.com/dbforge/sql/sqlcomplete/ which offers some basic SQL formatting functionality. It integrates with SSMS and uses Ctrl + K, D.

Robert Niestroj
Robert Niestroj
June 21, 2013 19:47 PM

SqlSmash is a commercial tool that lets you format your SQL (and much more) in SSMS 2012 and 2014. The default keyboard shortcut is (Ctrl + K, Ctrl + D).
Disclaimer: I am the developer behind it.

Latish
Latish
August 01, 2014 21:05 PM

Related Questions


SQL AlwaysOn Dashboard Not Showing Green Circles

Updated June 27, 2019 21:06 PM

Conext menu behaviour change in SSMS 18.0/18.1

Updated June 20, 2019 15:06 PM

SSMS refuses to start

Updated May 20, 2019 19:06 PM