数据剖析前端改成逐表的后台任务:对话框看得到每张表的进度,可以停止、重试没做完的表

以前剖析是一次同步长请求,进行中只有一条已用时长的横条、停不下来,关掉页面报告就没了;预算按整次剖析算,几十张表
往往只做完前两三张。服务端改成逐表的后台任务(profile-jobs)后,界面照起草任务的做法重做:

- types、api:按接口约定加剖析任务、逐表行、逐表详情(检查清单、发现、发过的查询)、清单行上的最近一次剖析和
  profile_due / profile_checks、目录顶上的 active_profile_job,起草任务加 waiting_for;删掉同步接口 profile() 和只给它用的
  类型;设置换成每张表最多查询数、每张表时长上限两项新键
- profileJob.ts(新):useProfileJob,进行中每 1.5 秒取一次,状态只往前走,关掉对话框照常进行,结束时右下角提示
- ProfileDialog 重做:开始前四种范围和个数、按表写的预算和这次最多约几条查询、只读一条一条发可随时停止的说明,同源有
  起草任务时「排队剖析」;进行中逐表一行(状态、各类检查进度、查询数、用时、正在做哪一项),点开看检查清单、发现和发过的
  查询;结束后汇总、止损和停止的原因照实写、按有发现 / 有跳过 / 失败筛、重试没做完的表;409 六种情况各有说法和下一步
- 目录页头部起草、剖析各一个进度入口;表清单加「剖析」一格和「需要剖析」开关(地址里记 profile=due);表详情加
  「数据剖析」一节和「剖析这张表」
