DROP_PARTITIONS

删除指定的表分区键。

这是元函数。您必须在顶级 SELECT 语句中调用元函数。

行为类型

语法

DROP_PARTITIONS (
    '[[database.]schema.]table‑name',
    'min‑range‑value',
    'max‑range‑value'
    [, 'force‑split']
)

参数

[database.]schema

数据库和架构。默认架构为 public。如果指定一个数据库，它必须是当前数据库。

table‑name

目标表。此表不能用作预联接投影中的维度表，且不能包含过期（未刷新）的投影。

min‑range‑value max‑range‑value

要删除的分区键的最小值和最大值，其中 min‑range‑value 必须 ≤ max‑range‑value。要删除某个分区键，min‑range‑value 和 max‑range‑value 必须相等。

force‑split

可选的布尔实参，指定如果分区键的范围跨越多个容器或单个容器的某些部分，是否拆分 ROS 容器：

• true：根据需要拆分 ROS 容器。

• false （默认值）：如果必须拆分 ROS 容器以实施此操作，则返回错误。

注意

在极少数情况下，DROP_PARTITIONS 与同一 ROS 容器上的合并操作同时执行。因此，此函数无法按指定设置拆分容器，并会返回错误。发生这种情况时，请再次调用 DROP_PARTITIONS。

特权

以下几项之一：

• DBADMIN

• 表所有者

• 对表架构的 USAGE 权限和对表的 TRUNCATE 权限

示例

请参阅删除分区。

另请参阅