Manually Synchronizing a System

You can manually synchronize source systems with the catalog. Running a manual synchronization is time- and resource-intensive. Only run it in certain conditions, such as after creating a connection to a source system or after resolving metadata extraction issues from existing source systems.

Prerequisites

To manually synchronize a source system, you must have a global role that grants you the following privileges:
  • Data Warehouse General (-R------) - To access SAP Datasphere.

  • Catalog System (-RUDE--) - To view, edit, and delete source system connections and manually synchronize source system.

The Catalog Administrator global role and the DW Viewer role template (used directly as a global role) applied together, for example, grant these privileges. For more information, see Privileges and Permissions and Standard Roles Delivered with SAP Datasphere.

Context

The catalog extracts new and updated metadata from source systems automatically, as a scheduled task, or by a background process (see Understanding Different Methods for Extracting Metadata). On occasion you might need to manually synchronize a source system with the catalog. Manual synchronization can be time- and resource-intensive, so run it only under certain conditions.

Run a manual synchronization on systems with assets in these situations:
  • After creating or restoring connections:
    • You created a connection to a source system that has existing objects.

    • You restored a connection for a source system to capture changes that occurred while it was deleted.

    • You restored a deleted space in an SAP Datasphere source system.

  • After authentication or permission changes:
    • The authorized user's login credentials changed, or a different authorized user is used.

    • The authorized user's access permissions changed, or content moved to different locations in the source system.

  • After issues or upgrades:
    • You resolved errors in the extraction logs (for example, missing metadata).

    • An application upgrade left the extraction status for a source system as Outdated.

Run a manual synchronization on systems with data products in these situations:
  • After a data product was created (make it available immediately) or deleted (remove it immediately).

  • After a data package was activated or deactivated in the SAP Business Data Cloud cockpit.

  • After a synchronization failure occurs (rerun to recover and refresh).

Procedure

  1. In the side navigation area, choose (Catalog & Marketplace)Start of the navigation path Next navigation step End of the navigation path (Metadata Extractions).
  2. Select the source system you want to manually synchronize and choose Synchronize.
  3. Review the confirmation dialog and choose Synchronize to confirm and start the manual synchronization job.

Results

After the synchronization finishes, a notification appears. The objects are updated and available in the catalog where you can review them.

Next Steps

Check the catalog for assets and data products that you're expecting to see changes for (for example, new, updated, or removed assets or data products) and review their details page.

When you check the assets, you can review and enrich them as needed and check their publishing status (see Enriching and Managing Catalog Assets):
  • If automatic publishing isn't enabled for a connected source system, you must manually publish the assets so catalog users can find and use them.

  • If automatic publishing is enabled for a newly connected source system, all assets are automatically published to the catalog with their publication status set to Published.

  • If automatic publishing is enabled for an existing source system connection, the assets are published as follows:

    • Objects that are newly created in the source system are published as assets with their publication status set to Published.

    • Existing assets that have the Unpublished and Current statuses are published, and their publication statuses are updated to Published.

    • Existing assets that have the Published status remain published, and the publication status is unchanged.

    • Existing assets that have the Exclude status remain hidden to catalog users and the publication status is unchanged.

    If there are assets that you don't want published, search for those assets and set their publication status to Excluded. For more information, see Publishing Content to the Catalog.