Scopes

Use this settings page to define scopes – sets of files to apply different operations to.

For more information about scopes, refer to Scopes and file colors.

Item	Tooltip	Description
	Add scope `Alt+Insert`	Add a new local or shared scope.
	Delete `Alt+Delete`	Delete the selected scope from the list.
	Copy configuration `Ctrl+D`	Create a copy of the selected scope.
	Save as	Save the selected local scope as shared or the selected shared scope as local.
	Move Up / Move Down	Move the scopes up and down in the list.

Scope configuration controls

Item

Description

Name

Specify the scope name.

Pattern

Specify the pattern that defines the current scope. The following elements and structures can be used:

The file: modifier. The element is mandatory.
The * asterisk to denote any symbol in a filename or file extension.
Logical operators AND (&&), OR (||), and NOT (!).

Storing empty or incorrect patterns is not allowed. In such cases, DataGrip shows a Syntax Error warning.

Examples

Description	Pattern	Example
Include a single file by its name	`file:<directory>/<file>`	`file:databases/create_schema.sql`
Include a set of all files in a directory, without subdirectories	`file:<directory>/*`	`file:databases/mysql-db/*`
Include a set of all files in a directory with subdirectories	`file:<directory>//*`	`file:databases/mysql-db//*`
Include a file by its name from the certain project	`file[project_name]:<directory>/<file>`	`file[default]:databases/create_schema.sql`
Possible logical operators &&·(AND), \|\|·(OR), !·(NOT).	`file[project_name]:<directory>&&!file:<directory>`	`file[default]:databases/*&&!file:databases/create_schema.sql`

Include

Included the selected item. If the current item is a folder, the nested subfolders are ignored.

Include Recursively

Include the selected folder and all nested subfolders with their contents.

Exclude

Exclude the selected item. If the current item is a folder, the nested subfolders remain in the scope.

Exclude Recursively

Exclude the selected folder and all nested subfolders with their contents.

Scope toolbar

Item	Tooltip	Description
Project tree view		The tree view contains all the files available in your project. In the view, select the desired files to be included in the current scope and have the scope definition pattern generated automatically.
	Show Files	When this option is enabled, source files are displayed explicitly in the tree view. When the files are shown, they can be selected for exclusion/inclusion into a pattern. If this option is not disabled, all files are hidden from the tree.
	Show Included Only	When this option is enabled, the tree shows only the elements that are included in the scope.

Item

Tooltip

Description

Project tree view

The tree view contains all the files available in your project. In the view, select the desired files to be included in the current scope and have the scope definition pattern generated automatically.

Show Files

When this option is enabled, source files are displayed explicitly in the tree view. When the files are shown, they can be selected for exclusion/inclusion into a pattern.

If this option is not disabled, all files are hidden from the tree.

Show Included Only

When this option is enabled, the tree shows only the elements that are included in the scope.

Last modified: 27 June 2024

Scopes

Main toolbar

Scope configuration controls

Examples

Scope toolbar