apache/iceberg · error · IllegalArgumentException

Unsupported view commit operation

Error message

Unsupported view commit operation: ${viewCommit}

What it means

commitView switches over the ViewCommit kind (CREATE, REPLACE, CREATE_OR_REPLACE); the default branch throws IllegalArgumentException for any unsupported commit operation value. This is an internal exhaustive-switch guard.

Solutions

1. Upgrade the Iceberg connector version — likely an internal bug
2. File an issue with the full stack trace
3. If on a fork, add the missing case to the switch in commitView

Example fix

// before
default: throw new IllegalArgumentException("Unsupported view commit operation: " + viewCommit);
// after
case NEW_OP -> createNewOp(viewIdentifier, builder); // add case when a new enum value exists

try { spark.sql("CREATE OR REPLACE VIEW " + ident); }
catch (IllegalArgumentException e) {
  if (e.getMessage().startsWith("Unsupported view commit operation")) { /* upgrade connector / file issue */ }
}

When it happens

Trigger: Internal dispatch reaching commitView with a ViewCommit value outside the known enum set — effectively an internal invariant violation, not normally caused by user input.

Common situations: Bug after adding a new ViewCommit enum constant without updating commitView; custom fork modification.

Understand the failure class

Background: "This is a bug, please report it": internal invariant violations, unreachable panics, and SNH errors explained — this error's family across 47 libraries.

Related errors

• Altering a view is not supported by catalog:
• Altering a view is not supported by catalog
• Altering a view is not supported by catalog
• Cannot create or replace table
• Cannot create view . that references temporary

AI-assisted analysis of apache/iceberg@86d9c8fc54 (2026-09-12). Data as JSON: /api/errors/40feaa91343ca049. Report an issue: GitHub.

Appendix: source

Thrown at spark/v4.2/spark/src/main/java/org/apache/iceberg/spark/SparkCatalog.java:667

      org.apache.iceberg.view.View icebergView;
      Set<String> replacedProperties = null;
      switch (viewCommit) {
        case CREATE:
          icebergView = builder.create();
          break;
        case REPLACE:
          replacedProperties = propertiesReplacedBySpark(viewIdentifier);
          icebergView = builder.replace();
          break;
        case CREATE_OR_REPLACE:
          Pair<Set<String>, org.apache.iceberg.view.View> replacement =
              createOrReplaceView(viewIdentifier, builder);
          replacedProperties = replacement.first();
          icebergView = replacement.second();
          break;
        default:
          throw new IllegalArgumentException("Unsupported view commit operation: " + viewCommit);
      }

      if (replacedProperties != null) {
        removeDroppedViewProperties(icebergView, replacedProperties, props.keySet());
      }

      return SparkView.toView(catalogName, icebergView);
    } catch (org.apache.iceberg.exceptions.NoSuchNamespaceException e) {
      throw new NoSuchNamespaceException(ident.namespace());
    } catch (AlreadyExistsException e) {
      if (viewCommit == ViewCommit.REPLACE && tableExists(ident)) {
        throw new NoSuchViewException(ident);
      } else if (viewCommit == ViewCommit.REPLACE) {
        // A table collision was handled above. Spark has no equivalent exception for other
        // Iceberg replacement conflicts, so preserve the original failure.
        throw e;
      }

View on GitHub (pinned to 86d9c8fc54)