Enum CopyOptionValue 

pub enum CopyOptionValue {
    Word {
        word: Ident,
        meta: Meta,
    },
    String {
        value: Literal,
        meta: Meta,
    },
    Number {
        value: Literal,
        meta: Meta,
    },
    Star {
        meta: Meta,
    },
    List {
        values: ThinVec<CopyOptionValue>,
        meta: Meta,
    },
    Force {
        kind: ForceKind,
        columns: ThinVec<Ident>,
        meta: Meta,
    },
    OptionList {
        options: ThinVec<CopyOption>,
        meta: Meta,
    },
}

The argument shapes a CopyOption can carry — the extensible axis of the COPY option machinery.

Mirrors PostgreSQL’s copy_generic_opt_arg alternatives (opt_boolean_or_string, NumericOnly, '*', and '(' copy_generic_opt_arg_list ')'), which pg_query accepts under the plain copy gate, plus the legacy Force compound. DuckDB’s and the Snowflake-adjacent parity target’s format/option values are a subset of these same shapes, so no widening feature flag is needed. This enum is the pre-staged extension point for the COPY INTO sibling: a keyed nested option list (Snowflake FILE_FORMAT = (TYPE = CSV …)) becomes an additive variant here (a ThinVec<CopyOption> payload), riding the same CopyOption/CopyStatement machinery rather than reshaping it.

Variants

Word

A bareword argument kept as its source word (FORMAT csv, HEADER true, DuckDB FORMAT PARQUET). PostgreSQL opt_boolean_or_string.

Fields

word: Ident

Identifier-form value.

meta: Meta

Source location and node identity.

String

A string argument (DELIMITER ',', NULL '', DuckDB COMPRESSION 'zstd').

Fields

value: Literal

Value supplied by this syntax.

meta: Meta

Source location and node identity.

Number

A numeric argument (HEADER 1, DuckDB ROW_GROUP_SIZE 100000), including a sign-folded negative (-1) or decimal (1.5). PostgreSQL NumericOnly; the sign is folded into the literal’s span so it round-trips whole.

Fields

value: Literal

Value supplied by this syntax.

meta: Meta

Source location and node identity.

Star

The bare * argument of a generic parenthesized option (FORCE_QUOTE *). PostgreSQL '*'; distinct from the legacy Force all-columns form, which spells * as an empty column list.

Fields

meta: Meta

Source location and node identity.

List

A parenthesized argument list (FORCE_QUOTE (a, b), DuckDB PARTITION_BY (y, m)). PostgreSQL '(' copy_generic_opt_arg_list ')'. The parser only ever emits Word/String/Number list items (PostgreSQL’s list items are opt_boolean_or_string; DuckDB adds numerics); the recursive type keeps one axis rather than a parallel item enum.

Fields

values: ThinVec<CopyOptionValue>

Values in source order.

meta: Meta

Source location and node identity.

Force

The {QUOTE | NULL | NOT NULL} {<column-list> | *} payload of a legacy FORCE option (PostgreSQL copy_opt_item), whose compound keyword the generic <name> [<value>] shape cannot carry: the name is the leading FORCE word and this value holds the sub-keyword (which kind distinguishes) and its target. An empty columns list is the * (all-columns) form (PostgreSQL A_Star) — unambiguous because PostgreSQL’s columnList is never empty.

Fields

kind: ForceKind

Whether the force applies to all columns or a named list; see ForceKind.

columns: ThinVec<Ident>

Columns in source order.

meta: Meta

Source location and node identity.

OptionList

A keyed nested option list — the space-separated <key> = <value> pairs inside a Snowflake FILE_FORMAT = (TYPE = CSV FIELD_DELIMITER = ',') (or a FORMAT_NAME = '...') argument. Each element is a CopyOption, so the nested option vocabulary rides the same machinery as the outer list rather than a parallel node — the additive extension point ADR-0011 pre-staged on this enum. Distinct from List, whose elements are bare comma-separated values (FORCE_QUOTE (a, b)): an OptionList element is a key = value pair and the elements are space-separated. Only CopyIntoStatement emits this (via its = (...) option grammar); PostgreSQL/DuckDB COPY never does.

Fields

options: ThinVec<CopyOption>

Options supplied in source order.

meta: Meta

Source location and node identity.

Trait Implementations

impl Clone for CopyOptionValue

fn clone(&self) -> CopyOptionValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CopyOptionValue

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CopyOptionValue

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CopyOptionValue

impl Hash for CopyOptionValue

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CopyOptionValue

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

Equality operator ==.

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

Inequality operator !=.

impl Render for CopyOptionValue

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

Return the render for this value.

fn operand_binding_power(&self) -> Option<BindingPower>

The binding power this node contributes when it appears as an operand, or None (the default) for a self-delimiting node — an atom, call, or constructor — that never needs parentheses.

impl Serialize for CopyOptionValue

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Spanned for CopyOptionValue

fn span(&self) -> Span

Return the span for this value.

impl StructuralPartialEq for CopyOptionValue