DROP SHARE
功能概述
DROP SHARE
DROP SHARE
语句用于删除已存在的 SHARE 对象。删除后，所有消费方实例将立即失去通过该 SHARE 访问数据的权限，且操作不可逆。
语法
DROP SHARE [ IF EXISTS ] share_name;
参数说明
| 参数 | 是否必填 | 说明 |
|---|
share_name
share_name | 是 | 要删除的 SHARE 名称 |
IF EXISTS
IF EXISTS | 否 | 若 SHARE 不存在则跳过，不报错 |
使用示例
示例 1：删除 SHARE
DROP SHARE sales_share;
示例 2：使用 IF EXISTS 避免报错
DROP SHARE IF EXISTS doc_test_share;
示例 3：删除前确认消费方
删除前，建议先查看该 SHARE 的消费方实例，确认影响范围：
SHOW SHARES WHERE KIND = 'OUTBOUND';
返回示例（
to_instance
to_instance
列显示已配置的消费方）：
+------------+----------+-------------------+--------------------+---------+-------------+---------+
| share_name | provider | provider_instance | provider_workspace | scope | to_instance | kind |
+------------+----------+-------------------+--------------------+---------+-------------+---------+
| sales_share| tyhfosmf | f8866243 | quick_start | PRIVATE | 49d58da9 | OUTBOUND|
+------------+----------+-------------------+--------------------+---------+-------------+---------+
确认无活跃消费方后再执行删除：
DROP SHARE sales_share;
注意事项
- 删除 SHARE 后，所有已配置的消费方实例将立即失去访问权限，可能导致消费方的查询或任务报错。
- 删除 SHARE 不会删除 SHARE 中包含的表或视图本身，只是移除共享关系。
- 操作不可逆，如需恢复共享，需重新创建 SHARE 并重新配置权限和消费方实例。
- 建议在删除前通知相关消费方，避免业务中断。
权限要求
执行
DROP SHARE
DROP SHARE
的用户需要具备对应 SHARE 的 DROP 权限或 OWNERSHIP。
相关语句
