REFRESH MATERIALIZED VIEW

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 表示同步调用刷新任务，StarRocks 仅在任务成功或失败时才返回任务结果。ASYNC 表示异步调用刷新任务，StarRocks 在任务提交后立即返回成功，并将任务留待在后台异步执行。您可以通过查询 StarRocks Information Schema 中的 tasks 和 task_runs 元数据视图来查看异步物化视图的刷新任务状态。更多信息，请参见 检查异步物化视图的执行状态。默认值：ASYNC。从 v2.5.8 和 v3.1.0 版本开始支持。

注意

当刷新基于外部 Catalog 创建的物化视图时，StarRocks 会刷新物化视图中的所有分区。

示例

示例 1：通过异步调用手动刷新特定的物化视图。

REFRESH MATERIALIZED VIEW lo_mv1;

REFRESH MATERIALIZED VIEW lo_mv1 WITH ASYNC MODE;

示例 2：手动刷新特定物化视图的某些分区。

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

示例 3：强制刷新特定物化视图的某些分区。

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

示例 4：通过同步调用手动刷新物化视图。

REFRESH MATERIALIZED VIEW lo_mv1 WITH SYNC MODE;