跳到主要内容
版本: 最新版本-3.5

DROP MATERIALIZED VIEW

DROP MATERIALIZED VIEW 语句用于删除物化视图。

无法使用该命令删除正在创建的同步物化视图。要删除正在创建的同步物化视图，请参阅同步物化视图 - 删除未完成的物化视图 以获取更多说明。

提示

该操作需要目标物化视图的 DROP 权限。

语法​

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

中括号 [] 中的参数是可选的。

参数​

参数必需描述
IF EXISTS否如果指定了此参数，则当删除不存在的物化视图时，StarRocks 不会抛出异常。 如果未指定此参数，则当删除不存在的物化视图时，系统将抛出异常。
mv_nameyes要删除的物化视图的名称。

示例​

示例 1：删除现有物化视图

  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)
  1. 删除物化视图 order_mv1。
DROP MATERIALIZED VIEW order_mv1;
  1. 检查删除的物化视图是否存在。
MySQL > SHOW MATERIALIZED VIEWS;
Empty set (0.01 sec)

示例 2：删除不存在的物化视图

  • 如果指定了参数 IF EXISTS，则当删除不存在的物化视图时，StarRocks 不会抛出异常。
MySQL > DROP MATERIALIZED VIEW IF EXISTS k1_k2;
Query OK, 0 rows affected (0.00 sec)
  • 如果未指定参数 IF EXISTS，则当删除不存在的物化视图时，系统将抛出异常。
MySQL > DROP MATERIALIZED VIEW k1_k2;
ERROR 1064 (HY000): Materialized view k1_k2 is not find