Azure Blob 存储后端#

LMCache 可以通过异步原生连接器将 KV Cache 卸载到 Azure Blob Storage（与 S3 后端相同，无 NIXL 依赖）。连接器由 azure:// remote_url 选择。

可选包#

Azure SDK 是可选依赖项，并且是按需导入的，因此仅在使用此后端时安装它们：

pip install azure-storage-blob
# Only needed for the DefaultAzureCredential fallback (see Authentication):
pip install azure-identity

URL 格式#

azure://<container_name>

容器名称是 URL 中唯一携带的值。存储帐户和凭据通过 extra_config 提供。

示例配置#

chunk_size: 256
local_cpu: False
save_unfull_chunk: False
remote_url: "azure://my-container"
remote_serde: "naive"
blocking_timeout_secs: 10
extra_config:
  azure_account_url: "https://myaccount.blob.core.windows.net"
  azure_account_key: "your-account-key"

配置参数（在 extra_config 中）#

  • azure_account_url: 存储帐户 URL，例如 https://<account>.blob.core.windows.net。除非提供 azure_connection_string，否则为必填项。

  • azure_connection_string: 完整的 Azure 存储连接字符串。当设置时，它单独使用，其他字段将被忽略。

  • azure_account_key: 存储账户共享密钥（与 azure_account_url 配对）。

  • azure_sas_token: 共享访问签名令牌（与 azure_account_url 配对）。

认证#

恰好解析出一个凭证路径，优先考虑最明确的：

  1. azure_connection_string — 如果设置了，它将优先。

  2. azure_account_url + azure_account_key — 共享密钥认证。

  3. azure_account_url + azure_sas_token — SAS 令牌认证。

  4. azure_account_url 仅 — 回退到 DefaultAzureCredential``（托管身份、环境变量、Azure CLI 登录等），这需要 ``azure-identity 包。

azure_account_url 在每个路径中都是必需的，除了连接字符串的情况。

注意事项#

  • 仅存储完整块；设置 save_unfull_chunk: False。

  • 键被扁平化为每个块一个 blob（与 S3 后端相同的扁平布局）。