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 ¶
- type AzureDriver
- func (d *AzureDriver) AbortMultipart(_ context.Context, _, _, uploadID string) error
- func (d *AzureDriver) Client() *azblob.Client
- func (d *AzureDriver) Close(_ context.Context) error
- func (d *AzureDriver) CompleteMultipart(ctx context.Context, bucket, key, uploadID string, parts []driver.PartInfo) (*driver.ObjectInfo, error)
- func (d *AzureDriver) Copy(ctx context.Context, srcBucket, srcKey, dstBucket, dstKey string, ...) (*driver.ObjectInfo, error)
- func (d *AzureDriver) CreateBucket(ctx context.Context, name string, _ ...driver.BucketOption) error
- func (d *AzureDriver) Delete(ctx context.Context, bucket, key string, _ ...driver.DeleteOption) error
- func (d *AzureDriver) DeleteBucket(ctx context.Context, name string) error
- func (d *AzureDriver) Get(ctx context.Context, bucket, key string, _ ...driver.GetOption) (*driver.ObjectReader, error)
- func (d *AzureDriver) GetRange(ctx context.Context, bucket, key string, offset, length int64) (*driver.ObjectReader, error)
- func (d *AzureDriver) Head(ctx context.Context, bucket, key string) (*driver.ObjectInfo, error)
- func (d *AzureDriver) InitiateMultipart(_ context.Context, bucket, key string, _ ...driver.PutOption) (string, error)
- func (d *AzureDriver) List(ctx context.Context, bucket string, opts ...driver.ListOption) (*driver.ObjectIterator, error)
- func (d *AzureDriver) ListBuckets(ctx context.Context) ([]driver.BucketInfo, error)
- func (d *AzureDriver) Name() string
- func (d *AzureDriver) Open(_ context.Context, dsn string, opts ...driver.Option) error
- func (d *AzureDriver) Ping(ctx context.Context) error
- func (d *AzureDriver) PresignGet(_ context.Context, bucket, key string, expires time.Duration) (string, error)
- func (d *AzureDriver) PresignPut(_ context.Context, bucket, key string, expires time.Duration) (string, error)
- func (d *AzureDriver) Put(ctx context.Context, bucket, key string, r io.Reader, opts ...driver.PutOption) (*driver.ObjectInfo, error)
- func (d *AzureDriver) UploadPart(ctx context.Context, bucket, key, uploadID string, partNum int, r io.Reader) (*driver.PartInfo, error)
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 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) 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.