Table of Contents

Namespace Excalibur.Cdc.SqlServer

Classes

ByteArrayComparer

Compares byte arrays lexicographically (byte-by-byte). Used for ordering LSN values.

ByteArrayEqualityComparer

Compares byte arrays for equality and provides a consistent hash code implementation. Intended for dictionary key comparisons where byte arrays represent LSNs or sequence values.

CdcBuilderSqlServerExtensions

Extension methods for configuring SQL Server CDC provider on ICdcBuilder.

CdcHealthCheckOptions

SQL Server-specific configuration options for the CDC processor health check. Inherits general CDC health check thresholds from CdcHealthCheckOptions.

CdcHealthState

Thread-safe state tracker for CDC processor health monitoring.

CdcIdempotencyCapacityExceededException

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.

CdcMissingTableHandlerException

Exception thrown when no implementation of IDataChangeHandler is found for a specified table.

CdcMultipleTableHandlerException

Exception thrown when multiple implementations of IDataChangeHandler are found for a specified table.

CdcPosition

Represents the current position in the CDC log for a specific table, defined by a Log Sequence Number (LSN) and an optional sequence value.

CdcProcessingState

Represents the state of CDC (Change Data Capture) processing, including the last processed log sequence number (LSN), sequence value, and other metadata.

CdcProcessor

Processes Change Data Capture (CDC) changes by reading from a database, managing state, and invoking a specified event handler.

CdcRecoveryOptions

Configuration options for CDC stale position recovery behavior.

CdcRecoveryOptionsDefaults

Provides default values for CDC recovery options.

CdcRepository

Provides methods for interacting with SQL Server Change Data Capture (CDC) tables.

CdcRow

Represents a Change Data Capture (CDC) row retrieved from SQL Server.

CdcStalePositionDetector

Detects and classifies stale CDC position errors from SQL Server exceptions.

CdcStateStore

Provides methods to manage the CDC (Change Data Capture) processing state in a database.

DataChange

Represents a change to a specific column in a database row, capturing the old and new values.

DataChangeEvent

Represents a data change event in a database table, including details about the change type, affected table, and data changes.

DataChangeEventProcessor

Processes CDC (Change Data Capture) events and delegates handling to registered data change handlers.

DataChangeEventProcessorFactory

Factory class for creating instances of DataChangeEventProcessor.

DataChangeExtensions

Extension methods for retrieving typed values from data changes in CDC (Change Data Capture) events.

DataChangeTypeExtensions

Extension methods for converting between DataChangeType and CdcChangeType.

DatabaseOptions

Represents the configuration settings required for CDC (Change Data Capture) processing.

DatabaseOptionsDefaults

Provides default configuration values for database change data capture (CDC) operations.

LsnExtensions

Extension methods for working with SQL Server Change Data Capture LSN (Log Sequence Number) values.

MinHeapComparer

Compares tuples of LSN and table name for sorting in a min-heap. Orders by ascending LSN; if equal, orders lexically by table name.

SqlServerCdcConnectionBuilderExtensions

Extension methods for ISqlServerCdcConnectionBuilder.

SqlServerCdcConnectionOptions

Connection-identity options for the SQL Server CDC processor.

SqlServerCdcIdempotencyFilterOptions

Configuration options for the SQL Server CDC idempotency filter.

SqlServerCdcOptions

Configuration options for SQL Server CDC processor.

SqlServerCdcStalePositionException

Exception thrown when the SQL Server CDC processor encounters a stale LSN position that cannot be recovered.

SqlServerCdcStateStoreOptions

Configuration options for SQL Server CDC state storage.

StalePositionReasonCodes

Provides standardized reason codes for CDC stale position scenarios.

UnmatchedUpdateRecordsException

Exception thrown when unmatched UpdateBefore/UpdateAfter record pairs are detected during CDC (Change Data Capture) processing.

Interfaces

ICdcRepository

Defines the core contract for retrieving Change Data Capture (CDC) data from SQL Server.

ICdcRepositoryLsnMapping

Provides LSN-to-time mapping and advanced LSN navigation for SQL Server CDC.

IDataChangeEventProcessor

Defines the interface for processing Change Data Capture (CDC) events into data change events.

IDataChangeEventProcessorFactory

Factory interface for creating instances of IDataChangeEventProcessor with specified configuration and database connections.

IDataChangeHandler

Defines a handler for processing data change events for specific database tables.

IDatabaseOptions

Represents the configuration settings for a database used in Change Data Capture (CDC) processing.

ISqlServerCdcBuilder

Fluent builder interface for configuring SQL Server CDC settings.

ISqlServerCdcConnectionBuilder

Defines the contract for configuring SQL Server CDC source and state store connections.

ISqlServerCdcDatabaseBuilder

Defines the contract for configuring SQL Server CDC database-specific options including database naming, connection identifiers, capture instances, and missing handler behavior.

ISqlServerCdcProcessingBuilder

Defines the contract for configuring SQL Server CDC processing options including schema, table naming, polling behavior, batch sizing, and command timeout.

ISqlServerCdcProcessor

Defines the contract for a SQL Server Change Data Capture (CDC) processor.

ISqlServerCdcStateStore

Defines the contract for managing the state of Change Data Capture (CDC) processing.

Enums

CdcOperationCodes

Enumeration representing the types of Change Data Capture (CDC) operations.

DataChangeType

Represents the type of data change captured during Change Data Capture (CDC) processing.