Table of Contents

Class PostgresOutboxStoreOptions

Namespace
Excalibur.Outbox.Postgres
Assembly
Excalibur.Outbox.Postgres.dll

Configuration options for Postgres-based outbox message storage.

public sealed class PostgresOutboxStoreOptions : OutboxDeliveryOptions
Inheritance
PostgresOutboxStoreOptions
Inherited Members
Extension Methods

Properties

DeadLetterTableName

Gets or sets the name of the database table used for storing failed outbox messages.

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

Property Value

string

The table name for dead letter outbox messages. Defaults to "outbox_dead_letters".

FailureBackoffFloorSeconds

Gets or sets the failure-backoff floor F, in seconds: after MarkFailedAsync records a sub-ceiling failure, the message is not re-claimable by the drain until F has elapsed. This bounds the retry cadence of the plain (no fine-grained backoff) path so it cannot hot-loop the drain, while the message remains eventually re-claimable (at-least-once). F is a DEDICATED backoff floor, decoupled from ReservationTimeout (the reservation window), and MUST exceed the outbox polling interval (default 5 s) — the default satisfies that for the default polling interval.

[Range(1, 2147483647)]
public int FailureBackoffFloorSeconds { get; set; }

Property Value

int

The failure-backoff floor in seconds. Defaults to 30 (uniform across the outbox family).

FenceTableName

Gets or sets the name of the table that holds the leadership-fencing high-water mark.

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

Property Value

string

The fence control-table name. Defaults to "outbox_fence". This dedicated single-row-per-scope control table stores the fencing high-water mark durably, independent of the outbox rows themselves, so the high-water survives the delete-on-sent drain (unlike a live-row MAX(fencing_token), which would reset once the winning rows are deleted).

OutboxTableName

Gets or sets the name of the database table used for storing outbox messages.

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

Property Value

string

The table name for outbox messages. Defaults to "outbox".

QualifiedDeadLetterTableName

Gets the fully qualified name for the dead letter table.

public string QualifiedDeadLetterTableName { get; }

Property Value

string

The qualified table name in format "schema"."table".

QualifiedFenceTableName

Gets the fully qualified name for the fence control table.

public string QualifiedFenceTableName { get; }

Property Value

string

The qualified table name in format "schema"."table".

QualifiedOutboxTableName

Gets the fully qualified name for the outbox table.

public string QualifiedOutboxTableName { get; }

Property Value

string

The qualified table name in format "schema"."table".

ReservationTimeout

Gets or sets the timeout duration (in seconds) for message reservation operations.

[Range(1, 2147483647)]
public int ReservationTimeout { get; set; }

Property Value

int

The reservation timeout in seconds for outbox message processing. Defaults to 300 (5 minutes).

SchemaName

Gets or sets the schema name for outbox tables.

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

Property Value

string

The schema name. Defaults to "public".