Error: F_JT0492 Multiple Describe Tags Have Differing Column Names
Issue
During the Integrate process, the job fails with the following error:
F_JT0492: Multiple describe tags for table '<table>' have differing column names.
Environment
- HVR 6
- Target: All supported relational databases and messaging platforms
Resolution
To resolve this issue, reduce the CycleByteLimit parameter to process router files in smaller batches. This allows HVR to process files containing different table structures in separate integrate cycles.
- In the HVR UI or CLI, locate the CycleByteLimit parameter for the target location.
- Set CycleByteLimit to
1000000(1 MB). - Activate the channel for the target location with the Jobs option selected.
- Allow the integrate job to run.
- If the error persists, set CycleByteLimit to
100000(100 KB), reactivate the channel, and allow the job to run again. - If the error still persists, set CycleByteLimit to
1, reactivate the channel, and allow the job to run again. - After the integrate job processes the backlog beyond the schema change, remove the custom CycleByteLimit setting or restore the default value of
100000000(100 MB). - Activate the channel with the Jobs option selected to resume standard batch processing.
Setting CycleByteLimit to 1 forces HVR to process router files individually and significantly reduces integrate performance. Use this value only if the higher limits don't resolve the error.
Alternative resolution
Alternatively, use hvrcontrol to skip the affected table:
hvrcontrol -l <location name> -s -t <table name> -x0 <hubname> <channel name>
Skipping transactions can cause the target table to become desynchronized. Use this option only if data loss for the affected batch is acceptable or you plan to refresh the table.
Cause
This issue occurs when HVR processes router files containing different versions of a table structure in the same integrate cycle. This can happen after a DDL schema change or table re-enrollment. The integrate job can't reconcile the conflicting column definitions.