---
title: "RESTORE PREVIEW - OceanBase 数据库 V4.3.4 | OceanBase 文档中心"
description: RESTORE PREVIEW 描述 该语句用于指定原始租户级归档和备份路径与期望恢复时间，从而预览恢复到期望时间所需要的数据备份集（ backup_set ）和日志归档（ archivelog_piece ）。 权限要求 执行该语句需要当前用户拥有 ALTER SYSTEM 权限。 语法 ALTER SYSTEM …
---
切换语言

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

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

# RESTORE PREVIEW

更新时间：2025-09-04 10:57:16

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.4/zh-CN/700.reference/500.sql-reference/100.sql-syntax/100.system-tenants/200.alter-system/3350.restore-preview.md)  

## 描述

该语句用于指定原始租户级归档和备份路径与期望恢复时间，从而预览恢复到期望时间所需要的数据备份集（`backup_set`）和日志归档（`archivelog_piece`）。

## 权限要求

执行该语句需要当前用户拥有 `ALTER SYSTEM` 权限。

## 语法

```sql
ALTER SYSTEM RESTORE FROM 'uri' UNTIL { TIME='timestamp' | SCN=scn } PREVIEW;

```

## 参数解释

| **参数** | **描述** |
| --- | --- |
| uri | 指定原始数据备份路径和日志归档的路径，使用英文逗号分隔。 |
| TIME='timestamp' \| SCN=scn | 指定期望恢复的时间戳或 SCN。执行该语句时，必须显式指定时间。 |

## 示例

- OSS

     - 指定原始数据备份路径和日志归档路径，并且期望恢复到恢复到指定 scn `1712650554000909004`。

      ```shell
      obclient [oceanbase]> ALTER SYSTEM RESTORE FROM 'oss://test_bucket/data?host=***&access_id=****&access_key=****, oss://test_bucket/archive?host=***&access_id=****&access_key=****' UNTIL SCN = 1712650554000909004 PREVIEW;

      ```
     - 指定原始数据备份路径和日志归档路径，并且期望恢复到指定时间戳 `2024-04-09 16:15:54`。

      ```shell
      obclient [oceanbase]> ALTER SYSTEM RESTORE FROM 'oss://test_bucket/data?host=***&access_id=****&access_key=****, oss://test_bucket/archive?host=***&access_id=****&access_key=****' UNTIL TIME = '2024-04-09 16:15:54' PREVIEW;

      ```
 - NFS

      ```shell
      obclient [oceanbase]> ALTER SYSTEM RESTORE FROM 'file:///ob_backup/data, file:///ob_backup/archive' UNTIL SCN = 1712650554000909004 PREVIEW;

      ```shell
      obclient [oceanbase]> ALTER SYSTEM RESTORE FROM 'file:///ob_backup/data, file:///ob_backup/archive' UNTIL TIME = '2024-04-09 16:15:54' PREVIEW;

      ```

## 相关文档

- [SHOW RESTORE PREVIEW](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576094)
 - [执行指定路径的恢复](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001573993)

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