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

StarRocks 中文参考:ALTER MATERIALIZED VIEW

· 52CE 我爱测

示例 12:为存算分离集群中的物化视图启用 File Bundling(自 v26.2 起支持)。同一条语句中只能设置 这一个属性。变更以异步作业的方式执行,可以通过 SHOW ALTER TABLE COLUMN 查看进度。修改 的限制与表相同,参见 CREATE TABLE 中的 属性。

ALTER MATERIALIZED VIEW

功能

此 SQL 语句可以:

  • 变更异步物化视图的名称

  • 变更异步物化视图的刷新策略

  • 变更异步物化视图的状态为 Active 或 Inactive

  • 原子替换异步物化视图

  • 在线变更 Range 分布异步物化视图的排序键,无需重建物化视图(自 v4.2 起支持)

  • 变更异步物化视图的属性

    您可以使用此 SQL 语句变更异步物化视图的以下属性:

    • bloom_filter_columns
    • partition_ttl_number
    • partition_refresh_number
    • partition_refresh_strategy
    • resource_group
    • auto_refresh_partitions_limit
    • excluded_trigger_tables
    • mv_rewrite_staleness_second
    • unique_constraints
    • foreign_key_constraints
    • colocate_with
    • excluded_refresh_tables
    • file_bundling(仅限存算分离集群,自 v26.2 起支持)
    • 所有 Session 变量属性。有关 Session 变量,详细信息请见 系统变量。
  • 该操作需要对应物化视图的 ALTER 权限。请参考 GRANT 为用户赋权。

  • ALTER MATERIALIZED VIEW 不支持直接修改构建物化视图的查询语句。您可以重新构建物化视图,并通过 ALTER MATERIALIZED VIEW SWAP WITH 将其与原始物化视图替换。

语法

ALTER MATERIALIZED VIEW [db_name.]<mv_name> 
    { RENAME [db_name.]<new_mv_name> 
    | REFRESH <new_refresh_scheme_desc> 
    | ACTIVE | INACTIVE 
    | SWAP WITH <mv2_name>
    | ORDER BY (<column_name> [, <column_name> ...])
    | SET ( "<key>" = "<value>"[,...]) }

参数

参数 必选 说明
mv_name 是 待变更的物化视图的名称。
new_refresh_scheme_desc 否 新的刷新机制,详细信息请见 SQL 参考 - CREATE MATERIALIZED VIEW - 参数。
new_mv_name 否 新的物化视图的名称。
ACTIVE 否 将物化视图的状态设置为 Active。如果物化视图的基表发生更改,例如被删除后重新创建,StarRocks 会自动将该物化视图的状态设置为 Inactive,以避免原始元数据与更改后的基表不匹配的情况。状态为 Inactive 的物化视图无法用于查询加速或改写。更改基表后,您可以使用此 SQL 将该物化视图的状态设置为 Active。
INACTIVE 否 将物化视图的状态设置为 Inactive。Inactive 状态的物化视图无法被刷新,但您仍然可以将其作为表直接查询。
SWAP WITH 否 同另一物化视图进行原子替换。替换前,StarRocks 会进行必要的一致性检查。
ORDER BY 否 在线将物化视图的排序键变更为指定的列,无需重建物化视图。仅支持存算分离集群中 Range 分布的异步物化视图(自 v4.2 起支持)。对于设置了 colocate_with 的物化视图,新排序键必须以 Colocated Column 开头,且这些列的顺序和类型不变。如果 colocate_with 只指定了 Colocation Group,而新排序键包含的列多于 Colocated Column,StarRocks 会将该属性改写为显式列出 Colocated Column 的形式 <colocation_group>:<colocated_column>[,<colocated_column>],此后 SHOW CREATE MATERIALIZED VIEW 中显示的即为该形式。指定的列必须是物化视图的输出列。对于明细(Duplicate Key)物化视图,排序键可以是任意列的子集;对于聚合(Aggregate)和更新(Unique Key)物化视图,排序键必须恰好由全部 Key 列组成。变更期间物化视图的刷新会被暂停,完成后自动恢复;变更期间物化视图仍可查询,新的排序顺序在切换时原子生效。
key 否 待变更的属性的名称,详细信息请见 SQL 参考 - CREATE MATERIALIZED VIEW - 参数。
说明
如需更改物化视图的 Session 变量属性,则必须为 Session 属性添加 session. 前缀,例如,session.insert_timeout。您无需为非 Session 属性指定前缀,例如,mv_rewrite_staleness_second。
value 否 待变更的属性的值。

示例

示例一:修改物化视图名称

ALTER MATERIALIZED VIEW lo_mv1 RENAME lo_mv1_new_name;

示例二:修改物化视图刷新间隔

ALTER MATERIALIZED VIEW lo_mv2 REFRESH SCHEDULE EVERY(INTERVAL 1 DAY);

示例三:修改物化视图属性,调整物化视图刷新 Timeout 为一小时(默认)。

ALTER MATERIALIZED VIEW mv1 SET ("session.insert_timeout" = "3600");

示例四:修改物化视图状态为 Active。

ALTER MATERIALIZED VIEW order_mv ACTIVE;

示例五:原子替换物化视图 order_mv 和 order_mv1。

ALTER MATERIALIZED VIEW order_mv SWAP WITH order_mv1;

示例六:为物化视图刷新开启 Profile(默认开启)。

ALTER MATERIALIZED VIEW mv1 SET ("session.enable_profile" = "true");

示例七:为物化视图刷新开启中间结果落盘(自 v3.1 起默认开启),并设置落盘模式为 force。

-- 为物化视图刷新开启中间结果落盘。
ALTER MATERIALIZED VIEW mv1 SET ("session.enable_spill" = "true");
-- 设置落盘模式为 `force`。
ALTER MATERIALIZED VIEW mv1 SET ("session.spill_mode" = "force");

示例八:调整 Optimizer Timeout 为 30 秒(自 v3.3 起为默认值),适用于物化视图查询包含外表或多个 Join。

ALTER MATERIALIZED VIEW mv1 SET ("session.new_planner_optimize_timeout" = "30000");

示例九:调整物化视图查询改写 Staleness 时间为 600 秒。

ALTER MATERIALIZED VIEW mv1 SET ("mv_rewrite_staleness_second" = "600");

示例 10:修改物化视图的 BloomFilter 索引。

ALTER MATERIALIZED VIEW mv1 SET ("bloom_filter_columns" = "col1, col2");

示例 11:在线将 Range 分布物化视图的排序键变更为 (k2, k1)(自 v4.2 起支持)。

ALTER MATERIALIZED VIEW order_mv ORDER BY (k2, k1);

示例 12:为存算分离集群中的物化视图启用 File Bundling(自 v26.2 起支持)。同一条语句中只能设置 file_bundling 这一个属性。变更以异步作业的方式执行,可以通过 SHOW ALTER TABLE COLUMN 查看进度。修改 file_bundling 的限制与表相同,参见 CREATE TABLE 中的 file_bundling 属性。

ALTER MATERIALIZED VIEW order_mv SET ("file_bundling" = "true");

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

资料来源与适用范围

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

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

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