跳转至

清空外挂加速分区数据

接口描述

本接口用于清空外挂物化表的某些分区（仅元数据层，不会清除物理表数据）。

⚠️ 注意：

  • 此操作不会修改真实数据库中的数据，仅修改 CAN 内部的分区命中元数据

  • 调用后，被清空分区将无法命中物化，需要重新补数

接口 URL

POST /anymetrics/api/{version}/accelerate/plan/clearPartition

请求参数

公共请求参数（HEADERS）

参数 类型 是否必选 最大长度 描述
tenant-id String 是 32 租户 ID，用于指定业务空间
auth-type String 是 32 认证方式：UID / TOKEN
auth-value String 是 32 与 auth-type 对应的认证值

公共参数获取方式

从 Aloudata CAN 顶部导航「指标应用」→「API 集成」中获取。

image.png

请求参数

字段 类型 是否必选 描述
uuid String 是 物化方案唯一 ID
timeRange List 否 要清空的物化分区时间范围

timeRange 单项结构

字段 类型 描述
dateGranularity String 粒度（如 DAY / MONTH）
startTime String 起始时间（ISO 格式）
endTime String 结束时间（ISO 格式）

请求示例

[
  {
    "dateGranularity": "DAY",
    "startTime": "2025-10-22T00:00:00",
    "endTime": "2025-10-22T00:00:00"
  },
  {
    "dateGranularity": "DAY",
    "startTime": "2025-10-20T00:00:00",
    "endTime": "2025-10-21T00:00:00"
  }
]

响应参数说明

字段 类型 描述
data String 成功时固定值 "success"
success Boolean 是否调用成功
code String 状态码
errorMsg String 错误信息
detailErrorMsg String 错误详情

响应示例

{
  "data": "success",
  "success": true,
  "code": "200",
  "errorMsg": null
}

使用说明

清空分区不会删除物理表数据

该接口仅更新系统元数据，不会清理底层 StarRocks / Doris / Hive / SparkSQL 表。

全量表直接调用即可

若物化方案为 全量类型：

  • timeRange 可为空

  • 调用后整个表标记为不可命中

  • 需要重新补全表数据