Table of Contents

Class CdcOptions

Namespace
Excalibur.Cdc
Assembly
Excalibur.Cdc.dll

Configuration options for CDC processing.

public sealed class CdcOptions
Inheritance
CdcOptions
Inherited Members

Properties

DefaultSchema

Gets or sets the default schema for table name inference in TrackTable<TEntity>().

public string DefaultSchema { get; set; }

Property Value

string

The default schema name. Default is "dbo".

EnableBackgroundProcessing

Gets or sets a value indicating whether background processing is enabled.

public bool EnableBackgroundProcessing { get; set; }

Property Value

bool

true if background processing is enabled; otherwise, false. Default is false.

EnableStructuredLogging

Gets or sets a value indicating whether to log structured events for position resets.

public bool EnableStructuredLogging { get; set; }

Property Value

bool

true to enable structured logging; otherwise, false. Default is true.

MaxRecoveryAttempts

Gets or sets the maximum number of recovery attempts before giving up.

[Range(0, 2147483647)]
public int MaxRecoveryAttempts { get; set; }

Property Value

int

The maximum retry count. Default is 3.

OnPositionReset

Gets or sets the callback invoked when a stale position reset occurs.

public CdcPositionResetHandler? OnPositionReset { get; set; }

Property Value

CdcPositionResetHandler

RecoveryAttemptDelay

Gets or sets the delay between recovery attempts.

public TimeSpan RecoveryAttemptDelay { get; set; }

Property Value

TimeSpan

The delay between attempts. Default is 1 second.

RecoveryStrategy

Gets or sets the recovery strategy for stale positions.

public StalePositionRecoveryStrategy RecoveryStrategy { get; set; }

Property Value

StalePositionRecoveryStrategy

The recovery strategy. Default is FallbackToEarliest.

TrackedTables

Gets the table tracking configurations.

public List<CdcTableTrackingOptions> TrackedTables { get; }

Property Value

List<CdcTableTrackingOptions>

Methods

Validate()

Validates the options and throws if the configuration is invalid.

public void Validate()

Exceptions

InvalidOperationException

Thrown when configuration is invalid.