Table of Contents

Class CdcIdempotencyCapacityExceededException

Namespace
Excalibur.Cdc.SqlServer
Assembly
Excalibur.Cdc.SqlServer.dll

Transient exception thrown by an in-memory CDC idempotency filter when its tracking store is at capacity and a not-yet-seen event cannot be evaluated without silently degrading deduplication.

public sealed class CdcIdempotencyCapacityExceededException : Exception, ISerializable
Inheritance
CdcIdempotencyCapacityExceededException
Implements
Inherited Members

Remarks

This is a fail-closed signal raised before the event handler runs: when the filter is saturated, a previously-unseen CDC event cannot be reliably deduplicated, so the filter throws rather than admit an un-trackable event (which would risk processing the same change twice on redelivery). The batch is not acknowledged and the event is redelivered once capacity is reclaimed. Treat it as transient and retry-able. Initializes a new instance of the CdcIdempotencyCapacityExceededException class.

Constructors

CdcIdempotencyCapacityExceededException()

Initializes a new instance of the CdcIdempotencyCapacityExceededException class.

public CdcIdempotencyCapacityExceededException()

CdcIdempotencyCapacityExceededException(int)

Initializes a new instance of the CdcIdempotencyCapacityExceededException class for the given capacity.

public CdcIdempotencyCapacityExceededException(int maxTrackedEvents)

Parameters

maxTrackedEvents int

The configured maximum number of tracked events that was reached.

CdcIdempotencyCapacityExceededException(string)

Transient exception thrown by an in-memory CDC idempotency filter when its tracking store is at capacity and a not-yet-seen event cannot be evaluated without silently degrading deduplication.

public CdcIdempotencyCapacityExceededException(string message)

Parameters

message string

The exception message.

Remarks

This is a fail-closed signal raised before the event handler runs: when the filter is saturated, a previously-unseen CDC event cannot be reliably deduplicated, so the filter throws rather than admit an un-trackable event (which would risk processing the same change twice on redelivery). The batch is not acknowledged and the event is redelivered once capacity is reclaimed. Treat it as transient and retry-able. Initializes a new instance of the CdcIdempotencyCapacityExceededException class.

CdcIdempotencyCapacityExceededException(string?, Exception?)

Initializes a new instance of the CdcIdempotencyCapacityExceededException class with a message and inner exception.

public CdcIdempotencyCapacityExceededException(string? message, Exception? innerException)

Parameters

message string

The exception message.

innerException Exception

The inner exception.

Remarks

The innerException parameter cannot be forwarded to the base Exception(string, Exception) constructor because the primary constructor locks the base call to Exception(message). This overload exists to satisfy the standard exception constructor pattern (CA1032).

Properties

MaxTrackedEvents

Gets the configured maximum number of tracked events that was reached, when known.

public int? MaxTrackedEvents { get; }

Property Value

int?

The configured capacity cap, or null when not specified.