Struct Clone 

pub struct Clone {
    pub is_shallow: bool,
    pub ref_name: Option<String>,
    pub ref_version: u64,
    pub ref_path: String,
    pub branch_name: Option<String>,
}

An operation that clones a dataset.

Fields

is_shallow: bool

• true: Performs a metadata-only clone (copies manifest without data files). The cloned dataset references original data through base_paths, suitable for experimental scenarios or rapid metadata migration.
• false: Performs a full deep clone using the underlying object storage’s native copy API (e.g., S3 CopyObject, GCS rewrite). This leverages server-side bulk copy operations to bypass download/upload bottlenecks, achieving near-linear speedup for large datasets (typically 3-10x faster than manual file transfers). The operation maintains atomicity and data integrity guarantees provided by the storage backend.

ref_name: Option<String>

the reference name in the source dataset in most cases it should be the the branch or tag name in the source dataset

ref_version: u64

the version of the source dataset for cloning

ref_path: String

the absolute base path of the source dataset for cloning

branch_name: Option<String>

if the target dataset is a branch, this is the branch name of the target dataset

Implementations

impl Clone

pub fn ref_name(&self) -> &str

Returns the value of ref_name, or the default value if ref_name is unset.

pub fn branch_name(&self) -> &str

Returns the value of branch_name, or the default value if branch_name is unset.

Trait Implementations

impl Clone for Clone

fn clone(&self) -> Clone

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Clone

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

Formats the value using the given formatter.

impl Default for Clone

fn default() -> Self

Returns the “default value” for a type.

impl Message for Clone

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl Name for Clone

const NAME: &'static str = "Clone"

Simple name for this Message. This name is the same as it appears in the source .proto file, e.g. FooBar.

const PACKAGE: &'static str = "lance.table"

Package name this message type is contained in. They are domain-like and delimited by ., e.g. google.protobuf.

fn full_name() -> String

Fully-qualified unique name for this Message. It’s prefixed with the package name and names of any parent messages, e.g. google.rpc.BadRequest.FieldViolation. By default, this is the package name followed by the message name. Fully-qualified names must be unique within a domain of Type URLs.

fn type_url() -> String

Type URL for this Message, which by default is the full name with a leading slash, but may also include a leading domain name, e.g. type.googleapis.com/google.profile.Person. This can be used when serializing into the google.protobuf.Any type.

impl PartialEq for Clone

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