Styxis
Company
Knowledge

Check that an Iceberg UUID composite delete is attached to scan tasks

A committed delete file can exist without reaching the reader's applicable scan plan.

Existence is only the first stage

A delete file's existence and its inclusion in the reader's application plan are separate states. Truthound can compare file inventory with scan-task references, but that does not establish correct key comparison during reading. [1, 2, 3]

The reported composite-UUID omission

The public Iceberg report describes an equality delete keyed by UUID and integer being attached to no FileScanTask, so it removes no rows. A single UUID key and integer–string composite keys are controls. This is a scan-applicability problem, not a claim about UUID standard formatting. [1]

Define which files should apply

Compare expected delete-file applicability with actual task references for each composite-key type. Isolate omissions at planning time before evaluating reader results. If an illustrative scope requires 1 delete file, an actual attachment count of 1 passes the reference condition and 0 fails. The rule does not attach every delete to every task; applicability needs an independent basis. [1, 3]

Truthound references and the subsequent read

Truthound Core's ReferentialIntegrityValidator can verify that an expected delete_file_id exists in an extracted scan-task relation. Afterwards, read and compare both targets and survivors. Truthound does not change UUID-bound comparison or the scan planner. Any alternative key representation requires separate checks that business meaning and existing references remain intact. [1, 2, 3]

Application conditions

Independently establish delete_file_id values applicable to the approved scope, linking them to scan_task_id relations from the same scan.

Alternatives

If choosing another supported key representation, validate semantic equivalence separately.

Limitations

  • A file reference does not prove correct key comparison. Truthound does not change UUID-bound comparison in the Iceberg scan planner.

Evidence

Event checked
Subject checked
Modified