Configure the SQL code style
This functionality relies on the Database Tools and SQL plugin, which is bundled and enabled in PyCharm by default. If the relevant features are not available, make sure that you did not disable the plugin.
note
The Database Tools and SQL plugin is available only in PyCharm Professional.
Press to open settings and then select Plugins.
Open the Installed tab, find the Database Tools and SQL plugin, and select the checkbox next to the plugin name.
You can apply and customize the SQL code style that satisfies code guidelines of your company.
To see the description of SQL style options, refer to Code Style. SQL.
Customize formatting rules for the SQL code: alignment, wrapping, and indentation.
Open settings by pressing and navigate to Editor | Code Style | SQL. .
Expand the SQL node and select a dialect.
Select all the necessary code style settings on the available tabs.
Click Apply.
tip
When you apply the rule, PyCharm updates the SQL code and highlights all modified parts in the preview pane.
Open settings by pressing and navigate to Editor | Code Style | SQL. .
Expand the SQL node and select a dialect.
Click the Show Scheme Actions icon (), and select Duplicate.
Type a name for a new style, and press .
Select all the necessary code style settings, and click Apply.
After you created a style for a dialect, you can apply this style to the data source that uses this dialect.
Right-click a data source and select Properties.
Click the Options tab.
In the Code style drop-down menu, select a style that you want to apply.
Click Apply.
Right-click any area or a selection of code in the editor and select Reformat Code. Alternatively, press .
Open settings by pressing and navigate to Editor | Code Style | SQL. .
Expand the SQL node and select a dialect.
Click the Set from link and select the style that you want to import.
You can select preconfigured styles like Modern, Joe Celko Allman (DDL only), Whitesmiths (DDL only), Egypt, Old Idea. Or, import settings from the dialect that you configured.
Open settings by pressing and navigate to Code Style | SQL | SQL:2016, Generic. .
Clear the Inherit general SQL style checkbox.
Apply code style settings. For more information about code style settings, refer to Code Style. SQL.
PyCharm can format names of variables, procedures, and functions as you defined them initially. For example, if you defined the get_Amount
function in the CREATE PACKAGE
statement, you want the same case throughout your code, not GET_AMOUNT
or get_amount
.
To apply this case throughout the file, PyCharm must find the declaration of these variables, procedures, and functions (for example, in the CREATE PACKAGE
statement). To apply the case in multiple files, create a DDL data source from these files.
Open settings by pressing and navigate to Editor | SQL. .
Select the dialect in which you want to apply the original case from the declaration.
Click the Case tab and select the Use original case checkbox.
Click OK.
Click Code | Reformat Code or press .
On the following image, you can see Pack_1.sql and Pack_2.sql with identical code. Pack_1.sql is not reformatted. Pack_2.sql was reformatted with the Use original case checkbox enabled. In Pack_2.sql, the case from the package declaration was applied throughout the whole file.
Create a DDL data source from the files for which you want to apply the declaration case.
Open settings by pressing and navigate to Editor | SQL. .
Select the dialect in which you want to apply the declaration case settings.
Click the Case tab and select the Use original case checkbox .
Click OK.
Click Code | Reformat Code or press to apply the declaration case in any file of the DDL data source.