Enum BulkMode 

pub enum BulkMode {
    Off,
    Auto,
    On,
}

Whether copy_rows should route INSERT batches through the backend’s native bulk loader.

The default is Off so v1 behaviour is identical to the Phase 1 generic-INSERT path. Flipping to Auto is tracked as a separate follow-up.

Variants

Off

Never use the bulk path. Every batch goes through the generic INSERT INTO ... VALUES (..), (..) (or backend equivalent).

Auto

Try the bulk path; on SqlError::BulkUnavailable emit one stderr warning and fall back to the generic path for the current batch. Any other error surfaces immediately — degrading on, e.g., a FK violation would risk double-inserts.

On

Require the bulk path. If a backend returns SqlError::BulkUnavailable, copy_rows fails with a usage-style error instead of falling back.

Implementations

impl BulkMode

pub fn parse(s: &str) -> Option<Self>

Parse a mode name (case-insensitive). Recognised: off, auto, on.

Trait Implementations

impl Clone for BulkMode

fn clone(&self) -> BulkMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BulkMode

impl Debug for BulkMode

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

Formats the value using the given formatter.

impl Default for BulkMode

fn default() -> BulkMode

Returns the “default value” for a type.

impl Eq for BulkMode

impl PartialEq for BulkMode

fn eq(&self, other: &BulkMode) -> 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 BulkMode