Unify and manage your data

Show Page Sections

Merge Tree Consistency Based on Records Task

Learn about the task to check and fix merge tree inconsistencies in the ENTITIES_MERGE_TREE column family.

This task scans the ENTITIES_MERGE_TREE column family to identify and, optionally, fix inconsistencies in merge tree structures, such as phantoms in losers.

A tenant admin role is required to run the request.

Request

POST {ApplicationURL}/api/{tenantId}/mergeTreeConsistencyCheckForRecords
Table 1. Path and Query Parameters
ParameterRequiredDescription
tenantIdYesThe identifier of the tenant to check.
distributedNoRuns in distributed mode if set to true.

This means that several tasks (as specified in tasksPartsCount) will be created instead of one. Each task will reindex its own part of objects. These tasks will be executed in parallel on different API nodes (if there are more than one free API node which may execute periodic tasks).

The parallelExecution parameter will be set to true automatically for all of these tasks in this case, therefore please make sure that no other tasks for the same tenant are running.

Default: false.

taskPartsCountNoNumber of tasks which will be created for distributed reindexing, each task will reindex its own part of objects, and all of them may be executed on different API nodes in parallel.

Recommended value: count of API nodes which can execute the tasks.

Default value: 2.

This parameter is only used in distributed mode, otherwise ignored.

fixInconsistencyNoIf set to true, the task fixes found inconsistencies.

Default: false.

produceEventsNoIf this parameter is set to true, the task generates events when an entity is fixed.

Default is true.

Table 2. Body Parameters
ParameterRequiredDescription
entitiesToCheckNoJSON Array of entity or relation URIs to check.

Default value is empty, meaning that all URIs will be checked.

checkAllNoScans losers, winners, and their winners’ crosswalks to ensure all contributors are in the tree.

Default: false.

checkLosersNoChecks only losers in the merge tree.

Default: true.

checkWinnersNoChecks only winners in the merge tree.

Default: true.

checkCrosswalksNoChecks winners and their crosswalks to ensure all contributors are in the tree.

Default: false.

Example

Here's a simple example of a check for two specific URIs, scanning winners, losers, and crosswalks: { "entitiesToCheck": ["URI1", "URI2"], "checkAll": true }
Note: When checkAll is true, the other check parameters are ignored.
Was this content helpful?