Enum AlterOperation 

pub enum AlterOperation {
    AddColumn(CreateColumnDef),
    DropColumn(String),
    RenameColumn {
        from: String,
        to: String,
    },
    AttachPartition {
        child: String,
        bound: String,
    },
    DetachPartition {
        child: String,
    },
    EnableRowLevelSecurity,
    DisableRowLevelSecurity,
    EnableTenancy {
        column: String,
    },
    DisableTenancy,
    SetAppendOnly(bool),
    SetVersioned(bool),
    EnableEvents(SubscriptionDescriptor),
    DisableEvents,
    AddSubscription {
        name: String,
        descriptor: SubscriptionDescriptor,
    },
    DropSubscription {
        name: String,
    },
    AddSigner {
        pubkey: [u8; 32],
    },
    RevokeSigner {
        pubkey: [u8; 32],
    },
    SetRetention {
        duration_ms: u64,
    },
    UnsetRetention,
}

Single ALTER TABLE operation

Variants

AddColumn(CreateColumnDef)

ADD COLUMN definition

DropColumn(String)

DROP COLUMN name

RenameColumn

RENAME COLUMN from TO to

Fields

from: String

to: String

AttachPartition

ATTACH PARTITION child FOR VALUES ... (Phase 2.2 PG parity).

Binds an existing child table to the parent partitioned table. The bound string captures the raw bound expression so the runtime can round-trip it back into red_config without a dedicated per-kind AST.

Fields

child: String

bound: String

Human-readable bound string, e.g. FROM (2024-01-01) TO (2025-01-01) or IN (1, 2, 3) or WITH (MODULUS 4, REMAINDER 0).

DetachPartition

DETACH PARTITION child

Fields

child: String

EnableRowLevelSecurity

ENABLE ROW LEVEL SECURITY (Phase 2.5 PG parity).

Flips the table into RLS-enforced mode. Reads against the table will be filtered by every matching CREATE POLICY (for the current role) combined with AND.

DisableRowLevelSecurity

DISABLE ROW LEVEL SECURITY — disables enforcement; policies remain defined but are ignored until re-enabled.

EnableTenancy

ENABLE TENANCY ON (col) (Phase 2.5.4 PG parity-ish).

Retrofit a tenant-scoped declaration onto an existing table — registers the column, installs the auto __tenant_iso RLS policy, and flips RLS on. Equivalent to re-running CREATE TABLE ... TENANT BY (col) minus the schema creation.

Fields

column: String

DisableTenancy

DISABLE TENANCY — tears down the auto-policy and clears the tenancy registration. User-defined policies on the table are untouched; RLS stays enabled if any survive.

SetAppendOnly(bool)

SET APPEND_ONLY = true|false — flips the catalog flag. Setting true rejects all future UPDATE/DELETE at parse-time guard; setting false re-enables them. Existing rows are untouched either way — this is a purely declarative switch.

SetVersioned(bool)

SET VERSIONED = true|false — opt the table into (or out of) Git-for-Data. Enables merge / diff / AS OF semantics against this collection. Works retroactively: previously-created rows become part of the history accessible via AS OF as long as their xmin is still pinned by an existing commit.

EnableEvents(SubscriptionDescriptor)

ENABLE EVENTS ... — install or re-enable table event subscription metadata.

DisableEvents

DISABLE EVENTS — mark all table event subscriptions disabled.

AddSubscription

ADD SUBSCRIPTION name TO queue [REDACT (...)] [WHERE ...] — add a named subscription.

Fields

name: String

descriptor: SubscriptionDescriptor

DropSubscription

DROP SUBSCRIPTION name — remove a named subscription by name.

Fields

name: String

AddSigner

Issue #522 — ALTER COLLECTION name ADD SIGNER 'hex_pubkey'. Appends the key to the per-collection signer registry and records an Add entry on the signer_history audit log.

Fields

pubkey: [u8; 32]

RevokeSigner

Issue #522 — ALTER COLLECTION name REVOKE SIGNER 'hex_pubkey'. Removes the key from the currently allowed set and records a Revoke entry. Past rows signed by pubkey remain readable and re-verifiable — only future inserts are rejected.

Fields

pubkey: [u8; 32]

SetRetention

Issue #580 — ALTER COLLECTION name SET RETENTION <duration>. Stores a declarative retention policy on the collection contract. Enforcement is lazy-on-scan: reads silently filter out rows older than now - duration_ms by the collection’s timestamp column.

Fields

duration_ms: u64

UnsetRetention

Issue #580 — ALTER COLLECTION name UNSET RETENTION. Removes the policy. Previously-hidden expired rows become readable again — the slice never physically dropped them.

Trait Implementations

impl Clone for AlterOperation

fn clone(&self) -> AlterOperation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AlterOperation

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

Formats the value using the given formatter.