---
title: "clog 日志格式说明 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: clog 日志格式说明 本节介绍事务日志的打印格式。 通常 clog 文件中包含多种类型的日志，其中 OB_LOG_SUBMIT 为主要的日志类型，表示对应的 clog 日志为其他模块（非 clog 模块）提交的日志，包含事务模块向 clog 提交的事务日志。 事务日志的打印格式主要包含三部分：摘要（abstract…
---
切换语言

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

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

# clog 日志格式说明

更新时间：2026-06-11 19:26:46

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/1500.Components-and-Tools/100.manage/200.ob-admin/300.clog/400.format-of-clogs.md)  

本节介绍事务日志的打印格式。

通常 clog 文件中包含多种类型的日志，其中 OB_LOG_SUBMIT 为主要的日志类型，表示对应的 clog 日志为其他模块（非 clog 模块）提交的日志，包含事务模块向 clog 提交的事务日志。

事务日志的打印格式主要包含三部分：摘要（abstract）、头部（header）和主体（content）。日志形式如下所示：

```text
$$$abstract |header |||   |||content

```

## 摘要

摘要描述了日志记录在日志文件中的相关信息，内容形式如下所示：

```text
file_id:*** offset:*** len:***  OB_LOG_SUBMIT

```

下表列出了字段名的详细信息。

| 字段名 | 说明 |
| --- | --- |
| `file_id` | clog 日志文件名 |
| `offset` | 日志记录在日志文件中的偏移量 |
| `len` | 日志记录的长度 |
| `OB_LOG_SUBMIT` | clog 日志类型为 OB_LOG_SUBMIT |

## 头部

头部描述了日志记录自身的相关信息，内容形式如下所示：

```text
ObLogEntryHeader:{magic:***, version:***, type:***, partition_key:***, log_id:***, data_len:***, generation_timestamp:***, epoch_id:***, proposal_id:***, submit_timestamp:***, is_batch_committed:***, is_trans_log:***, data_checksum:***, active_memstore_version:***, header_checksum:***}

```

下表列出了部分字段名的详细信息。

| 字段名 | 说明 |
| --- | --- |
| `partition_key` | 日志记录对应的数据分区的分区标识符。 |
| `log_id` | 日志记录的标识符，可看作日志序列号。 |
| `generation_timestamp_` | 日志记录产生的时间点（Unix 时间戳）。 |
| `epoch_id` | 选举相关变量，选举周期标识符（Unix 时间戳）。 |
| `proposal_id` | Paxos 协议相关变量。 |
| `is_trans_log` | 日志记录是否是事务记录。 |

## 主体

主体描述了该日志记录包含的数据。如果该日志记录是事务日志记录，内容形式如下所示：

```text
Trans: log_type:***, trans_inc:*** {[trans_log]}||| [mutator]

```

| 字段名 | 说明 |
| --- | --- |
| `log_type` | 事务日志的类型 |
| `trans_id` | 事务日志对应的事务标识符 |
| `[trans_log]` | 事务日志的相关信息 |
| `[mutator]` | 如果事务日志类型为 redo，则该日志包含事务修改内容 |

#### 注意

由于 OceanBase 数据库限制一条日志记录的大小，因此当一个事务的修改数据量较大时，可能产生多条 redo 类型的事务日志记录。

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