DROP VOLUME

描述

DROP VOLUME 删除指定名称的卷。如果架构中不存在该卷，则会抛出异常。
有关如何使用卷的详细信息，请参阅卷。

语法

DROP VOLUME [ IF EXISTS ] volume_identifier [ CASCADE ]

参数

• IF EXISTS

  如果指定，则仅在卷存在时删除该卷。如果系统中不存在已存在指定卷，则什么也不会发生（不会抛出异常）。

• volume_identifier

  指定要创建的卷名称。卷名称可选择使用数据库名称限定。

  语法: [ database_name. ] volume_name

• CASCADE

  如果指定，则删除卷及其所有相关对象。

示例

-- 创建带有注释的卷 `employee_photo`。
CREATE VOLUME employee_photo
    COMMENT 'Volume for photos of employees';
SHOW TABLES;
+--------+--------------+---------+----+--------------------+--------+------------------------------+
|database|     tableName|tableType|size|           createdAt|isShared|                   description|
+--------+--------------+---------+----+--------------------+--------+------------------------------+
| default|employee_photo|   volume|   0|2024-10-11 23:26:...|   false|Volume for photos of employees|
+--------+--------------+---------+----+--------------------+--------+------------------------------+

-- 删除卷 `employee_photo`。
DROP VOLUME employee_photo;

-- 检查卷已被删除。
SHOW TABLES;
+--------+---------+---------+----+---------+--------+-----------+
|database|tableName|tableType|size|createdAt|isShared|description|
+--------+---------+---------+----+---------+--------+-----------+
+--------+---------+---------+----+---------+--------+-----------+

相关语句

• CREATE VOLUME
• SHOW TABLES

TODO

• 实际上没处理restrict（parser里有）