Enum deltalake::storage::object_store::aws::S3CopyIfNotExists

#[non_exhaustive]
pub enum S3CopyIfNotExists {
    Header(String, String),
    HeaderWithStatus(String, String, StatusCode),
    Dynamo(DynamoCommit),
}

Configure how to provide ObjectStore::copy_if_not_exists for AmazonS3.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Header(String, String)

Some S3-compatible stores, such as Cloudflare R2, support copy if not exists semantics through custom headers.

If set, ObjectStore::copy_if_not_exists will perform a normal copy operation with the provided header pair, and expect the store to fail with 412 Precondition Failed if the destination file already exists.

Encoded as header:<HEADER_NAME>:<HEADER_VALUE> ignoring whitespace

For example header: cf-copy-destination-if-none-match: *, would set the header cf-copy-destination-if-none-match to *

HeaderWithStatus(String, String, StatusCode)

The same as S3CopyIfNotExists::Header but allows custom status code checking, for object stores that return values other than 412.

Encoded as header-with-status:<HEADER_NAME>:<HEADER_VALUE>:<STATUS> ignoring whitespace

Dynamo(DynamoCommit)

The name of a DynamoDB table to use for coordination

Encoded as either dynamo:<TABLE_NAME> or dynamo:<TABLE_NAME>:<TIMEOUT_MILLIS> ignoring whitespace. The default timeout is used if not specified

See DynamoCommit for more information

This will use the same region, credentials and endpoint as configured for S3

Trait Implementations

impl Clone for S3CopyIfNotExists

fn clone(&self) -> S3CopyIfNotExists

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for S3CopyIfNotExists

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

Formats the value using the given formatter.

impl Display for S3CopyIfNotExists

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

Formats the value using the given formatter.

impl PartialEq for S3CopyIfNotExists

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for S3CopyIfNotExists

impl StructuralPartialEq for S3CopyIfNotExists