---
title: "REFRESH_REPORT - OceanBase 数据库 V4.4.2 | OceanBase 文档中心"
description: REFRESH_REPORT 说明 对于 V4.4.2 版本，从 V4.4.2 BP2 版本开始引入 REFRESH_REPORT 。 REFRESH_REPORT 用于生成单次物化视图刷新任务的分层诊断报告。 使用限制及注意事项 refresh_id 与 mv_name 至少指定其一。 语法 DBMS_MVIEW.…
---
切换语言

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

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

# REFRESH_REPORT

更新时间：2026-07-15 15:27:40

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.4.2/zh-CN/700.reference/600.pl-reference/300.pl-oracle/1400.pl-system-package-oracle/9950.dbms-mview-oracle/500.refresh_report-oracle.md)

#### 说明

对于 V4.4.2 版本，从 V4.4.2 BP2 版本开始引入 `REFRESH_REPORT`。

`REFRESH_REPORT` 用于生成单次物化视图刷新任务的分层诊断报告。

## 使用限制及注意事项

`refresh_id` 与 `mv_name` 至少指定其一。

## 语法

```sql
DBMS_MVIEW.REFRESH_REPORT(
    {refresh_id | mv_name}
    [, format]
    [, tenant_id])

```

## 参数解释

| **参数** | **说明** |
| --- | --- |
| refresh_id | 物化视图刷新批次的唯一标识符，由新调度框架分配。   #### 说明    可以通过视图 [DBA_MVREF_RUN_STATS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005284061) 查看 `refresh_id` 信息。 |
| mv_name | 指定物化视图的名称（如 `SCHEMA.MV_NAME`）。 |
| format | 可选项，指定报告输出格式，取值如下：   - `XML`（默认值） - `JSON` |
| tenant_id | 当前仅 `sys` 租户可用，用于查询其他租户的物化视图刷新报告。 |

## 返回值说明

- 返回类型：`CLOB`。
 - 内容格式：取决于 `format` 参数，可为 `XML` 或 `JSON` 格式的文本内容。

## 示例

- 通过 `refresh_id` 获取 `XML` 格式的诊断报告。

  ```shell
  obclient> SELECT DBMS_MVIEW.REFRESH_REPORT(refresh_id=> 100023) FROM DUAL;

  ```
 - 获取 JSON 格式的报告。

  ```shell
  obclient> SELECT DBMS_MVIEW.REFRESH_REPORT(refresh_id=> 100023, format => 'JSON') FROM DUAL;

  ```
 - 通过物化视图名称获取最近一次刷新的报告。

  ```shell
  obclient> SELECT DBMS_MVIEW.REFRESH_REPORT(mv_name=> 'TEST.MV_SALES_DAILY') FROM DUAL;

  ```
 - `sys` 租户查询其他租户的刷新报告。

  ```shell
  obclient> SELECT DBMS_MVIEW.REFRESH_REPORT(refresh_id=> 100023, tenant_id=> 1002) FROM DUAL;

  ```

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