大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:materialized_views

· 52CE 我爱测

# materialized_views 提供有关所有物化视图的信息。 提供以下字段: | **字段** | **描述** | | ------------------------------------ | ------------------------------------------------ | | MATERIALIZED_VIEW_ID | 物化视图 ID。 | | TABLE_SCHEMA | 物化视图所在的数据库名

materialized_views

materialized_views 提供有关所有物化视图的信息。

materialized_views 提供以下字段:

字段 描述
MATERIALIZED_VIEW_ID 物化视图 ID。
TABLE_SCHEMA 物化视图所在的数据库名称。
TABLE_NAME 物化视图名称。
REFRESH_TYPE 物化视图(刷新)类型,有效值:SYNC(同步物化视图)和 ASYNC(异步物化视图,无论以何种方式触发刷新)。当此值为 SYNC 时,以下生效状态和刷新相关的字段为空。异步物化视图的刷新方式请参见 REFRESH_TRIGGER 和 REFRESH_POLICY。
IS_ACTIVE 是否生效,失效的物化视图不会被刷新和查询改写。
INACTIVE_REASON 失效的原因。
PARTITION_TYPE 物化视图分区类型。
TASK_ID 物化视图刷新任务的 ID。
TASK_NAME 物化视图刷新任务的名称。
LAST_REFRESH_START_TIME 最近一次刷新任务的开始时间。
LAST_REFRESH_FINISHED_TIME 最近一次刷新任务的结束时间。
LAST_REFRESH_DURATION 最近一次刷新的墙钟耗时(秒):最后一个 task run 的完成时间减去第一个 task run 的开始执行时间。与该 job 在 materialized_view_refresh_jobs.DURATION_TIME 中的值一致。
LAST_REFRESH_STATE 最近一次刷新任务的状态。
LAST_REFRESH_FORCE_REFRESH 最近一次刷新任务是否强制刷新。
LAST_REFRESH_START_PARTITION 最近一次刷新任务的开始分区。
LAST_REFRESH_END_PARTITION 最近一次刷新任务的结束分区。
LAST_REFRESH_BASE_REFRESH_PARTITIONS 最近一次刷新任务的基表分区。
LAST_REFRESH_MV_REFRESH_PARTITIONS 最近一次刷新任务刷新的分区。
LAST_REFRESH_ERROR_CODE 最近一次刷新任务的错误码。
LAST_REFRESH_ERROR_MESSAGE 最近一次刷新任务的错误信息。
TABLE_ROWS 物化视图的数据行数,后台统计的近似值。
MATERIALIZED_VIEW_DEFINITION 物化视图的 SQL 定义。
EXTRA_MESSAGE 物化视图的额外信息。
QUERY_REWRITE_STATUS 物化视图的查询改写状态。
CREATOR 物化视图的创建者。
LAST_REFRESH_PROCESS_TIME 最近一次刷新任务的处理时间。
LAST_REFRESH_JOB_ID 最近一次刷新任务的作业 ID。
LAST_REFRESH_TIME 物化视图已反映基表更新的最新时间。
WAREHOUSE 异步物化视图执行刷新任务所使用的 warehouse 名称。在存算一体模式下,或对于同步(rollup)物化视图,该值为空。
REFRESH_MODE 异步物化视图配置的刷新模式。有效值:PCT(分区变更跟踪,仅刷新发生变更的分区)和 INCREMENTAL(增量视图维护)。对于同步物化视图为空。
REFRESH_TRIGGER 刷新的触发方式。有效值:NONE(同步物化视图)、MANUAL(仅通过 REFRESH MATERIALIZED VIEW 触发)、SCHEDULED(周期性触发,通过 EVERY 间隔)和 ON_BASE_TABLE_CHANGE(基表导入或变更时自动触发)。
REFRESH_POLICY 可读的刷新策略。有效值:NONE、MANUAL、ON_BASE_TABLE_CHANGE,或形如 START("yyyy-MM-dd HH:mm:ss") EVERY(INTERVAL n unit) 的调度(仅当定义了起始时间时才包含 START 子句)。
RESOURCE_GROUP 物化视图刷新任务所使用的资源组(来自物化视图的 resource_group 属性)。未设置时默认为 default_mv_wg。
QUERY_REWRITE_STATUS_REASON QUERY_REWRITE_STATUS 的原因。有效值:OK、MV_INACTIVE、QUERY_REWRITE_DISABLED、UNSUPPORTED_DEFINITION 和 UNKNOWN。
LAST_FRESHNESS_CONFIRMED_AT 最近一次成功刷新的开始时间,在整次刷新(其全部 task run)完成后才记录;确认基表无变化、无需刷新的刷新同样会确认新鲜度。物化视图反映该时刻的基表数据。区别于 LAST_REFRESH_TIME(基表数据版本时间),这是墙钟时间。首次成功刷新前、以及同步物化视图,为 NULL。按分区范围的 REFRESH(部分刷新)不推进该值。
BASE_TABLE_REFRESH_VERSION_TIMES 各基表的数据版本时间,以 JSON 对象给出:键为基表的 catalog.database.table 名称,值为观测到的最新数据版本时间。这是 LAST_REFRESH_TIME(所有基表的单一最大值)背后的按表明细:外部/数据湖基表上报分区源修改时间,OLAP(内部)基表上报可见版本提交时间。无任何基表有可记录时间时为 {}。本列仅在刷新成功时推进(失败或跳过的刷新不会改动它)。精度为 1 秒,同一秒内发生的写入与刷新无法区分。

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。