apache/flink · error · UnsupportedOperationException

Unsupported hive version for orc shim

Error message

Unsupported hive version for orc shim: {}

What it means

Fires when createShim receives a Hive version string that matches none of the supported prefixes (2.0.x through 2.3.x and the 1.x branch handled above). No ORC shim implementation exists for that Hive release, so the reader/writer cannot be constructed with this dependency set.

Solutions

  1. Address the cause reported by the error message: Unsupported hive version for orc shim: the reported value
  2. Verify the inputs, configuration values, and classpath/dependency setup related to this operation, then retry.

Example fix

Correct the condition described ("Unsupported hive version for orc shim: the reported value") and rerun the job or command.
Defensive patterns

Strategy: validation

When it happens

Trigger: Triggered at runtime when the operation fails because: Unsupported hive version for orc shim: the reported value.

Common situations: Commonly caused by misconfiguration, missing dependencies or files, unsupported types or operations, or invalid user input leading to: Unsupported hive version for orc shim: the reported value.


AI-assisted analysis of apache/flink@2f3c205e92 (2026-08-14). Data as JSON: /api/errors/7ab5dbf5f2bd4d78. Report an issue: GitHub.

Appendix: source

Thrown at flink-formats/flink-orc/src/main/java/org/apache/flink/orc/shim/OrcShim.java:68

    boolean nextBatch(RecordReader reader, BATCH rowBatch) throws IOException;

    /** Default with orc dependent, we should use v2.3.0. */
    static OrcShim<VectorizedRowBatch> defaultShim() {
        return new OrcShimV230();
    }

    /** Create shim from hive version. */
    static OrcShim<VectorizedRowBatch> createShim(String hiveVersion) {
        if (hiveVersion.startsWith("2.0")) {
            return new OrcShimV200();
        } else if (hiveVersion.startsWith("2.1")) {
            return new OrcShimV210();
        } else if (hiveVersion.startsWith("2.2")
                || hiveVersion.startsWith("2.3")
                || hiveVersion.startsWith("3.")) {
            return new OrcShimV230();
        } else {
            throw new UnsupportedOperationException(
                    "Unsupported hive version for orc shim: " + hiveVersion);
        }
    }
}

View on GitHub (pinned to 2f3c205e92)