REFRESH MATERIALIZED VIEW

功能

手动刷新指定异步物化视图或其中部分分区。

注意

您只能通过该命令手动刷新刷新方式为 ASYNC 或 MANUAL 的异步物化视图。您可以通过 SHOW MATERIALIZED VIEWS 查看物化视图的刷新方式。 该操作需要对应物化视图的 REFRESH 权限。

语法

REFRESH MATERIALIZED VIEW [database.]mv_name
[PARTITION START ("<partition_start_date>") END ("<partition_end_date>")]
[FORCE]
[WITH { SYNC | ASYNC } MODE]

参数

参数	必选	说明
mv_name	是	待手动刷新的异步物化视图名称。
PARTITION START () END ()	否	手动刷新该时间区间内的分区。
partition_start_date	否	待手动刷新的分区开始时间。
partition_end_date	否	待手动刷新的分区结束时间。
FORCE	否	如果指定该参数，StarRocks 将强制刷新相应的物化视图或分区。如果不指定该参数，StarRocks 会自动判断数据是否被更新过，只在需要时刷新分区。
WITH ... MODE	否	同步或异步调用刷新任务。SYNC 指同步调用刷新任务，执行 SQL 语句后，StarRocks 将在刷新任务成功或失败后返回结果。ASYNC 指异步调用刷新任务，执行 SQL 语句后，StarRocks 将在刷新任务提交后立即返回成功，实际刷新任务会异步在后台运行。您可以通过查询 StarRocks 的 Information Schema 中的 tasks 和 task_runs 元数据视图来查看异步物化视图的刷新状态。详细信息，请参考查看异步物化视图的执行状态。默认值：ASYNC。自 v2.5.8 和 v3.1.0 起支持。

注意

刷新基于外部数据目录（External Catalog）创建的异步物化视图时，StarRocks 会刷新所有分区。

监控

执行 REFRESH MATERIALIZED VIEW 后，你可以通过以下方式监控刷新操作的状态和结果：

• 执行 SHOW MATERIALIZED VIEWS 查看物化视图的状态，包括最后刷新时间、刷新状态和任何错误信息。
• 对于更详细的执行信息，特别是异步刷新任务，查询系统视图 information_schema.task_runs。此视图提供任务执行记录和状态（PENDING, RUNNING, SUCCESS, FAILED）。对于物化视图刷新，EXTRA_MESSAGE 字段包含关于每个刷新子任务的分区和执行详情的详细信息。详情请参见 理解物化视图 Task Run。

示例

示例一：异步调用任务手动刷新指定物化视图。

REFRESH MATERIALIZED VIEW lo_mv1;

REFRESH MATERIALIZED VIEW lo_mv1 WITH ASYNC MODE;

示例二：手动刷新物化视图指定分区。

REFRESH MATERIALIZED VIEW lo_mv1 
PARTITION START ("2020-02-01") END ("2020-03-01");

示例三：强制手动刷新物化视图指定分区。

REFRESH MATERIALIZED VIEW lo_mv1 
PARTITION START ("2020-02-01") END ("2020-03-01") FORCE;

示例四：同步调用任务手动刷新指定物化视图。

REFRESH MATERIALIZED VIEW lo_mv1 WITH SYNC MODE;