ALTER OPERATOR FAMILY

名称

ALTER OPERATOR FAMILY -- 修改操作符族的定义

大纲

ALTER OPERATOR FAMILY name USING index_method ADD
  {  OPERATOR strategy_number operator_name ( op_type, op_type ) [ FOR SEARCH | FOR ORDER BY sort_family_name ]
   | FUNCTION support_number [ ( op_type [ , op_type ] ) ] function_name ( argument_type [, ...] )
  } [, ... ]
ALTER OPERATOR FAMILY name USING index_method DROP
  {  OPERATOR strategy_number ( op_type [ , op_type ] )
   | FUNCTION support_number ( op_type [ , op_type ] )
  } [, ... ]
ALTER OPERATOR FAMILY name USING index_method RENAME TO new_name
ALTER OPERATOR FAMILY name USING index_method OWNER TO new_owner
ALTER OPERATOR FAMILY name USING index_method SET SCHEMA new_schema

描述

ALTER OPERATOR FAMILY修改一个操作符族的定义。 你可以添加操作符和支持函数到该族、从该族中删除它们或修改该族的名字或所有者。

当使用ALTER OPERATOR FAMILY添加操作符和支持函数到一个族时, 它们不是该操作符族中任意指定操作符类的一部分,只是"松散"在该族中。 这表明这些操作符和函数与该族的语义兼容,但不是正确运行任何指定索引的所需。 (操作符和函数要成为索引的所需,应该被声明为一个操作符类的一部分;参阅 CREATE OPERATOR CLASS。)PostgreSQL 将允许一个族的松散成员在任何时候被从该族中删除,但是操作符类的成员不能被删除, 除非删除整个类和任何依赖于它的索引。典型的,单数据类型操作符和函数是操作符类的一部分, 因为需要它们支持一个特定数据类型的索引,而交叉数据类型操作符和函数由族的松散成员组成。

要使用ALTER OPERATOR FAMILY,你必须是一个超级用户。 (做这个限制是因为一个错误的操作符族定义会混淆或者甚至崩溃服务器。)

ALTER OPERATOR FAMILY 目前并不检查操作符族定义是否包括索引方法所需的所有操作符和函数, 也不检查操作符和函数是否来自一个自相一致的集合。定义一个有效的操作符族是用户的责任。

参阅第 35.14 节获取更多信息。

参数

name

一个现有操作符族的名字(可以有模式修饰)。

index_method

使用这个操作符族的索引方法的名字。

strategy_number

该索引方法的与该操作符族相关的一个操作符的策略数。

operator_name

与该操作符族相关的一个操作符的名字(可以有模式修饰)。

op_type

在一个OPERATOR子句中,该操作符的操作数的数据类型或NONE 表示一个左目或右目操作符。不像CREATE OPERATOR CLASS 中可比较的语法,必须总是指定操作数的数据类型。

在一个ADD FUNCTION子句中,函数的操作数的数据类型如果与该函数的输入数据类型不同, 则打算支持操作数的数据类型。对于B-tree比较函数和哈希函数,不需要指定 op_type, 因为函数的输入数据类型总是要使用的正确类型。对于B-tree排序支持函数和所有在GiST、 SP-GiST和GIN操作符类中的函数,必须指定该函数要使用的操作数的数据类型。

DROP FUNCTION子句中,打算支持的函数的操作数的数据类型必须指定。

sort_family_name

描述与一个排序操作符相关的排序顺序的现有btree操作符族的名字 (可以有模式修饰)。

如果既没有指定FOR SEARCH也没有指定FOR ORDER BY, 那么FOR SEARCH是缺省。

support_number

与该操作符族相关的一个函数的索引方法的支持过程数量。

function_name

该操作符族的索引方法支持过程的函数的名字(可以有模式修饰)。

argument_type

该函数的参数数据类型。

new_name

操作符族的新名字。

new_owner

操作符族的新所有者。

new_schema

操作符族的新模式。

OPERATORFUNCTION子句可以以任意顺序出现。

注意

请注意,DROP语法只指定了操作符族中的"位置", 通过策略或支持数和输入数据类型。占领该位置的操作符或函数的名字没有提及。 另外,对于DROP FUNCTION来说,要指定的类型是该函数打算支持的输入数据类型; 对于GiST、SP-GiST和GIN索引来说,可能与该函数的实际输入参数类型无关。

因为索引机制在使用函数之前并不检查函数上的访问权限, 包括一个操作符族中的函数或操作符相当于赋予了公共执行权限。 这对于操作符族中有用的函数的种类通常不是一个问题。

操作符不应该通过SQL函数定义。一个SQL函数可以内联到调用查询, 这将阻止优化器认识到该查询匹配一个索引。

PostgreSQL 8.4之前,OPERATOR子句 会包括一个RECHECK选项。现在不再支持这个了,因为一个索引操作符是否是 "松散的"决定了运行时的动态。这允许有效的处理操作符可能或可能不是松散的的情况。

例子

下列的示例命令添加了跨数据类型的操作符和支持函数到一个操作符族, 该操作符族早已包含数据类型int4int2的B-tree操作符类。

ALTER OPERATOR FAMILY integer_ops USING btree ADD

  -- int4 vs int2
  OPERATOR 1 < (int4, int2) ,
  OPERATOR 2 <= (int4, int2) ,
  OPERATOR 3 = (int4, int2) ,
  OPERATOR 4 >= (int4, int2) ,
  OPERATOR 5 > (int4, int2) ,
  FUNCTION 1 btint42cmp(int4, int2) ,

  -- int2 vs int4
  OPERATOR 1 < (int2, int4) ,
  OPERATOR 2 <= (int2, int4) ,
  OPERATOR 3 = (int2, int4) ,
  OPERATOR 4 >= (int2, int4) ,
  OPERATOR 5 > (int2, int4) ,
  FUNCTION 1 btint24cmp(int2, int4) ;

再次删除这些条目:

ALTER OPERATOR FAMILY integer_ops USING btree DROP

  -- int4 vs int2
  OPERATOR 1 (int4, int2) ,
  OPERATOR 2 (int4, int2) ,
  OPERATOR 3 (int4, int2) ,
  OPERATOR 4 (int4, int2) ,
  OPERATOR 5 (int4, int2) ,
  FUNCTION 1 (int4, int2) ,

  -- int2 vs int4
  OPERATOR 1 (int2, int4) ,
  OPERATOR 2 (int2, int4) ,
  OPERATOR 3 (int2, int4) ,
  OPERATOR 4 (int2, int4) ,
  OPERATOR 5 (int2, int4) ,
  FUNCTION 1 (int2, int4) ;

兼容性

SQL标准中没有ALTER OPERATOR FAMILY语句。

又见

CREATE OPERATOR FAMILY, DROP OPERATOR FAMILY, CREATE OPERATOR CLASS, ALTER OPERATOR CLASS, DROP OPERATOR CLASS