一、功能
该视图仅展示存量数据从本地 data DB 搬迁到远端对象存储 durable DB 的转冷任务进度,不包含冷 RG 运行态的增量上传过程。任务在执行过程中会经历若干阶段,仅在 SST 文件上传阶段会显示百分比进度,其他阶段只展示当前阶段名称。任务支持的阶段如下:
·Validating:校验阶段。
·DrainingTransactions:排空事务阶段。
·Preparing:准备阶段。
·ExportingSnapshot:快照导出阶段。
·Uploading:SST 上传阶段(此阶段展示上传百分比)。
·Committing:提交阶段。
·Done:已完成。
二、支持版本
适用于 TDSQL Boundless V21.6.3.0 及以上版本。
三、字段说明
| 字段名 | 类型 | 描述 |
| NODE_NAME | VARCHAR(64) | 任务所在的 TDStore 节点名称。 |
| JOB_ID | BIGINT UNSIGNED | 转冷任务 ID。 |
| REP_GROUP_ID | BIGINT UNSIGNED | 正在转冷的 Replication Group ID。 |
| STAGE | VARCHAR(64) | 任务当前所处的阶段。取值范围:Validating、DrainingTransactions、Preparing、ExportingSnapshot、Uploading、Committing、Done。 |
| UPLOADED_FILE_NUM | BIGINT | 已上传的 SST 文件数量。仅在 Uploading 阶段及之后有意义,其他阶段为 NULL。 |
| TOTAL_FILE_NUM | BIGINT | 本次任务需要上传的 SST 文件总数。仅在 Uploading 阶段及之后有意义,其他阶段为 NULL。 |
| UPLOADED_FILE_SIZE | BIGINT | 已上传的字节数。仅在 Uploading 阶段及之后有意义,其他阶段为 NULL。 |
| TOTAL_FILE_SIZE | BIGINT | 本次任务需要上传的总字节数。仅在 Uploading 阶段及之后有意义,其他阶段为 NULL。 |
| PROGRESS_PCT | VARCHAR | 上传进度百分比,按字节计算。仅在 Uploading 阶段及之后有意义,其他阶段为 NULL。 |
| START_TIME | VARCHAR(64) | 任务开始时间,格式为 YYYY-MM-DD hh:mm:ss。 |
| END_TIME | VARCHAR(64) | 任务结束时间,格式为 YYYY-MM-DD hh:mm:ss。任务进行中时为 NULL。 |
| ELAPSED_TIME_MS | BIGINT UNSIGNED | 任务已耗时,单位为毫秒。任务进行中时为从开始时刻到当前时刻的累计耗时,任务完成后为总耗时。 |
| ERR_MSG | VARCHAR | 任务执行过程中产生的错误信息。任务正常时为 NULL。 |
| DETAIL_COST_INFO | TEXT | 任务各阶段耗时的详细信息,便于性能分析。 |
四、示例
tdsql > SELECT * FROM information_schema.TDSTORE_TIERING_COLD_RG_JOB_PROGRESS\\G*************************** 1. row *************************** NODE_NAME: tdstore-node-1 JOB_ID: 1001 REP_GROUP_ID: 200 STAGE: Done UPLOADED_FILE_NUM: 12 TOTAL_FILE_NUM: 12UPLOADED_FILE_SIZE: 134217728 TOTAL_FILE_SIZE: 134217728 PROGRESS_PCT: 100.00% START_TIME: 2026-06-05 10:00:00 END_TIME: 2026-06-05 10:05:23 ELAPSED_TIME_MS: 323000 ERR_MSG: NULL DETAIL_COST_INFO: Validating:5ms,DrainingTransactions:120ms,Preparing:30ms,ExportingSnapshot:200ms,Uploading:322000ms,Committing:645ms*************************** 2. row *************************** NODE_NAME: tdstore-node-2 JOB_ID: 1002 REP_GROUP_ID: 201 STAGE: Uploading UPLOADED_FILE_NUM: 6 TOTAL_FILE_NUM: 10UPLOADED_FILE_SIZE: 67108864 TOTAL_FILE_SIZE: 104857600 PROGRESS_PCT: 64.00% START_TIME: 2026-06-05 10:08:00 END_TIME: NULL ELAPSED_TIME_MS: 45000 ERR_MSG: NULL DETAIL_COST_INFO: Validating:4ms,DrainingTransactions:115ms,Preparing:28ms,ExportingSnapshot:180ms,Uploading:44673ms2 rows in set (0.01 sec)