Set up the database schema file

The DB Sync system needs application SQL tables description to be provided in the database schema file.

Important:

If it does not exist, the tasks described in this section will create the DB Sync schema file in the "conf" sub-directory of the DB Sync deployment directory of the GAS. Before un-deploying the DB Sync system and removing the deployed files from the GAS, you may want to keep a copy of the schema file.

Tip:

In the context of GAS upgrade, you might just want to copy the files form the previous GAS installation.

Create the DB Sync database schema file using the following steps:
  1. Open the dbsync.html starter page in a browser:
    http[s]://host:port/ua/web/dbsync_setup_server_config/dbsync.html
    For example:
    http://toro:6394/ua/web/dbsync_setup_server_config/dbsync.html
  2. Select the Database schema editor application.

  3. Connect as dbsync_admin user.

  4. The schema tool will detect unexisting schema file and ask to extract it.

  5. Edit the schema by defining the type of synchronization you want for each table, auto-incremented columns, the type of foreign key relation between tables.

    For more details about database schema definitions, see Database schema reference.

  6. Verify the schema file with the Check option.

  7. Save changes. The schema file location is defined by the schema parameter in the global DB Sync configuration file dbsync_config.json.

  8. Note that the DB Sync schema can be extracted with the dbsync schema tool:
    dbsync_schema extract extract-options
    The schema editor can be started with:
    dbsync_schema edit -c dbsync_config.json
See also Database schema reference.