Enum Dialect 

#[non_exhaustive]
pub enum Dialect {
    Postgres,
    MySql,
    Sqlite,
}

SQL dialect differences absorbed by the backend stores.

A Dialect knows how to render the four statements the outbox needs (poll, mark-delivered, mark-failed, insert) and the canonical schema DDL for its engine, accounting for placeholder style, row locking, the “current instant” expression and per-engine column types.

Marked #[non_exhaustive] so a future SQL backend can be added in a minor version: downstream match arms must include a wildcard _ arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Postgres

PostgreSQL (sqlx::Postgres).

MySql

MySQL 8.0+ (sqlx::MySql).

Sqlite

SQLite (sqlx::Sqlite).

Implementations

impl Dialect

pub fn supports_skip_locked(self) -> bool

Whether competing-consumers row skip-locking is available.

true for PostgreSQL and MySQL 8.0+, false for SQLite (which serializes writes through a single writer instead).

pub fn schema_ddl(self, table: &str) -> Result<String, OutboxError>

Canonical schema DDL (table + indexes) rendered for this dialect.

Errors

Returns OutboxError::Internal if table is not a valid identifier matching ^[a-zA-Z_][a-zA-Z0-9_]*$ or exceeds [crate::validate::MAX_IDENTIFIER_LEN] bytes.

pub fn dead_letter_schema_ddl(self, table: &str) -> Result<String, OutboxError>

Dead-letter schema DDL (table + indexes) rendered for this dialect.

Creates a table named {table}_dead_letter. Envelopes are moved here when they exhaust max_attempts.

Errors

Returns OutboxError::Internal if table is not a valid identifier matching ^[a-zA-Z_][a-zA-Z0-9_]*$ or exceeds [crate::validate::MAX_IDENTIFIER_LEN] bytes.

Trait Implementations

impl Clone for Dialect

fn clone(&self) -> Dialect

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Dialect

impl Debug for Dialect

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Dialect

impl PartialEq for Dialect

fn eq(&self, other: &Dialect) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Dialect