GoLand 2020.1 Help

Schemas

Create a schema

  1. Right-click the data source and navigate to New | Schema.

  2. In the Name field, specify a name of the schema.

  3. Click Execute.

Select the default schema

  • You can select the default schema or database by using the list, which is in the upper-right part of the toolbar. When you select the default schema, you can omit the name of that schema or database in your statements.

    Click the <schema> list and select the schema that you need.

    Select the default schema or database

Show and hide schemas

  • In the Database tool window (View | Tool Windows | Database), right-click a data source and navigate to Database Tools | Manage Shown Schemas. Select or clear checkboxes of schemas that you want to enable or disable. Press Enter.

  • Click the N of N link near the data source name. In the schema selection window, select or clear checkboxes of schemas that you want to enable or disable. Press Enter.

  • To hide all schemas, navigate to Database Tools | Hide Schemas.

    Show and hide schemas

Compare two schemas

  1. Select two schemas.

  2. Right-click the selection and navigate to Compare.

    Compare two schemas

Set the schema search path for PostgreSQL and Redshift

The search_path environment variable in PostgreSQL specifies the order in which schemas are searched. For example, you set the value of search_path to z,a,public, PostgreSQL will look for a value in the z schema. If nothing was not found in the z schema, PostgreSQL looks for the value in the a schema.

In PostgreSQL and Amazon Redshift, the default search path (the path that is set in a database) is used unless you specify a different search path.

  1. Click the <session> list, navigate to the list of database schemas (use the arrow icon the Arrow icon or press the right arrow key).

  2. Select the schema that you want to add to a search path.

    To form a search path, you can use the following actions:

    • Press Space to add a highlighted schema to the search path and to remove a schema from the search path.

    • Press Alt+Up and Alt+Down to reorder the schemas within the search path.

  3. To apply the changes, press OK.

    Control the search path for PostgreSQL and Redshift

Save a search path between IDE restarts

  1. In the Database tool window (View | Tool Windows | Database), right-click a PostgreSQL or Amazon Redshift data source and select Properties Shift+Enter.

  2. Click the Options tab.

  3. From the Switch schema list, select Automatic.

  4. Click OK.

    Save a search path between IDE restarts

Force refresh schema information

The Force Refresh action clears the data source information from cache and loads it again from scratch.

  • In the Database tool window (View | Tool Windows | Database), right-click a data source and select Database Tools | Force Refresh.

    Force refresh schema information

Pre-introspected objects from system catalogs

Introspection is a method of inspecting a data source. When you perform introspection, structural information in the data source is inspected to detect tables, columns, functions, and other elements with their attributes.

A system catalog is a place where a relational database management system (DBMS) stores information about tables and columns, built-in functions, and other schema objects. These objects are used in coding assistance (for example, code completion).

System schemas have the lightning icon Enable or disable the usage of pre-introspected objects in the schema selection dialog. If you do not select these schemas, GoLand does not introspect them and does not show them in the Database tool window. Though information about schema objects are used in coding assistance. It is possible because GoLand uses internal data about schema objects that was introspected earlier (pre-introspected data). To enable usage of pre-introspected data in GoLand, open data source settings by pressing Shift+Enter, click the Options tab and select Use pre-introspected objects for system catalogs that are not introspected.

Examples of system catalogs in different DBMS:

  • PostgreSQL: pg_catalog, information_schema

  • Microsoft SQL Server: INFORMATION_SCHEMA

  • Oracle: SYS, SYSTEM

  • MySQL: information_schema

  • IBM Db2: SYSCAT, SYSFUN, SYSIBM, SYSIBMADM, SYSPROC, SYSPUBLIC, SYSSTAT, SYSTOOLS

Show objects from system catalogs in coding assistance

Introspect system catalogs for a data source

By default, GoLand uses pre-introspected objects for system catalogs.

  1. In the Database tool window (View | Tool Windows | Database), right-click a data source and select Properties Ctrl+Alt+S.

  2. In the Data Sources and Drivers dialog, click the Options tab.

  3. Clear the Use pre-introspected objects for system catalogs that are not introspected checkbox.

  4. In the scheme selection window, select system catalogs that you want to introspect.

    Introspect system catalogs for a data source

Use pre-introspected data for the selected system catalog

You can still use pre-introspected objects for a system catalog even if you disable the usage of such objects for a data source.

  1. Clear the Use pre-introspected objects for system catalogs that are not introspected checkbox on the Options tab in data source settings.

  2. Open the scheme selection window, clear the checkbox of a system catalog.

  3. Click the system catalog entry.

  4. Click the lightning icon Enable or disable the usage of pre-introspected objects, which is in the upper-right corner of the window.

Last modified: 19 June 2020