---
title: "oceanbase.CDB_OB_BACKUP_PIECE_FILES | OceanBase 文档中心"
description: oceanbase.CDB_OB_BACKUP_PIECE_FILES 功能 oceanbase.CDB_OB_BACKUP_PIECE_FILES 用于展示备份集中 Piece 的状态。 字段说明 字段名称 类型 是否可以为 NULL 描述 INCARNATION bigint(20) NO 表示 Flashbac…
---
切换语言

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

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

# oceanbase.CDB_OB_BACKUP_PIECE_FILES

更新时间：2026-06-22 17:56:28

## 功能

`oceanbase.CDB_OB_BACKUP_PIECE_FILES` 用于展示备份集中 Piece 的状态。

## 字段说明

| 字段名称 | 类型 | 是否可以为 NULL | 描述 |
| --- | --- | --- | --- |
| INCARNATION | bigint(20) | NO | 表示 Flashback Database 后的第几次分身。 |
| TENANT_ID | bigint(20) | NO | 租户 ID。 |
| ROUND_ID | bigint(20) | NO | 用于标识第几轮完整的 Clog 备份数据流。 |
| BACKUP_PIECE_ID | bigint(20) | NO | 备份日志分片的 ID。 |
| COPY_ID | bigint(20) | NO | 备份日志分片的 `copy_id`。 |
| CREATE_DATE | bigint(20) | NO | 创建 Piece 的日期。 |
| START_TS | varchar(26) | NO | 日志备份开始的时间戳。 |
| CHECKPOINT_TS | varchar(26) | NO | Piece 中已决事务的时间戳。其中，`ACTIVE` 状态的 Piece 对应的值为 `null`。 |
| MAX_TS | varchar(26) | NO | 日志备份分片中最大的时间戳，`ACTIVE`、`FREEZING` 状态的 Piece 对应的值为 `null`。 |
| STATUS | varchar(64) | NO | 切 Piece 的状态： - `ACTIVE`：当前活跃的 Piece。 - `FREEZING`：正在冻结的 Piece。 - `FROZEN`：已经冻结的 Piece，此状态后，该 Piece 的状态不会再修改了。 |
| FILE_STATUS | varchar(64) | NO | 备份日志分片的文件状态： - `AVAILABLE`：表示有效的备份，可以用于恢复。 - `COPYING`：表示日志文件正在备份中。 - `INCOMPELTE`：表示日志文件仅拷贝了部分，仅限于定期备份备份日志的场景。该 Copy 的`checkpoint_ts` 比原备份的 `checkpoint ts`小，可以用于 `checkpoint_ts` 之前的恢复。 - `DELETING`：日志文件正在删除。 - `EXPIRED`: 表示备份文件已失效。 - `BROKEN`：备份的文件不完整，不可使用。 - `DELETED`：日志文件已删除。 |
| COMPATIBLE | bigint(20) | NO | 日志备份的兼容版本号。 |
| START_PIECE_ID | bigint(20) | NO | 同一个日志备份 Round 里面第一个 Piece 的 ID。 |
| BACKUP_PIECE_PATH | varchar(4097) | YES | 日志分片所在的路径信息。   #### 说明    该字段从 V3.2.4 BP5 版本开始引入 |

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