Struct Capabilities 

#[non_exhaustive]
pub struct Capabilities {
    pub transactions: bool,
    pub cancellation: bool,
    pub multiple_schemas: bool,
    pub prepared_statements: bool,
    pub savepoints: bool,
    pub rows_affected: bool,
    pub streaming: bool,
    pub row_level_dml: bool,
}

Static description of features a driver supports.

The UI inspects Capabilities to enable or disable commands without hard-coding driver names. New flags are added by extending this struct; existing drivers default to false for unknown features.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

transactions: bool

Driver supports explicit transactions (BEGIN/COMMIT/ROLLBACK).

cancellation: bool

Driver can request asynchronous cancellation of an in-flight query.

multiple_schemas: bool

Driver exposes more than one logical schema/namespace.

prepared_statements: bool

Driver supports server-side prepared statements with parameter binding.

savepoints: bool

Driver supports nested transactions via savepoints.

rows_affected: bool

Driver can report row counts for UPDATE/DELETE statements.

streaming: bool

Driver returns rows progressively from crate::Connection::stream — i.e. the stream yields rows as the server produces them, without materialising the entire result set in memory first.

Drivers that currently buffer the full result before exposing the stream (notably MySQL, which is awaiting a real stream_and_drop implementation) must leave this false so the UI can warn the user and refuse to launch open-ended streams over large tables.

row_level_dml: bool

Driver supports row-level DML through the standard INSERT/UPDATE/DELETE grammar that crate::Connection::execute accepts.

Most engines do; the notable exception is ClickHouse, where row-level changes have to go through ALTER TABLE ... UPDATE or ALTER TABLE ... DELETE async mutations. The pending-changes pipeline gates o/O/d/cell-edit on this flag so it never emits a statement the driver cannot consume. Defaults to false; drivers opt in explicitly via Self::with_row_level_dml.

Implementations

impl Capabilities

pub const fn with_transactions(self, value: bool) -> Self

Builder-style mutation used by drivers to assemble their capability set.

pub const fn with_cancellation(self, value: bool) -> Self

pub const fn with_multiple_schemas(self, value: bool) -> Self

pub const fn with_prepared_statements(self, value: bool) -> Self

pub const fn with_savepoints(self, value: bool) -> Self

pub const fn with_rows_affected(self, value: bool) -> Self

pub const fn with_streaming(self, value: bool) -> Self

pub const fn with_row_level_dml(self, value: bool) -> Self

Trait Implementations

impl Clone for Capabilities

fn clone(&self) -> Capabilities

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Capabilities

impl Debug for Capabilities

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

Formats the value using the given formatter.

impl Default for Capabilities

fn default() -> Capabilities

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Capabilities

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Capabilities

impl PartialEq for Capabilities

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Capabilities