- 起草排在剖析后面时写「排在剖析任务后面,剖析结束后自动开始」
- 文案:去掉「剖析无法中途停止」「总时长上限」等已不成立的说法,补上新的跳过原因和任务状态的叫法
This commit is contained in:
ThearchyHelios
2026-10-15 18:14:14 +08:00
parent 96934ce7ef
commit 03a9684a18
14 changed files with 1885 additions and 508 deletions
+40 -7
View File
@@ -1,6 +1,6 @@
import type {
ActivateSnapshotBody, ActivateSnapshotOut, AiPreview, CatalogAssistantEvent, CatalogAssistantRequest, CatalogDetail, CatalogDraftJob,
CatalogImpact, CatalogImportReport, CatalogList, CatalogNotes, CatalogPatchPreview, CatalogPatchSubmit, CatalogProfileOut,
CatalogImpact, CatalogImportReport, CatalogList, CatalogNotes, CatalogPatchPreview, CatalogPatchSubmit, CatalogProfileJob, CatalogProfileTaskDetail,
CatalogReviewAction, CatalogReviewBatchItem, CatalogReviewBatchResult, CatalogReviewKind, CatalogReviewProgress, CatalogReviewQueue,
CatalogTableUsage, CommitOut, CurrentRecipe, EditPreview,
EditRequest, ImportRecord,
@@ -466,12 +466,44 @@ export const api = {
putGuidance: (sourceId: string, guidance: string) =>
put<{ guidance: string | null }>(`${catalogBase(sourceId)}/guidance`, { guidance }),
/**
* 同步剖析:对业务库发少量只读查询,核对关系、取码值候选,结论写进目录。不给 tables 时按使用次数取前 10 张
* 有待核实关系的表。没开启、数据源停用、没有表结构、同一个数据源正在剖析、快照被改动时回 409(detail 是一句中文)
* 剖析任务(后台进行:逐表对业务库发只读查询,一条一条发,每张表一结束就写进目录)。剖析会对业务库发查询,默认关闭,
* 按数据源开启。和同一个数据源的起草任务按建立顺序排队(起草在排队、进行中时剖析建成 queued、waiting_for 为 draft)
*/
profile: (sourceId: string, body: { tables?: string[] }, opts?: RequestOptions) =>
request<CatalogProfileOut>(`/datasources/${encodeURIComponent(sourceId)}/catalog/profile`,
{ method: 'POST', body: JSON.stringify(body), ...opts }),
profileJobs: {
/**
* 建任务:tables 非空时只剖析这些表(最多 500 张,按给的顺序,表结构里没有、视图、没有可剖析的项照样建进任务、记跳过),
* 否则按 scope(缺省 needed:需要剖析的表;all:全部可剖析的表)由服务端挑。202。
* 409 带机读码:profile_disabled、datasource_inactive、schema_missing、snapshot_tampered、profile_busy(这个源已有排队、
* 进行中的剖析任务,detail 写明进行到第几张)、profile_nothing(按范围挑出 0 张表,detail 写明原因和建议)
*/
create: (sourceId: string, body: { tables?: string[]; scope?: 'needed' | 'all' }) =>
post<{ job: CatalogProfileJob }>(`${catalogBase(sourceId)}/profile-jobs`, body),
/** 排队或进行中的那个剖析任务;没有为 null */
active: (sourceId: string, opts?: RequestOptions) =>
get<{ job: CatalogProfileJob | null }>(`${catalogBase(sourceId)}/profile-jobs/active`, opts),
/** 最近建的一个剖析任务(任何状态);没有为 null */
latest: (sourceId: string, opts?: RequestOptions) =>
get<{ job: CatalogProfileJob | null }>(`${catalogBase(sourceId)}/profile-jobs/latest`, opts),
/** 一个剖析任务的当前状态;不属于这个数据源回 404 */
get: (sourceId: string, jobId: string, opts?: RequestOptions) =>
get<{ job: CatalogProfileJob }>(`${catalogBase(sourceId)}/profile-jobs/${encodeURIComponent(jobId)}`, opts),
/** 任务里一张表的完整结果:检查清单、发现、跳过的项、日期范围、发过的查询。找不到 404 */
task: (sourceId: string, jobId: string, seq: number, opts?: RequestOptions) =>
get<{ task: CatalogProfileTaskDetail }>(
`${catalogBase(sourceId)}/profile-jobs/${encodeURIComponent(jobId)}/tasks/${encodeURIComponent(String(seq))}`, opts),
/**
* 停止:排队的直接停;进行中的那条查询由数据库按单条时限截止,这张表已做完的项照常写进目录、没做的保留旧结论,
* 后面的表记已停止。回停止之后的状态;已经结束的回 409(catalog_profile_finished)
*/
cancel: (sourceId: string, jobId: string) =>
post<{ job: CatalogProfileJob }>(`${catalogBase(sourceId)}/profile-jobs/${encodeURIComponent(jobId)}/cancel`),
/**
* 重试没做完的表:新任务只含原任务里失败、部分完成、已停止的表(按原顺序)。202;没有可重试的表 422;
* 这个源已有排队、进行中的剖析任务 409(profile_busy)
*/
retry: (sourceId: string, jobId: string) =>
post<{ job: CatalogProfileJob }>(`${catalogBase(sourceId)}/profile-jobs/${encodeURIComponent(jobId)}/retry`),
},
// ---- 审阅队列(只列推断项,按表的使用次数、这一项对数字的影响和来源排好)
/** 一页待确认项。kind:全部 / 影响数字的项 / 名称和含义;table 只看这一张表 */
reviewQueue: (sourceId: string, params: { limit?: number; offset?: number; kind?: CatalogReviewKind; table?: string | null },
@@ -512,7 +544,8 @@ export const api = {
importPreview: (sourceId: string, body: { content: unknown; include_guidance: boolean }) =>
post<CatalogImportReport>(`${catalogBase(sourceId)}/import/preview`, body),
/**
* 导入:规则同预览,逐表乐观锁,一张表失败不影响别的。有排队、进行中的起草任务时 409(catalog_draft_busy);
* 导入:规则同预览,逐表乐观锁,一张表失败不影响别的。有排队、进行中的起草任务时 409(catalog_draft_busy),剖析任务时
* 409(profile_busy);
* 文件格式不对 422(detail 是一句中文)
*/
importCatalog: (sourceId: string, body: { content: unknown; include_guidance: boolean }) =>