Informix Error -737: The confidence value and the SAMPLING SIZE clause are not valid for the HIGH mode of the UPDATE STATISTICS statement.
Cause and resolution
The confidence value and the SAMPLING SIZE clause are not valid for the HIGH mode of the UPDATE STATISTICS statement.
Remove the confidence value and the SAMPLING SIZE clause from the statement.
For example, the following statement has a confidence value of 0.99:
UPDATE STATISTICS HIGH RESOLUTION 0.1 0.99;
The corrected statement is:
UPDATE STATISTICS HIGH RESOLUTION 0.1;
If you want a distribution that is based upon sampling rather than one that uses all of the data in a column, change the mode from HIGH to MEDIUM and you specify number of samples using the SAMPLING SIZE clause.
Oninit® Troubleshooting Guidance
Reasons / Common Causes
-737 fires when UPDATE STATISTICS HIGH includes a confidence value (a second numeric argument
to RESOLUTION) or a SAMPLING SIZE clause — per the official guidance's example, UPDATE STATISTICS HIGH RESOLUTION 0.1 0.99 supplies a confidence value (0.99) that HIGH mode
doesn't accept, since HIGH mode builds distributions from the complete data, not a sample, so
there's no sampling confidence to configure.
- A confidence value given as
RESOLUTION's second argument inHIGHmode, per the official guidance's example — confidence values are meaningful for sampling-based distributions, whichHIGHmode doesn't use. - A
SAMPLING SIZEclause included on anUPDATE STATISTICS HIGHstatement, per the official guidance —HIGHmode always uses the complete data, so there's no sample size to configure. - A statement copy-pasted from a
MEDIUM-mode template, with the mode changed toHIGHbut the sampling-related arguments left in place.
Solutions / Resolution
- Remove the confidence value from
RESOLUTION, per the official guidance's own example —UPDATE STATISTICS HIGH RESOLUTION 0.1 0.99becomesUPDATE STATISTICS HIGH RESOLUTION 0.1. - Remove the
SAMPLING SIZEclause entirely, per the official guidance, ifHIGHmode is genuinely what's needed. - Change the mode to
MEDIUMif a sampling-based distribution (with a confidence value and/or sample size) is actually what was wanted, per the official guidance.
Examples
The disallowed confidence value
UPDATE STATISTICS HIGH RESOLUTION 0.1 0.99 FOR TABLE orders;
-- -737: 0.99 is a confidence value, not valid in HIGH mode
Corrected — HIGH mode without a confidence value
UPDATE STATISTICS HIGH RESOLUTION 0.1 FOR TABLE orders;
Or corrected — switch to MEDIUM for sampling-based distributions
UPDATE STATISTICS MEDIUM RESOLUTION 0.1 SAMPLING SIZE 10000 FOR TABLE orders;
Diagnostic Checks
- Check whether
UPDATE STATISTICS HIGHincludes aRESOLUTIONconfidence value (a second number) or aSAMPLING SIZEclause, and remove either or switch the mode toMEDIUM.
Related Errors / Related Topics
- -736 — "The RESOLUTION and SAMPLING SIZE clauses are not valid for the LOW mode of the
UPDATE STATISTICS statement." A related mode/clause-compatibility restriction, for
LOWmode. - -738 — "DROP DISTRIBUTIONS is only valid in LOW mode." A related
UPDATE STATISTICSmode-compatibility restriction, on a different clause.
HIGH mode uses the complete data, not a sample — remove any confidence value or SAMPLING SIZE clause, or switch to MEDIUM if sampling was actually intended.