Table of Contents

Class DynamoDbCdcOptions

Namespace
Excalibur.Cdc.DynamoDb
Assembly
Excalibur.Cdc.DynamoDb.dll

Configuration options for DynamoDB CDC processor.

public sealed class DynamoDbCdcOptions
Inheritance
DynamoDbCdcOptions
Inherited Members

Properties

AutoDiscoverShards

Gets or sets a value indicating whether to auto-discover new shards.

public bool AutoDiscoverShards { get; set; }

Property Value

bool

Remarks

When enabled, the processor periodically checks for new shards created by resharding.

MaxBatchSize

Gets or sets the maximum number of records per batch.

[Range(1, 1000)]
public int MaxBatchSize { get; set; }

Property Value

int

Remarks

DynamoDB Streams supports up to 1000 records per GetRecords call.

MaxWaitTime

Gets or sets the maximum time to wait for records before returning an empty batch.

public TimeSpan MaxWaitTime { get; set; }

Property Value

TimeSpan

PollInterval

Gets or sets the interval between stream polls when no changes are available.

public TimeSpan PollInterval { get; set; }

Property Value

TimeSpan

Remarks

DynamoDB Streams supports up to 5 GetRecords calls per second per shard.

ProcessorName

Gets or sets the unique processor name for position tracking.

[Required]
public string ProcessorName { get; set; }

Property Value

string

ShardDiscoveryInterval

Gets or sets the interval for shard discovery.

public TimeSpan ShardDiscoveryInterval { get; set; }

Property Value

TimeSpan

StartPosition

Gets or sets the starting position for stream processing.

public DynamoDbCdcPosition? StartPosition { get; set; }

Property Value

DynamoDbCdcPosition

Remarks

If null, uses the last confirmed position from the state store, or starts from TRIM_HORIZON if no position is found.

StreamArn

Gets or sets the stream ARN.

public string? StreamArn { get; set; }

Property Value

string

Remarks

If not specified, the stream ARN is auto-discovered from the table.

StreamViewType

Gets or sets the expected stream view type.

public DynamoDbStreamViewType StreamViewType { get; set; }

Property Value

DynamoDbStreamViewType

Remarks

This is informational; the actual view type is determined by table configuration. Set this to match your table's StreamSpecification.StreamViewType.

TableName

Gets or sets the DynamoDB table name.

public string TableName { get; set; }

Property Value

string

Methods

Validate()

Validates the options.

public void Validate()

Exceptions

InvalidOperationException

Thrown if the options are invalid.