"Match failed" error occurs on the "Deduplication rules" or "Matching rules" page

Note

On September 1, 2023, we merged and renamed Dynamics 365 Marketing and Dynamics 365 Customer Insights. Dynamics 365 Marketing is now called Dynamics 365 Customer Insights - Journeys. Dynamics 365 Customer Insights is now called Dynamics 365 Customer Insights - Data. For more information, see Dynamics 365 Customer Insights FAQs.

This article provides a resolution for an issue where data unification fails due to a deduplication or matching rule failure.

Symptoms

The following error message appears on the Deduplication rules or Matching rules page.

Match failed.

Cause 1: Failed data refresh

If a data refresh fails, the data might be partially updated, causing inconsistencies in the dataset. The inconsistencies can lead to discrepancies in downstream operations.

Resolution

To solve the issue, take the following steps:

  1. Go to Data > Data sources and view the status of the data sources used in the data unification process.

  2. If any data source failed or hasn't been updated recently, refresh the data source.

  3. Rerun the unification process.

Cause 2: Source table changes aren't reflected in Customer Insights - Data

If changes are made to a source table that isn't ingested into Customer Insights - Data, the data is out of synchronization.

Resolution

To solve the issue, take the following steps:

  1. View your source tables for any recent changes.

  2. Go to Data > Data sources and view the data sources and the data reflected in Customer Insights - Data.

  3. If the data is out of synchronization, rerun the ingestion process or refresh the data.

  4. Rerun the unification process.

Cause 3: Missing data files or partition paths

If you encounter error messages indicating data files or partition paths for specific tables are missing, investigate the cause.

Resolution

To solve the issue, take the following steps:

  1. Verify that the required data files or partition paths exist and are accessible. If they're missing, troubleshoot the data ingestion pipeline or source system to ensure the data is correctly provided to Customer Insights - Data.

  2. Rerun the unification process.

Cause 4: Transient issue

Occasionally, a transient issue might cause a processing failure.

Resolution

To solve the issue, rerun the unification process.