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

Apache Doris 中文参考:MV_INFOS

· 52CE 我爱测

## 描述 表函数,生成异步物化视图临时表,可以查看某个 db 中创建的异步物化视图信息。 ## 语法 ## 必填参数 (Required Parameters) ** ** > 指定需要查询的集群数据库名 ## 返回值 | 字段名称 | 类型 | 说明 | |-------------------------|---------|-----------------------------------------------------

描述

表函数,生成异步物化视图临时表,可以查看某个 db 中创建的异步物化视图信息。

语法

MV_INFOS("database"="<database>")

必填参数 (Required Parameters)

<database>

指定需要查询的集群数据库名

返回值

字段名称 类型 说明
Id BIGINT 物化视图 id
Name TEXT 物化视图 Name
JobName TEXT 物化视图对应的刷新 job 名称,可用于查询 jobs("type"="mv") 和 tasks("type"="mv")。
State TEXT 物化视图元数据状态。可取值:INIT、NORMAL、SCHEMA_CHANGE。
SchemaChangeDetail TEXT State 变为 SCHEMA_CHANGE 的原因。物化视图不处于 schema change 状态时通常为空。
RefreshState TEXT 最近一次刷新状态。可取值:INIT、SUCCESS、FAIL。
RefreshInfo TEXT 物化视图定义的刷新策略信息,包括构建方式、刷新方式和触发方式。
QuerySql TEXT 物化视图定义的查询语句
MvProperties TEXT 物化视属性
MvPartitionInfo TEXT 物化视图的分区信息
SyncWithBaseTables BOOLEAN 物化视图数据是否和基表数据同步。如需查看哪个分区不同步,请使用 SHOW PARTITIONS。
IvmBaseTableStreams TEXT IVM 基表与 Doris 自动创建的内部 Table Stream 映射。非 IVM 通常为空。

RefreshInfo 的展示格式为 BUILD <BuildMode> REFRESH <RefreshMethod> ON <RefreshTrigger> [schedule]。每一部分的含义见下面的枚举字段说明。

MV 信息枚举字段说明

查看物化视图定义和健康状态时,下面这些枚举字段最常用:

  • State:物化视图元数据状态。
    • INIT:物化视图已创建,但还没有进入正常可用的元数据状态。
    • NORMAL:物化视图元数据正常。大多数情况下应该是这个状态。
    • SCHEMA_CHANGE:基表或相关对象的 schema 变更影响了该物化视图。需要查看 SchemaChangeDetail 了解原因。此时物化视图通常仍可直接查询,但在刷新成功前可能不能用于透明改写。
  • RefreshState:最近一次刷新结果状态。
    • INIT:还没有记录刷新结果。
    • SUCCESS:最近一次刷新成功。
    • FAIL:最近一次刷新失败。可以用 JobName 查询 tasks("type"="mv"),查看失败 task 的 ErrorMsg。
  • RefreshInfo.BuildMode:Doris 什么时候构建物化视图数据。
    • IMMEDIATE:创建物化视图后立即构建。
    • DEFERRED:创建时不立即构建,需要后续刷新后才有新鲜数据。
  • RefreshInfo.RefreshMethod:Doris 如何选择要刷新的数据。
    • COMPLETE:总是全量刷新物化视图。
    • PARTITIONS:重新计算发生变化的物化视图分区。
    • INCREMENTAL:使用 物化视图增量维护(IVM)处理行级变化。
    • AUTO:Doris 自动选择 IVM、分区刷新或完整刷新。
  • RefreshInfo.RefreshTrigger:什么动作触发刷新 task。
    • MANUAL:手动触发刷新。
    • COMMIT:相关基表数据变更后触发刷新。
    • SCHEDULE:按调度周期触发刷新。调度细节会出现在 RefreshInfo 的 ON SCHEDULE 后面。
  • MvPartitionInfo.partitionType:物化视图的分区方式。
    • FOLLOW_BASE_TABLE:物化视图分区跟随基表分区列。
    • SELF_MANAGE:物化视图自己管理分区。
    • EXPR:物化视图使用表达式定义分区。
  • SyncWithBaseTables:物化视图数据是否和基表同步。
    • 1 或 true:已同步。
    • 0 或 false:未完全同步。对于分区物化视图,可以用 SHOW PARTITIONS FROM <mv_name> 查看分区级同步状态。
  • IvmBaseTableStreams:IVM 使用的基表与内部 Stream 映射。内部 Stream 由 Doris 管理,不要手工消费、重置或删除。详见 物化视图增量维护(IVM)。

示例

查看 test 数据库下名为 mv1 的物化视图。

select *
from mv_infos("database"="test")
where Name = "mv1"\G
*************************** 1. row ***************************
                Id: 19494
              Name: mv1
           JobName: inner_mtmv_19494
             State: NORMAL
SchemaChangeDetail:
      RefreshState: SUCCESS
       RefreshInfo: BUILD DEFERRED REFRESH AUTO ON MANUAL
          QuerySql: SELECT `internal`.`test`.`user`.`k2`, `internal`.`test`.`user`.`k3` FROM `internal`.`test`.`user`
      MvProperties: {partition_sync_limit=100, partition_sync_time_unit=YEAR}
   MvPartitionInfo: MTMVPartitionInfo{partitionType=FOLLOW_BASE_TABLE, relatedTable=user, relatedCol='k2', partitionCol='k2'}
SyncWithBaseTables: 1
IvmBaseTableStreams: \N

该结果中:

  • Id 和 Name 标识该物化视图。
  • JobName 是该物化视图的刷新 job 名称。可以通过该字段继续查询 job 或刷新 task,例如 select * from jobs("type"="mv") where Name = "inner_mtmv_19494";。
  • State 为 NORMAL,表示物化视图元数据状态正常。INIT 表示物化视图刚创建或初始化中;SCHEMA_CHANGE 表示基表 schema 变更影响了该物化视图,此时需要查看 SchemaChangeDetail。
  • SchemaChangeDetail 为空,因为当前 State 不是 SCHEMA_CHANGE。
  • RefreshState 为 SUCCESS,表示最近一次刷新成功。INIT 表示尚未记录成功刷新状态;FAIL 表示最近一次刷新失败,此时可使用 JobName 查询 tasks("type"="mv"),查看失败 task 的 ErrorMsg。
  • RefreshInfo 为 BUILD DEFERRED REFRESH AUTO ON MANUAL。BUILD DEFERRED 表示创建物化视图时不立即构建;REFRESH AUTO 表示 Doris 自动判断刷新全部分区还是部分分区;ON MANUAL 表示刷新由手动触发,而不是定时触发。
  • QuerySql 是物化视图定义的查询 SQL。
  • MvProperties 展示物化视图属性。本例中,分区同步由 partition_sync_limit=100 和 partition_sync_time_unit=YEAR 控制。
  • MvPartitionInfo 展示物化视图分区方式。FOLLOW_BASE_TABLE 表示跟随基表分区列;SELF_MANAGE 表示物化视图自己管理分区;EXPR 表示基于表达式定义分区。
  • SyncWithBaseTables 为 1,表示物化视图数据和基表数据同步。0 表示不完全同步。对于分区物化视图,可使用 SHOW PARTITIONS FROM <mv_name> 查看分区级同步状态。
  • IvmBaseTableStreams 为空,因为本例不是 IVM。

查看该物化视图最近一次刷新 task:

select *
from tasks("type"="mv")
where JobName = "inner_mtmv_19494"
order by CreateTime desc
limit 1;

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

资料来源与适用范围

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

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

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