用途:管理外部集合(external collection)的刷新任务生命周期。外部集合的行数据存放在外部数据源(例如 Vector Lake 表)中,集合的元数据、索引和 schema 位于 Milvus,数据按需拉取;刷新任务负责把外部数据同步进集合,使后续查询能看到新行。
前置条件:CLI 已安装、已登录并设置集群上下文;目标集合必须已经是以外部数据源/schema 创建的外部集合,普通就地集合没有刷新任务;集群需运行暴露 /v2/vectordb/jobs/external_collection/* 的 kite-coordinator 构建(PR #5735 或更高)。较旧数据面会返回 404,此时需请用户升级集群。
主要能力与用法:该资源只有一个操作 refresh,含三个动作,均为数据面调用,默认继承当前上下文的数据库,可用 --database 覆盖。触发刷新:zilliz external-collection refresh trigger --name <collection-name>,可选 --database、--external-source、--external-spec;返回新 jobId,用 describe 轮询状态。覆盖标志很少需要,源与 spec 通常在创建集合时固定。描述任务:zilliz external-collection refresh describe --job-id <id>,返回状态、进度及失败时的错误信息。列出任务:zilliz external-collection refresh list,可选 --name 过滤单个集合、--database 覆盖,未加过滤时返回当前数据库的近期刷新任务;可配合 --query 提取字段,例如 zilliz external-collection refresh list --name my_external_coll --query 'data[?state==Pending || state==Running].jobId'。
注意事项:刷新任务异步执行,trigger 成功只表示任务被接受,须用 describe 轮询至终态。若 trigger 报“collection not found”或“not an external collection”,用 zilliz collection describe --name <name> 确认集合是否含 externalSource 字段,若无则该集合是普通就地集合,刷新不适用。describe 报告失败时应原样向用户展示错误信息,通常指向外部源的凭据、网络或 schema 不匹配。避免对同一集合调度重叠任务,触发前先用 list --name <name> 检查是否有正在运行的任务。大型外部表的触发可能运行数分钟,不应保持会话每隔几秒轮询,应给用户 jobId 并说明稍后如何用 describe 查看。集合的创建、删除、加载、查询等相关操作请转 collection 技能,本技能只覆盖刷新生命周期。
限制:资料未提供收费、价格、额度、跨平台支持等其他信息。