Enum UCReference 

pub enum UCReference {
    Volume {
        catalog: String,
        schema: String,
        volume: String,
        path: String,
    },
    Table {
        catalog: String,
        schema: String,
        table: String,
    },
    Path(Url),
}

A parsed reference to a Unity Catalog securable.

Construct one via UCReference::parse (or its FromStr impl). The variants map 1:1 to the three credential-vending endpoints exposed by Unity Catalog.

Variants

Volume

A Unity Catalog volume, with an optional sub-path inside the volume.

Fields

catalog: String

schema: String

volume: String

path: String

Sub-path inside the volume, e.g. raw/2024/01/file.parquet.

Empty when the URL addresses the volume root.

Table

A Unity Catalog table (referenced by its three-level name).

Fields

catalog: String

schema: String

table: String

Path(Url)

A raw cloud URL (s3://, gs://, abfss://, …). Credentials are vended via the temporary-path-credentials endpoint.

Implementations

impl UCReference

pub fn parse(input: &str) -> Result<Self>

Parse a URL string into a UCReference.

See the module-level documentation for the supported shapes.

pub fn full_name(&self) -> Option<String>

Convenience accessor: returns the three-level dotted name for Volume and Table references, None for raw paths.

Trait Implementations

impl Clone for UCReference

fn clone(&self) -> UCReference

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UCReference

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

Formats the value using the given formatter.

impl Eq for UCReference

impl FromStr for UCReference

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl PartialEq for UCReference

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for UCReference