---
title: "开启日志归档 | OceanBase 文档中心"
description: 开启日志归档 完成准备工作后，您可以根据业务场景开启日志归档。 前提条件 开启日志归档前，请确认待开启日志归档的租户的日志归档状态机处于 STOP 状态。日志归档状态机相关说明请参见 日志归档状态机介绍 。 背景信息 假设当前集群中有 3 个租户，分别是 sys 、 mysql_tenant 和 oracle_ten…
---
切换语言

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

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

# 开启日志归档

更新时间：2026-06-11 15:27:46

完成准备工作后，您可以根据业务场景开启日志归档。

## 前提条件

开启日志归档前，请确认待开启日志归档的租户的日志归档状态机处于 `STOP` 状态。日志归档状态机相关说明请参见 [日志归档状态机介绍](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000886366)。

## 背景信息

假设当前集群中有 3 个租户，分别是 `sys`、`mysql_tenant` 和 `oracle_tenant`，且租户 `mysql_tenant` 和 `oracle_tenant` 均已完成发起日志归档前的准备工作。

## 系统租户发起日志归档

`sys` 租户可以对集群中的所有租户或指定租户发起日志归档。

1. 使用 `root` 用户登录到数据库的 `sys` 租户。
 2. 执行以下语句，发起日志归档。

- 对集群中的所有租户发起日志归档

  该方式会对集群当前的所有租户发起日志归档。需要特别注意的是，对于该操作之后创建的租户，系统不会自动发起日志归档。

  ```sql
   obclient> ALTER SYSTEM ARCHIVELOG TENANT=ALL;

  ```

  命令执行成功后，在本示例中，系统会对集群中的 `mysql_tenant` 和 `oracle_tenant` 租户发起日志归档。
 - 对集群中的指定租户发起日志归档

  该方式仅对指定租户发起日志归档，不会影响集群中的其他租户。

  对 `mysql_tenant` 租户发起日志归档的示例如下：

  ```sql
   obclient> ALTER SYSTEM ARCHIVELOG TENANT=MYSQL_TENANT;

  ```

  > **说明**
  >
  >  
  >
  > 同时指定多个租户时，租户名之间使用英文逗号 (`,`) 分隔。

  命令执行成功后，在本示例中，系统会对集群中的 `mysql_tenant` 租户发起日志归档。

开启日志归档后，系统会按照 Piece 来组织和管理归档日志数据。有关 Piece 的详细介绍请参见 [Piece](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000886367)。

## 用户租户发起日志归档

用户租户可以对本租户发起日志归档，不会影响其他租户。

1. 租户管理员登录到相应的租户。

   本示例中，您可以使用 `root` 用户登录 `mysql_tenant` 租户；或者也可以使用 `sys` 用户登录 `oracle_tenant` 租户。
 2. 执行以下语句，开启日志归档。

   ```sql
   obclient> ALTER SYSTEM ARCHIVELOG;

   ```

## 相关阅读

- [关闭日志归档](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000886365)
 - [查看归档进度](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000886368)
 - [查看归档结果](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000886369)

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