Namespace Excalibur.Cdc
Classes
- CdcBuilderDiscoveryExtensions
Extension methods that bridge ICdcBuilder to ICdcBuilderDiscovery for table discovery features.
- CdcDataChange
Represents a change to a specific column in a database row, capturing the old and new values.
- CdcDataChangeExtensions
Extension methods for extracting typed values from CDC change data.
- CdcFatalClassifier
Decides whether a CDC processing fault requires the loop to stop for review or permits recovery by the existing backoff-reconnect policy. Stopped faults never advance the checkpoint.
- CdcFatalErrorOptions<TEvent>
Options for configuring fatal-error handling during CDC processing for a provider whose change events are of type
TEvent.
- CdcFatalGuard
The single, shared, pure decision point for a CDC consume loop's checkpoint-advance / stop behavior on every iteration. Every provider's
StartAsyncloop routes its fatal-vs-transient decision through Decide(Exception?, IMessageFailureClassifier?).
- CdcLeadershipSupersededException
Thrown when a CDC checkpoint write is rejected because the writing instance presented a fencing token that has been superseded by a newer leadership tenure — i.e. this instance believes it is the leader but was demoted (a split-brain). The checkpoint's non-decreasing compare-and-swap left the stored LSN unchanged, so no position was regressed or skipped; this exception signals the superseded instance to stop advancing.
- CdcMappingException
The exception that is thrown when a CDC event mapping operation fails.
- CdcOptions
Configuration options for CDC processing.
- CdcPositionResetEventArgs
Provides data for a CDC position reset event when a stale position is detected.
- CdcReasonCodes
Provides standardized reason codes for CDC stale position scenarios across all providers.
- CdcRetryExhaustedException
The exception a CDC processor stops with when a failure it treated as transient did not clear within the configured number of consecutive attempts.
- CdcStalePositionException
Base exception for all CDC stale position scenarios across providers.
- CdcTableConfig
Bindable configuration for a single CDC-tracked table.
- CdcTableTrackingOptions
Configuration options for tracking a specific table, including event mappings and filters.
Structs
- CdcFatalDecision
The decision a CDC processor's consume loop must act on after each iteration: whether it may advance its durable checkpoint and whether it must stop.
Interfaces
- ICdcBuilder
Fluent builder interface for configuring Excalibur CDC processor.
- ICdcBuilderDiscovery
Provides table discovery and configuration-binding capabilities for the CDC builder.
- ICdcEventMapper<TEvent>
Maps CDC column data to a typed event instance.
- ICdcProcessor<TEvent>
Base contract for CDC processors that support batch (poll-based) processing. All CDC providers implement this interface.
- ICdcRecoveryBuilder
Fluent builder interface for configuring CDC recovery settings.
- ICdcRelationalStateStoreBuilder
Extends ICdcStateStoreBuilder with relational-specific settings (schema name, connection string) for SQL Server and Postgres CDC state stores.
- ICdcStateStoreBuilder
Configures CDC state store persistence settings shared by all providers (table name, configuration binding).
- ICdcStreamProcessor<TEvent, TPosition>
Extended contract for CDC processors that support continuous streaming with position tracking.
- ICdcTableBuilder
Fluent builder interface for configuring CDC table tracking settings.
- ICdcTableProvider
Provider-agnostic interface for types that declare which database tables they handle. Implementations registered in DI are discovered by TrackTablesFromHandlers() at startup.
Enums
- CdcChangeType
Specifies the type of change captured by CDC.
- StalePositionRecoveryStrategy
Specifies the recovery strategy to use when the saved CDC position is no longer valid.
Delegates
- CdcFatalErrorHandler<TEvent>
Handles a fatal error that occurs during CDC processing for a provider whose change events are of type
TEvent.
- CdcPositionResetHandler
Represents a handler for CDC position reset events.