azuredriver

package module
v1.8.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 18, 2026 License: MIT Imports: 20 Imported by: 0

Documentation

Overview

Package azuredriver provides an Azure Blob Storage driver for Trove.

The Azure driver stores objects in Azure Blob Storage. It implements the core driver.Driver interface plus MultipartDriver, PresignDriver, and RangeDriver capability interfaces.

DSN format:

azure://ACCOUNT_NAME/CONTAINER?key=ACCESS_KEY
azure://ACCOUNT_NAME/CONTAINER?connection_string=...
azure://ACCOUNT_NAME/CONTAINER?endpoint=http://127.0.0.1:10000

Usage:

drv := azuredriver.New()
drv.Open(ctx, "azure://myaccount/mycontainer?key=mykey")
t, err := trove.Open(drv)

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AzureDriver

type AzureDriver struct {
	// contains filtered or unexported fields
}

AzureDriver implements driver.Driver for Azure Blob Storage.

func New

func New() *AzureDriver

New creates a new Azure Blob Storage driver.

func Unwrap

func Unwrap(t interface{ Driver() driver.Driver }) *AzureDriver

Unwrap extracts the typed AzureDriver from a Trove handle.

func (*AzureDriver) AbortMultipart

func (d *AzureDriver) AbortMultipart(_ context.Context, _, _, uploadID string) error

AbortMultipart cancels a block blob upload. Uncommitted blocks are automatically cleaned up by Azure after a retention period.

func (*AzureDriver) Client

func (d *AzureDriver) Client() *azblob.Client

Client returns the underlying Azure Blob client for advanced use cases.

func (*AzureDriver) Close

func (d *AzureDriver) Close(_ context.Context) error

Close marks the driver as closed.

func (*AzureDriver) CompleteMultipart

func (d *AzureDriver) CompleteMultipart(ctx context.Context, bucket, key, uploadID string, parts []driver.PartInfo) (*driver.ObjectInfo, error)

CompleteMultipart commits the block list to form the final blob.

func (*AzureDriver) Copy

func (d *AzureDriver) Copy(ctx context.Context, srcBucket, srcKey, dstBucket, dstKey string, _ ...driver.CopyOption) (*driver.ObjectInfo, error)

Copy copies an object within or across containers.

func (*AzureDriver) CreateBucket

func (d *AzureDriver) CreateBucket(ctx context.Context, name string, _ ...driver.BucketOption) error

CreateBucket creates a new Azure container.

func (*AzureDriver) Delete

func (d *AzureDriver) Delete(ctx context.Context, bucket, key string, _ ...driver.DeleteOption) error

Delete removes an object from Azure Blob Storage.

func (*AzureDriver) DeleteBucket

func (d *AzureDriver) DeleteBucket(ctx context.Context, name string) error

DeleteBucket removes an Azure container.

func (*AzureDriver) Get

func (d *AzureDriver) Get(ctx context.Context, bucket, key string, _ ...driver.GetOption) (*driver.ObjectReader, error)

Get retrieves an object from Azure Blob Storage.

func (*AzureDriver) GetRange

func (d *AzureDriver) GetRange(ctx context.Context, bucket, key string, offset, length int64) (*driver.ObjectReader, error)

GetRange retrieves a byte range of an object. The offset is the starting byte position and length is the number of bytes to read. A length of -1 reads from offset to end.

func (*AzureDriver) Head

func (d *AzureDriver) Head(ctx context.Context, bucket, key string) (*driver.ObjectInfo, error)

Head returns object metadata without content.

func (*AzureDriver) InitiateMultipart

func (d *AzureDriver) InitiateMultipart(_ context.Context, bucket, key string, _ ...driver.PutOption) (string, error)

InitiateMultipart starts a block blob upload. Azure uses a stage-then-commit pattern: blocks are staged individually, then committed as a block list.

func (*AzureDriver) List

func (d *AzureDriver) List(ctx context.Context, bucket string, opts ...driver.ListOption) (*driver.ObjectIterator, error)

List returns one page of objects matching the given options. The cursor is the NextMarker of the previous page, passed back as Marker; it is opaque, never a blob name.

func (*AzureDriver) ListBuckets

func (d *AzureDriver) ListBuckets(ctx context.Context) ([]driver.BucketInfo, error)

ListBuckets returns all accessible containers.

func (*AzureDriver) Name

func (d *AzureDriver) Name() string

Name returns "azure".

func (*AzureDriver) Open

func (d *AzureDriver) Open(_ context.Context, dsn string, opts ...driver.Option) error

Open initializes the Azure client using the given DSN and options.

func (*AzureDriver) Ping

func (d *AzureDriver) Ping(ctx context.Context) error

Ping verifies Azure connectivity by getting container properties.

func (*AzureDriver) PresignGet

func (d *AzureDriver) PresignGet(_ context.Context, bucket, key string, expires time.Duration) (string, error)

PresignGet generates a pre-signed URL (SAS token) for downloading an object.

func (*AzureDriver) PresignPut

func (d *AzureDriver) PresignPut(_ context.Context, bucket, key string, expires time.Duration) (string, error)

PresignPut generates a pre-signed URL (SAS token) for uploading an object.

func (*AzureDriver) Put

func (d *AzureDriver) Put(ctx context.Context, bucket, key string, r io.Reader, opts ...driver.PutOption) (*driver.ObjectInfo, error)

Put stores an object in Azure Blob Storage.

func (*AzureDriver) UploadPart

func (d *AzureDriver) UploadPart(ctx context.Context, bucket, key, uploadID string, partNum int, r io.Reader) (*driver.PartInfo, error)

UploadPart stages a block for the block blob.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL