apache/iceberg · error · RuntimeException

Failed to list all views under namespace

Error message

Failed to list all views under namespace ${namespace}

What it means

listViews() wraps a Thrift TException from the Hive Metastore in a RuntimeException with this message when listing views fails at the RPC/protocol level. It indicates a metastore communication or server-side failure rather than a missing namespace.

Solutions

1. Check metastore availability and connectivity (metastore URI, ping the service).
2. Inspect the chained cause (e.getCause()) for the concrete TException detail.
3. Align Hive/metastore client versions with the server's Thrift protocol.
4. Retry with backoff; transient metastore hiccups commonly produce this.

Example fix

// before
List<ViewIdentifier> views = catalog.listViews(ns);
// after
try {
  List<ViewIdentifier> views = catalog.listViews(ns);
} catch (RuntimeException e) {
  if (e.getCause() instanceof TException) {
    LOG.warn("Metastore RPC failed listing views in {}", ns, e);
    // retry or fail over
  }
}

// No local check can detect a metastore RPC failure in advance; verify connectivity out of band:
// metastore URI reachable, e.g. nc -z <host> <port>

try {
  views = catalog.listViews(ns);
} catch (RuntimeException e) {
  if (e.getCause() instanceof TException) {
    // retry with exponential backoff, bounded attempts
  }
  throw e;
}

When it happens

Trigger: Calling catalog.listViews(namespace) and the Hive Metastore throws a TException — e.g. metastore connection dropped, Thrift protocol mismatch, or metastore-side error while fetching table list filtered by ICEBERG_VIEW_TYPE_VALUE.

Common situations: Metastore is down or restarting; network partition/firewall between client and metastore; incompatible Hive client/library versions speaking different Thrift protocols; metastore timeout under load.

Related errors

• Failed to drop
• Failed to drop view
• Metastore operation failed for
• Cannot rename to . View already exists
• Failed to check table existence of

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

Appendix: source

Thrown at hive-metastore/src/main/java/org/apache/iceberg/hive/HiveCatalog.java:229

      String database = namespace.level(0);
      List<String> viewNames =
          clients.run(client -> client.getTables(database, "*", TableType.VIRTUAL_VIEW));

      // Retrieving the Table objects from HMS in batches to avoid OOM
      List<TableIdentifier> filteredTableIdentifiers = Lists.newArrayList();
      Iterable<List<String>> viewNameSets = Iterables.partition(viewNames, 100);

      for (List<String> viewNameSet : viewNameSets) {
        filteredTableIdentifiers.addAll(
            listIcebergTables(viewNameSet, namespace, HiveOperationsBase.ICEBERG_VIEW_TYPE_VALUE));
      }

      return filteredTableIdentifiers;
    } catch (UnknownDBException e) {
      throw new NoSuchNamespaceException("Namespace does not exist: %s", namespace);

    } catch (TException e) {
      throw new RuntimeException("Failed to list all views under namespace " + namespace, e);

    } catch (InterruptedException e) {
      Thread.currentThread().interrupt();
      throw new RuntimeException("Interrupted in call to listViews", e);
    }
  }

  @Override
  public String name() {
    return name;
  }

  @Override
  public boolean dropTable(TableIdentifier identifier, boolean purge) {
    if (!isValidIdentifier(identifier)) {
      return false;
    }

View on GitHub (pinned to 86d9c8fc54)