콘텐츠로 이동

SegmentBlobStore

이 콘텐츠는 아직 번역되지 않았습니다.

一级存储接口:字节对象的 put / get / head / list / delete。 S3 / OSS / COS / MinIO / GCS / Azure / GridFS / 文件系统皆此级;分段、编码、清单提交、 热盘 LRU 与重试由引擎内置分层核完成,适配器只需守 StoreError 四类错误约定。

readonly capabilities: BlobStoreCapabilities;

delete(keys, signal?): Promise<void>;

不存在不算错

readonly string[]

any

Promise<void>


get(
key,
range?,
signal?
): Promise<ReadableStream<Uint8Array<ArrayBufferLike>>>;

返回的流由引擎消费与关闭;适配器不得整段读入内存

string

ByteRange

any

Promise<ReadableStream<Uint8Array<ArrayBufferLike>>>


head(key, signal?): Promise<BlobMeta | null>;

不存在 → null(不抛)

string

any

Promise<BlobMeta | null>


list(
prefix,
cursor?,
signal?
): AsyncIterable<BlobListEntry>;

允许最终一致;引擎只用于 gc 与盘点

string

string

any

AsyncIterable<BlobListEntry>


put(
key,
body,
meta,
opts?
): Promise<PutResult>;

至少一次、按 meta.sha256 幂等(同键同哈希重复 put 必须成功且无副作用)

string

ReadableStream<Uint8Array<ArrayBufferLike>>

BlobMeta

PutOptions

Promise<PutResult>