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

StarRocks 中文参考:DROP MATERIALIZED VIEW

· 52CE 我爱测

除非使用 **FORCE** 选项,否则此命令无法用于删除正在创建中的同步物化视图。使用 **FORCE** 时,StarRocks 会取消卡住的同步物化视图构建任务、将基表状态恢复为 NORMAL,然后删除物化视图。不使用 FORCE 时,请参考 同步物化视图 - 删除物化视图。

DROP MATERIALIZED VIEW

功能

删除物化视图。

除非使用 FORCE 选项,否则此命令无法用于删除正在创建中的同步物化视图。使用 FORCE 时,StarRocks 会取消卡住的同步物化视图构建任务、将基表状态恢复为 NORMAL,然后删除物化视图。不使用 FORCE 时,请参考 同步物化视图 - 删除物化视图。

注意

只有拥有对应物化视图 DROP 权限的用户才可以删除物化视图。

语法

DROP MATERIALIZED VIEW [IF EXISTS] [database.]mv_name [FORCE]

参数

参数 必选 说明
IF EXISTS 否 如果声明该参数,删除不存在的物化视图系统不会报错。如果不声明该参数,删除不存在的物化视图系统会报错。
mv_name 是 待删除的物化视图的名称。
FORCE 否 当基表处于非 NORMAL 状态(例如同步物化视图构建卡住)时,使用 FORCE 会取消相关 alter 任务、将表状态设为 NORMAL 后再删除物化视图。正常删除时可省略。

示例

示例一:删除存在的物化视图

  1. 查看当前数据库中存在的物化视图。

    MySQL > SHOW MATERIALIZED VIEWS\G
    *************************** 1. row ***************************
              id: 470740
            name: order_mv1
    database_name: default_cluster:sr_hub
            text: SELECT `sr_hub`.`orders`.`dt` AS `dt`, `sr_hub`.`orders`.`order_id` AS `order_id`, `sr_hub`.`orders`.`user_id` AS `user_id`, sum(`sr_hub`.`orders`.`cnt`) AS `total_cnt`, sum(`sr_hub`.`orders`.`revenue`) AS `total_revenue`, count(`sr_hub`.`orders`.`state`) AS `state_count` FROM `sr_hub`.`orders` GROUP BY `sr_hub`.`orders`.`dt`, `sr_hub`.`orders`.`order_id`, `sr_hub`.`orders`.`user_id`
            rows: 0
    1 rows in set (0.00 sec)
    
  2. 删除物化视图 order_mv1。

    DROP MATERIALIZED VIEW order_mv1;
    
  3. 删除后重新查看当前数据库中存在的物化视图将不会显示该物化视图。

    MySQL > SHOW MATERIALIZED VIEWS;
    Empty set (0.01 sec)
    

示例二:删除不存在的物化视图

  • 当未声明 IF EXISTS 参数时,删除一个不属于当前数据库的物化视图 k1_k2 会报错。
MySQL > DROP MATERIALIZED VIEW k1_k2;
ERROR 1064 (HY000): Materialized view k1_k2 is not found
  • 当声明 IF EXISTS 参数时,删除一个不属于当前数据库的物化视图 k1_k2 不会报错。
MySQL > DROP MATERIALIZED VIEW IF EXISTS k1_k2;
Query OK, 0 rows affected (0.00 sec)

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

资料来源与适用范围

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

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

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