Object Sync and revisionHash (KBA10886)

At a Glance

Description	This page provides information about Engine Sync and how to determine if objects are the same on different engines.
API	The easiest way to see the revisionHash (aka Revision Hash) is to use the following endpoint: API: GET /syncable-objects It is also available in: API: POST /export
Algorithms	Algorithms and sync are frequently discussed, in summary: Every algorithm, when created, will have a unique key. To get the same masked result on a different engine, the algorithm needs to be synced.
revisionHash	The revisionHash shows if objects on different engines are in sync: Same revisionHash value means that the object is the same. Note: The revisionHash is updated as soon as an object is saved (even if nothing was modified). This means that objects with different revisionHash values can still be the same. To be safe it is best to Sync and, when viewing the result, click Cancel (instead of Save).
Versions	The Sync operation is constantly being enhanced, some key notes and changes include: Forward Sync operation (syncing from newer to older) is not supported. Version 6.0.15.0 - All Algorithms have individual keys (before this version the Global Key was used). Version 20.0.0.0 - Sync operations can run concurrently (this is to support Data Control Tower (DCT)).
More Info	For information about investigating errors and the logs: KBA: Troubleshooting and Accessing Masking Logs (KBA7988) More information about Keys and Masking Sync: DOC: Sync Concepts DOC: Sync endpoints

Background

This article describes how to determine when objects on different engines are in sync and describes how revisionHash works.

Accessing revisionHash

To access the revisionHash use the following API:

API: GET /syncable-objects

Specify 'object_type'
Execute

...
   {
      "objectIdentifier": {
        "algorithmName": "dlpx-core:CM Digits"
      },
      "objectType": "USER_ALGORITHM",
      "revisionHash": "4e6fd7351692cea0d90a4afd72acca2715dfe127"
    }
...

Calculation

The revisionHash is calculated based on all details in the object and referenced objects (including when it was modified).

Therefore, saving an algorithm will change the revisionHash on all jobs that use this algorithm.

Applicable Delphix Versions

Click here to view the versions of the Delphix engine to which this article applies

Date	Release
Feb 21, 2024	20.0.0.0
Jan 25, 2024	19.0.0.0
Dec 20, 2023 \| Jan 10, 2024	18.0.0.0 \| 18.0.0.1
Nov 21, 2023	17.0.0.0
Oct 18, 2023	16.0.0.0
Sep 21, 2023	15.0.0.0
Aug 24, 2023	14.0.0.0
Jul 24, 2023	13.0.0.0
Jun 21, 2023	12.0.0.0
May 25, 2023	11.0.0.0
Apr 13, 2023	10.0.0.0 \| 10.0.0.1
Mar 13, 2023 \| Mar 20, 2023	9.0.0.0 \| 9.0.0.1
Feb 13, 2023	8.0.0.0
Jan 12, 2023	7.0.0.0
Releases Prior to 2023
Major Release	All Sub Releases
6.0	6.0.7.0, 6.0.8.0, 6.0.8.1, 6.0.9.0, 6.0.10.0, 6.0.10.1, 6.0.11.0, 6.0.12.0, 6.0.12.1, 6.0.13.0, 6.0.13.1, 6.0.14.0, 6.0.15.0, 6.0.16.0, 6.0.17.0, 6.0.17.1, 6.0.17.2