DataGrip 2021.3 Help

DDL mappings

DDL mapping functionality sets the relation between the regular data source and the DDL data source. By using mapping, you can explicitly select schemas in the real data source to synchronize objects with the DDL data source. And, alternatively, any changes in the DDL data source can be applied to a regular data source.

For example, you can create the actor_1 table in your PostgreSQL data source, and later by using the DDL Mapping | Update from PostgreSQL action in the context menu, add the actor_1.sql file to your DDL data source folder with SQL files. Or, add actor_1.sql file to the DDL data source, select DDL Mapping | Apply to PostgreSQL in the context menu, and the actor_1 table will appear in the PostgreSQL data source.

DDL_mappings

Add a DDL mapping

  1. Open data source properties. You can open data source properties by using one of the following options:

    • Navigate to File | Data Sources.

    • Press Ctrl+Alt+Shift+S.

    • In the Database Explorer (View | Tool Windows | Database Explorer), click the Data Source Properties icon The Data Source Properties icon.

  2. Click the DDL Mappings tab.

    Alternatively, you can get to this tab by clicking a data source in the Database Explorer (View | Tool Windows | Database Explorer) and selecting Create DDL Mapping.

  3. Click the <Choose Data Source> for Data Source.

  4. Select or create a data source to map.

  5. Click the <Choose Data Source> for DDL Data Source.

  6. Select or create a DDL data source to map.

  7. In the Scope tree, select schemas or databases that will be used in mapping.

Add a DDL mapping

Apply changes from a data source to a DDL data source

  1. Ensure that the DDL mapping is created.

  2. In the Database Explorer (View | Tool Windows | Database Explorer), right-click a DDL data source and select DDL Mapping | Update from data_source_name.

    Apply changes from a data source to a DDL data source

Apply changes from a DDL data source to a data source

  1. Ensure that the DDL mapping is created.

  2. In the Database Explorer (View | Tool Windows | Database Explorer), right-click a DDL data source and select DDL Mapping | Apply to data_source_name.

  3. In the Migration dialog, select changes that you want to apply.

    If necessary, modify scripts generated in the Script Preview tab. Leave only those scripts that you plan to execute.

  4. Click Execute.

Dump to DDL data source

  1. Ensure that the DDL mapping is created.

  2. In the Database Explorer (View | Tool Windows | Database Explorer), right-click a data source and select DDL Mapping | Dump to DDL_data_source_name.

    If there are objects in the DDL data source that are missing in a regular data source. You will see a warning that those files will be deleted.

    Dump to DDL data source

Settings

Name

Description

Name

Name of the mapping.

Comment

You comment for the mapping.

Data Source

Select or create a data source that will be mapped to a DDL data source.

DDL Data Source

Select or create a DDL data source to map to the real data source.

Scope

Select schemas or databases that will be used in mapping.

Last modified: 15 November 2021