---
title: "oceanbase.CDB_OB_TTL_TASKS - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: oceanbase.CDB_OB_TTL_TASKS 说明 该视图从 V4.6.0 版本开始引入。 功能描述 视图 oceanbase.CDB_OB_TTL_TASKS 用于展示 SQL 模式下所有用户租户 TTL 任务的执行情况。 字段说明 字段 类型 是否为 NULL 描述 TENANT_ID bigint(20…
---
切换语言

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

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

# oceanbase.CDB_OB_TTL_TASKS

更新时间：2026-07-13 22:33:20

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/11820.o-cdb_ob_ttl_tasks-of-sys-tenant.md)

#### 说明

该视图从 V4.6.0 版本开始引入。

## 功能描述

视图 `oceanbase.CDB_OB_TTL_TASKS` 用于展示 SQL 模式下所有用户租户 TTL 任务的执行情况。

## 字段说明

| 字段 | 类型 | 是否为 NULL | 描述 |
| --- | --- | --- | --- |
| TENANT_ID | bigint(20) | NO | 租户名 |
| TABLE_NAME | varchar(256) | NO | 表名 |
| TABLE_ID | bigint(20) | NO | 表 ID |
| TASK_ID | bigint(20) | NO | 当前批次任务的 ID |
| START_TIME | timestamp(6) | NO | 任务的开始时间 |
| MODIFIED_TIME | timestamp(6) | NO | 行的更新时间 |
| TRIGGER_TYPE | varchar(8) | NO | 任务触发类型：   - `PERIODIC`：系统定期触发 - `USER`：用户手动触发 |
| STATUS | varchar(10) | NO | 任务的状态：   - `PENDING`：等待达到可执行状态 - `CANCELED`：任务被取消 - `FINISHED`：任务已结束 - `SKIP`：未达到可执行状态，跳过本轮次执行 - `FAILED`：任务执行失败 - `TRIGGERING`：RS 端任务执行中 - `SUSPENDING`：RS 端任务被暂停 - `CANCELING`：RS 端任务被取消 - `MOVING`：RS 端将执行任务信息转移至任务历史表中 |
| RET_CODE | varchar(512) | NO | 任务结束时返回的错误码 |
| TASK_TYPE | varchar(10) | NO | TTL 任务类型：   - `NORMAL`：租户级别信息展示 - `COMPACTION`：表级任务类型，通过 Compaction 做过期数据删除 |

## 查询示例

系统租户查询所有用户租户 TTL 任务的执行情况。

```shell
obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.CDB_OB_TTL_TASKS;

```

查询结果如下：

```shell
+-----------+------------+----------+---------+----------------------------+----------------------------+--------------+------------+------------+------------+
| TENANT_ID | TABLE_NAME | TABLE_ID | TASK_ID | START_TIME                 | MODIFIED_TIME              | TRIGGER_TYPE | STATUS     | RET_CODE   | TASK_TYPE  |
+-----------+------------+----------+---------+----------------------------+----------------------------+--------------+------------+------------+------------+
|      1002 | NULL       |       -1 |       2 | 2026-03-11 10:41:13.700826 | 2026-03-11 10:41:13.700826 | USER         | TRIGGERING | OB_SUCCESS | COMPACTION |
+-----------+------------+----------+---------+----------------------------+----------------------------+--------------+------------+------------+------------+
1 row in set

```

## 相关视图或文档

- 查看所有用户租户 TTL 任务的执行历史：[CDB_OB_TTL_TASK_HISTORY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683961)
 - [使用 TTL（Time To Live）功能](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682772)

 上一篇 下一篇 ![有帮助](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) 咨询热线
