apache/beam · error · UnsupportedOperationException

ReadOnlyCatalogManager does not support catalog creation

Error message

ReadOnlyCatalogManager does not support catalog creation

What it means

EmptyCatalogManager.createCatalog always throws UnsupportedOperationException: as a read-only placeholder it cannot create catalogs, no matter what name, type, or properties are passed. It is a sentinel guarding all DDL on the empty catalog manager.

Solutions

1. Switch to a writable CatalogManager implementation (e.g. InMemoryCatalogManager) before issuing CREATE CATALOG.
2. Drop the CREATE CATALOG statement when running against the empty/read-only manager.

When it happens

Trigger: Thrown at sdks/java/extensions/sql/src/main/java/org/apache/beam/sdk/extensions/sql/meta/catalog/EmptyCatalogManager.java:66 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/beam@12126d8942 (2026-09-13). Data as JSON: /api/errors/7ab5ed226bdb60eb. Report an issue: GitHub.

Appendix: source

Thrown at sdks/java/extensions/sql/src/main/java/org/apache/beam/sdk/extensions/sql/meta/catalog/EmptyCatalogManager.java:66

  public void dropCatalog(String name) {
    throw new UnsupportedOperationException(
        "ReadOnlyCatalogManager does not support removing a catalog");
  }

  @Override
  public void registerTableProvider(TableProvider tableProvider) {
    throw new UnsupportedOperationException(
        "ReadOnlyCatalogManager does not support registering a table provider");
  }

  @Override
  public Map<String, TableProvider> tableProviders() {
    return EMPTY.tableProviders;
  }

  @Override
  public void createCatalog(String name, String type, Map<String, String> properties) {
    throw new UnsupportedOperationException(
        "ReadOnlyCatalogManager does not support catalog creation");
  }

  @Override
  public Collection<Catalog> catalogs() {
    return ImmutableSet.of(EMPTY);
  }
}

View on GitHub (pinned to 12126d8942)