Package com.apple.foundationdb.async.guardiann

Class ClusterCapacityExceededException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.apple.foundationdb.util.LoggableException

com.apple.foundationdb.async.guardiann.ClusterCapacityExceededException

All Implemented Interfaces:

LoggableKeysAndValues<LoggableException>, Serializable

public class ClusterCapacityExceededException
extends LoggableException

Thrown by an insert when a primary cluster reaches its configured hard cap (primaryClusterHardMax) while the write path is not draining deferred maintenance tasks in the writing transaction. It signals back-pressure: inserts have outrun the deferred split backlog, so the caller should slow down until the background merge catches up rather than letting the cluster grow without bound.

This lives in the extensions layer (which cannot reference the record layer's RecordCoreException); the vector index engine translates it into a record-layer exception for callers.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
ClusterCapacityExceededException(UUID clusterId, int numPrimaryVectors, int primaryClusterHardMax)

Method Summary

Methods inherited from class com.apple.foundationdb.util.LoggableException

addLogInfo, addLogInfo, exportLogInfo, getLogInfo

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

ClusterCapacityExceededException

public ClusterCapacityExceededException(@Nonnull
 UUID clusterId,
 int numPrimaryVectors,
 int primaryClusterHardMax)