跳转至

更新外挂加速分区数据

接口描述

本接口用于在外挂物化方案中标记某些分区的更新结果（成功 / 失败）。

⚠️ 重要：

  • 此接口 不会操作真实物理表，仅更新 CAN 内部维护的 “物化表分区元数据”。

  • 仅用于记录哪个分区已经补数成功、哪个失败，供查询命中判断

接口 URL

POST /anymetrics/api/v1/accelerate/plan/updatePartition

请求参数

公共请求参数（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 是 当前物化方案的 UUID
runType String 否 补数类型：MANUAL | SCHEDULED（默认 SCHEDULED）
successTimeRange List 否 成功更新的时间区间（粒度必须与物化表相同）
failedTimeRange List 否 失败更新的时间区间（粒度必须与物化表相同）

successTimeRange / failedTimeRange 单项结构

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

请求示例

{
  "uuid": "ecfc2a9539a04ef49897a9b4e3d65e7f",
  "runType": "MANUAL",
  "successTimeRange": [
    {
      "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"
    }
  ],
  "failedTimeRange": [
    {
      "dateGranularity": "DAY",
      "startTime": "2025-10-23T00:00:00",
      "endTime": "2025-10-23T00:00:00"
    }
  ]
}

响应参数说明

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

响应示例

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

使用说明

  • 全量表无需传入 successTimeRange 与 failedTimeRange
    调用即视为成功。

  • 所有时间区间的粒度必须与物化表粒度完全一致，例如：

  • DAY 表只能传 DAY

  • MONTH 表只能传 MONTH

  • 此接口不会触发任何数据写入，仅用于标记状态。
    真实的数据写入需通过外部调度系统完成。

  • 如需清空某些分区，请使用：
    ➜ /accelerate/plan/clearPartition

  • 如需查看当前分区列表，请使用：
    ➜ /accelerate/plan/queryMtPartitionList