---
title: "oceanbase.DBA_OB_KV_TTL_TASK_HISTORY - OceanBase 数据库 V4.4.2 | OceanBase 文档中心"
description: oceanbase.DBA_OB_KV_TTL_TASK_HISTORY 说明 该视图从 V3.1.4 版本开始引入。 功能描述 展示当前租户的历史 TTL 任务。 字段说明 字段名称 类型 是否可以为 NULL 描述 TABLE_NAME varchar(256) NO 表名 TABLE_ID bigint(20)…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.4.2 LTS

# oceanbase.DBA_OB_KV_TTL_TASK_HISTORY

更新时间：2026-07-16 20:01:47

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.4.2/zh-CN/700.reference/700.system-views/400.system-view-of-mysql-mode/200.dictionary-view-of-mysql-mode/9300.o-dba_ob_kv_ttl_task_history-of-mysql-mode.md)

#### 说明

该视图从 V3.1.4 版本开始引入。

## 功能描述

展示当前租户的历史 TTL 任务。

## 字段说明

| **字段名称** | **类型** | **是否可以为 NULL** | **描述** |
| --- | --- | --- | --- |
| TABLE_NAME | varchar(256) | NO | 表名 |
| TABLE_ID | bigint(20) | NO | 表 ID |
| TABLET_ID | bigint(20) | NO | Tablet ID |
| TASK_ID | bigint(20) | NO | 任务 ID，从 1 开始 |
| START_TIME | timestamp(6) | NO | 任务开始时间 |
| END_TIME | timestamp(6) | NO | 任务结束时间 |
| TRIGGER_TYPE | varchar(8) | NO | 任务触发类型，包括 PERIODIC 和 USER 两种 |
| STATUS | varchar(13) | NO | 任务当前状态，见任务表状态说明 |
| TTL_DEL_CNT | bigint(20) | NO | 基于 `time_to_live` 删除的记录数量 |
| MAX_VERSION_DEL_CNT | bigint(20) | NO | 基于 `MAX_VERSION` 删除的记录数量 |
| SCAN_CNT | bigint(20) | NO | 任务扫描的记录数量 |
| RET_CODE | varchar(512) | NO | 任务返回码 |
| TASK_TYPE | varchar(12) | NO | TTL 任务的类型，有 NORMAL 和 HBASE ROWKEY 两种 TTL 任务类型。当前仅 OBKV-HBase 支持 HBASE ROWKEY 类型 |
| SCAN_INDEX | varchar(128) | NO | 任务扫描使用的索引，默认为 PRIMARY KEY |

## 查询示例

查看当前租户的历史 TTL 任务。

```shell
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_KV_TTL_TASK_HISTORY LIMIT 10\G;

```

查询结果如下：

```shell
*************************** 1. row ***************************
         TABLE_NAME: ttl_table_2
           TABLE_ID: 500530
          TABLET_ID: 201032
            TASK_ID: 2
         START_TIME: 2026-04-23 17:46:21.673691
           END_TIME: 2026-04-23 17:46:21.673691
       TRIGGER_TYPE: USER
             STATUS: PREPARED
        TTL_DEL_CNT: 0
MAX_VERSION_DEL_CNT: 0
           SCAN_CNT: 0
           RET_CODE: OB_SUCCESS
          TASK_TYPE: NORMAL
         SCAN_INDEX: PRIMARY KEY
*************************** 2. row ***************************
         TABLE_NAME: ttl_table_2
           TABLE_ID: 500530
          TABLET_ID: 201033
            TASK_ID: 2
         START_TIME: 2026-04-23 17:46:21.673697
           END_TIME: 2026-04-23 17:46:21.673697
       TRIGGER_TYPE: USER
             STATUS: PREPARED
        TTL_DEL_CNT: 0
MAX_VERSION_DEL_CNT: 0
           SCAN_CNT: 0
           RET_CODE: OB_SUCCESS
          TASK_TYPE: NORMAL
         SCAN_INDEX: PRIMARY KEY
*************************** 3. row ***************************
         TABLE_NAME: ttl_table_2
           TABLE_ID: 500530
          TABLET_ID: 201034
            TASK_ID: 2
         START_TIME: 2026-04-23 17:46:21.673740
           END_TIME: 2026-04-23 17:46:21.673740
       TRIGGER_TYPE: USER
             STATUS: PREPARED
        TTL_DEL_CNT: 0
MAX_VERSION_DEL_CNT: 0
           SCAN_CNT: 0
           RET_CODE: OB_SUCCESS
          TASK_TYPE: NORMAL
         SCAN_INDEX: PRIMARY KEY

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线