Skip to main content

๐Ÿ”„ Reconciliation Tests

Reconciliation Tests are used to verify that data in a target system matches data in a source system.
They are especially useful in scenarios like:

  • ๐Ÿ“ค Data migration between systems
  • ๐ŸŒ Cross-environment comparison (e.g., between UAT and Sandbox)

X-AutoMate supports reconciliation testing for all major DWH and database technologies.
You can learn more about supported platforms in the X-AutoMate Introduction.


๐Ÿงฌ Structural Similarity to ETL Testsโ€‹

Reconciliation tests are structurally similar to ETL test cases, but with a key difference:

  • ๐Ÿ†š Reconciliation tests compare data between two sources
  • ๐Ÿงฉ They use multiple specialized keywords
  • ๐Ÿงช They are often referred to as the "smaller sibling" of ETL tests

Additionally, reconciliation tests are automatically generated by X-AutoMate.
All you need to do is:

  1. Specify source and target connections
  2. Select objects and filters
  3. Submit โ€” and X-AutoMate will generate a Test Suite containing reconciliation test cases

These cases will appear under /tests/cases.


๐Ÿš€ Creating a Reconciliation Testโ€‹

To create a new reconciliation test:

  1. Open the /reconciliation page

  2. Select:

    • ๐Ÿ”— Source connection
    • ๐Ÿ”— Target connection
      (Make sure both connections are added beforehand.)
  3. Select the source and target objects (tables/views)

๐Ÿง  If the object list is empty or incomplete, click "Force Metadata Update" to refresh schema information.


๐Ÿ“Š Metadata Previewโ€‹

If profiling information is available, youโ€™ll see object-level metadata under the Comparison Object Details section:

Metadata Preview


๐Ÿง™ Advanced Modeโ€‹

Switching to the Advanced tab lets you specify objects using SQL syntax (e.g., core.employee).

PLEASE NOTE !

๐Ÿ›‘ X-AutoMate does not validate the existence of the object in this mode โ€” use with caution!


๐Ÿ“ Generating the Testโ€‹

Once all details are filled:

  • Press the Submit button to generate and execute reconciliation tests.
  • Alternatively, if you only want to generate the test cases, enable the "Generate Only" toggle.

Reconciliation UI