STV_Rename_Index

为空间索引重命名。如果索引格式过期，则不能为索引重命名。

利用一个输入多边形集（可以是查询的结果），可以创建空间索引。空间索引是在全局命名空间中创建的。每当跨群集的节点对输入表或投影分段时，Vertica 会采用分布式计划。

OVER() 子句必须为空。

行为类型

不可变

语法

STV_Rename_Index( USING PARAMETERS
                  source = 'old_index_name',
                  dest = 'new_index_name',
                  overwrite = [ 'true' | 'false' ]
                )
                 OVER ()

参数

source = 'old_index_name'

空间索引的当前名称，类型为 VARCHAR。

dest = 'new_index_name'

空间索引的新名称，类型为 VARCHAR。

overwrite = [ 'true' | 'false' ]

用于指定是否覆盖索引的 BOOLEAN（如果存在索引）。此参数不能为 NULL。

默认值： False

特权

任何有权访问 STV_*_Index 函数的用户都可以描述、重命名或删除由其他任何用户创建的索引。

限制

• 索引名称不能超过 110 个字符。

• 索引名称中不允许使用反斜杠或制表符。

示例

以下示例显示了 STV_Rename_Index 的用法。

为索引重命名：

=> SELECT STV_Rename_Index (
       USING PARAMETERS
       source = 'my_polygons',
       dest = 'US_states',
       overwrite = 'false'
       )
       OVER ();
 rename_index
---------------
 Index renamed
(1 Row)