这部分包含那些 PostgreSQL 支持的 SQL 命令的信息.这里的 SQL 就是该语言通常的含义; 每条命令的与标准有关的兼容性的信息可以在相关的参考页中找到. Table of Contents ABORT -- 退出当前事务 ALTER GROUP -- 向组中增加用户或从组中删除用户 ALTER USER -- 改变
CREATE FUNCTION
CREATE FUNCTION
Name
CREATE FUNCTION -- 定义一个新函数
Synopsis
CREATE [ OR REPLACE ] FUNCTION name ( [ argtype [, ...] ] )
RETURNS rettype
AS 'definition'
LANGUAGE 'langname'
[ WITH ( attribute [, ...] ) ]
CREATE [ OR REPLACE ] FUNCTION name ( [ argtype [, ...] ] )
RETURNS rettype
AS 'obj_file' , 'link_symbol'
LANGUAGE langname
[ WITH ( attribute [, ...] ) ]
描述
CREATE FUNCTION定义一个新的函数. CREATE OR REPLACE FUNCTION 将要么创建一个新函数,要么替换现有的定义.
参数
name
要创建的函数名字.这个名字可以不是唯一的, 因为函数可以重载,胆识同名的函数必须有不同的参数类型.
argtype
该函数的数据类型(如果有).输入类型可以是基本类型,也可以是复合类型,opaque,或者和一个现有字段相同的类型. Opaque 表示该函数接受非 SQL 类型,比如 char *. 一个字段的类型是用 tablename.columnname%TYPE 表示的;使用这个东西可以帮助函数独立于表定义的修改.
rettype
返回数据类型.输出类型可以声明为一个基本类型,复合类型, setof 类型,opaque, 或者和现有字段同类型. setof 修饰词表示该函数将返回一套条目,而不是一条条目.返回类型声明为 opaque 的函数不返回数值.它们不能直接调用;触发器函数可以利用这个 特性.
definition
一个定义函数的字串;含义取决于语言.它可以是一个内部函数名字, 一个指向某个目标文件的路径,一个 SQL 查询,或者一个用过程语言 写的文本.
obj_file, link_symbol
这个形式的 AS 子句用于在函数的 C 源文件 名字和 SQL 函数的名字不同的时候动态联接 C 语言函数. 字串 obj_file 是包含可动态装载的对象的文件名,而 link_symbol 是对象的联接符号,也就是该函数在 C 源文件列的名字.
langname
可以是 SQL,C, internal,或者 plname,这里的 plname 是一种已创建过程语言的名字. 参阅 CREATE LANGUAGE获取细节. 为了保持向下兼容,该名字可以用单引号包围.
attribute
一段可选的有关该函数的信息,用于优化.见下文获取细节.
创建该函数的用户成为该函数所有者.
下面的属性可以出现在 WITH 子句里∶
iscachable
Iscachable 表示此函数在输入相同时总是返回相同的值 (也就是说, 它不做数据库查找或者是使用没有直接在它的参数列表出现的信息)。 优化器使用 iscachable 来认知对该函数的调用进行预先计算是否安全。
isstrict
isstrict 表明如果它的任何参数是 NULL,此函数总是返回 NULL. 如果声明了这个属性,则如果存在 NULL 参数时不会执行该函数; 而只是自动假设一个 NULL 结果.如果没有声明 isstrict 该函数将为 NULL 输入调用并进行处理. 那么剩下的事就是函数作者的责任来检查 NULL 是否必须并且做相应响应.
注意
请参阅 PostgreSQL 程序员手册 关于通过函数扩展 PostgreSQL 的章节获取更多关于书写外部函数的信息.
我们允许你将完整的 SQL 类型语法用于 输入参数和返回值.不过,有些类型声明的细节(比如, numeric 类型的精度域)是由下层函数实现负责的, 并且会被 CREATE FUNCTION 命令悄悄地吞掉. (也就是说,不再被识别或强制).
PostgreSQL 允许函数 重载;也就是说,同一个函数名可以用于几个不同的函数, 只要它们的参数可以区分它们。不过,这个功能在用于 internal(内部)和 C 语言 的函数时要小心。
两个 internal 函数拥有相同 C 名称时肯定会发生链接时错误。 要解决这个问题,给它们赋予不同的 C 名称(例如,使用参数类型做为 C 名称的一部分),然后在 CREATE FUNCTION 的 AS 子句里面声明这些名字。 如果 AS 子句为空,那么 CREATE FUNCTION 假设函数的 C 名称与SQL名称一样。
类似的还有,如果用多个 C 语言函数重载 SQL 函数, 给每个 C 语言函数的实例一个独立的名称,然后使用 CREATE FUNCTION 语法里的 AS 句的不同形式来选择每个重载的 SQL 函数的正确的 C 语言实现.
如果重复调用 CREATE FUNCTION,并且都指向同一个目标文件,那么该文件只装载一次.要卸载和恢复装载 该文件(可能是在开发过程中),你可以使用 LOAD命令.
使用 DROP FUNCTION 删除一个用户定义函数.
要更新现存函数的定义,用 CREATE OR REPLACE FUNCTION.请注意不可能用这种方法改变一个函数的名字或者参数类型 (如果你这么干,你只是会创建一个新的,不同的函数). 同样,CREATE OR REPLACE FUNCTION 也不会 让你改变一个现存函数的返回类型.要干这些事,你必须删除并 重新创建该函数.
如果你删除然后重新创建一个函数,新函数和旧的并非相同实体; 你会破坏现存的引用了原有函数的规则,视图,触发器等等.使用 CREATE OR REPLACE FUNCTION 可以改变一个函数的定义而又不会破坏引用该函数的对象.
例子
要创建一个简单的 SQL 函数∶
CREATE FUNCTION one() RETURNS integer
AS 'SELECT 1 AS RESULT;'
LANGUAGE SQL;
SELECT one() AS answer;
answer
----
1
这个例子通过调用一个用户创建的名为 funcs.so (扩展名因平台而异)的共享库过程创建一个 C 函数. 该共享库文件应该位于服务器的动态搜索路径里.该路径计算一个检测位并且如果函数参数里的检测位 正确就返回一个 TRUE .这些可以通过用一个 CHECK 约束实现的.
CREATE FUNCTION ean_checkdigit(char, char) RETURNS boolean
AS 'funcs' LANGUAGE C;
CREATE TABLE product (
id char(8) PRIMARY KEY,
eanprefix char(8) CHECK (eanprefix ~ '[0-9]{2}-[0-9]{5}')
REFERENCES brandname(ean_prefix),
eancode char(6) CHECK (eancode ~ '[0-9]{6}'),
CONSTRAINT ean CHECK (ean_checkdigit(eanprefix, eancode))
);
这个例子创建一个在用户定义类型 complex 和内部类型 point 之间做类型转换的函数。该函数是用一个从 C 源代码编译的 动态装载的对象来实现的。(我们演示了使用声明共享目标文件 的准确路径名的过时方法). 对于 PostgreSQL 而言, 要自动寻找类型转换函数,SQL 函数必须和返回类型同名,因而重载是不可避免的。 该函数名通过使用 SQL定义里 AS 子句的第二种类型来重载:
CREATE FUNCTION point(complex) RETURNS point
AS '/home/bernie/pgsql/lib/complex.so', 'complex_to_point'
LANGUAGE C;
该函数的 C 声明可以是∶
Point * complex_to_point (Complex *z)
{
Point *p;
p = (Point *) palloc(sizeof(Point));
p->x = z->x;
p->y = z->y;
return p;
}
兼容性 SQL92
在 SQL99 里的确定义了一个CREATE FUNCTION PostgreSQL 的和它类似但是不兼容.这个属性是不可移植的,可以使用的不同语言也是如此.
又见
DROP FUNCTION , LOAD, PostgreSQL程序员手册
----------------------------
CREATE FUNCTION
Name
CREATE FUNCTION -- 定义一个新函数
Synopsis
CREATE [ OR REPLACE ] FUNCTION name ( [ argtype [, ...] ] )
RETURNS rettype
AS 'definition'
LANGUAGE 'langname'
[ WITH ( attribute [, ...] ) ]
CREATE [ OR REPLACE ] FUNCTION name ( [ argtype [, ...] ] )
RETURNS rettype
AS 'obj_file' , 'link_symbol'
LANGUAGE langname
[ WITH ( attribute [, ...] ) ]
描述
CREATE FUNCTION定义一个新的函数. CREATE OR REPLACE FUNCTION 将要么创建一个新函数,要么替换现有的定义.
参数
name
要创建的函数名字.这个名字可以不是唯一的, 因为函数可以重载,胆识同名的函数必须有不同的参数类型.
argtype
该函数的数据类型(如果有).输入类型可以是基本类型,也可以是复合类型,opaque,或者和一个现有字段相同的类型. Opaque 表示该函数接受非 SQL 类型,比如 char *. 一个字段的类型是用 tablename.columnname%TYPE 表示的;使用这个东西可以帮助函数独立于表定义的修改.
rettype
返回数据类型.输出类型可以声明为一个基本类型,复合类型, setof 类型,opaque, 或者和现有字段同类型. setof 修饰词表示该函数将返回一套条目,而不是一条条目.返回类型声明为 opaque 的函数不返回数值.它们不能直接调用;触发器函数可以利用这个 特性.
definition
一个定义函数的字串;含义取决于语言.它可以是一个内部函数名字, 一个指向某个目标文件的路径,一个 SQL 查询,或者一个用过程语言 写的文本.
obj_file, link_symbol
这个形式的 AS 子句用于在函数的 C 源文件 名字和 SQL 函数的名字不同的时候动态联接 C 语言函数. 字串 obj_file 是包含可动态装载的对象的文件名,而 link_symbol 是对象的联接符号,也就是该函数在 C 源文件列的名字.
langname
可以是 SQL,C, internal,或者 plname,这里的 plname 是一种已创建过程语言的名字. 参阅 CREATE LANGUAGE获取细节. 为了保持向下兼容,该名字可以用单引号包围.
attribute
一段可选的有关该函数的信息,用于优化.见下文获取细节.
创建该函数的用户成为该函数所有者.
下面的属性可以出现在 WITH 子句里∶
iscachable
Iscachable 表示此函数在输入相同时总是返回相同的值 (也就是说, 它不做数据库查找或者是使用没有直接在它的参数列表出现的信息)。 优化器使用 iscachable 来认知对该函数的调用进行预先计算是否安全。
isstrict
isstrict 表明如果它的任何参数是 NULL,此函数总是返回 NULL. 如果声明了这个属性,则如果存在 NULL 参数时不会执行该函数; 而只是自动假设一个 NULL 结果.如果没有声明 isstrict 该函数将为 NULL 输入调用并进行处理. 那么剩下的事就是函数作者的责任来检查 NULL 是否必须并且做相应响应.
注意
请参阅 PostgreSQL 程序员手册 关于通过函数扩展 PostgreSQL 的章节获取更多关于书写外部函数的信息.
我们允许你将完整的 SQL 类型语法用于 输入参数和返回值.不过,有些类型声明的细节(比如, numeric 类型的精度域)是由下层函数实现负责的, 并且会被 CREATE FUNCTION 命令悄悄地吞掉. (也就是说,不再被识别或强制).
PostgreSQL 允许函数 重载;也就是说,同一个函数名可以用于几个不同的函数, 只要它们的参数可以区分它们。不过,这个功能在用于 internal(内部)和 C 语言 的函数时要小心。
两个 internal 函数拥有相同 C 名称时肯定会发生链接时错误。 要解决这个问题,给它们赋予不同的 C 名称(例如,使用参数类型做为 C 名称的一部分),然后在 CREATE FUNCTION 的 AS 子句里面声明这些名字。 如果 AS 子句为空,那么 CREATE FUNCTION 假设函数的 C 名称与SQL名称一样。
类似的还有,如果用多个 C 语言函数重载 SQL 函数, 给每个 C 语言函数的实例一个独立的名称,然后使用 CREATE FUNCTION 语法里的 AS 句的不同形式来选择每个重载的 SQL 函数的正确的 C 语言实现.
如果重复调用 CREATE FUNCTION,并且都指向同一个目标文件,那么该文件只装载一次.要卸载和恢复装载 该文件(可能是在开发过程中),你可以使用 LOAD命令.
使用 DROP FUNCTION 删除一个用户定义函数.
要更新现存函数的定义,用 CREATE OR REPLACE FUNCTION.请注意不可能用这种方法改变一个函数的名字或者参数类型 (如果你这么干,你只是会创建一个新的,不同的函数). 同样,CREATE OR REPLACE FUNCTION 也不会 让你改变一个现存函数的返回类型.要干这些事,你必须删除并 重新创建该函数.
如果你删除然后重新创建一个函数,新函数和旧的并非相同实体; 你会破坏现存的引用了原有函数的规则,视图,触发器等等.使用 CREATE OR REPLACE FUNCTION 可以改变一个函数的定义而又不会破坏引用该函数的对象.
例子
要创建一个简单的 SQL 函数∶
CREATE FUNCTION one() RETURNS integer
AS 'SELECT 1 AS RESULT;'
LANGUAGE SQL;
SELECT one() AS answer;
answer
----
1
这个例子通过调用一个用户创建的名为 funcs.so (扩展名因平台而异)的共享库过程创建一个 C 函数. 该共享库文件应该位于服务器的动态搜索路径里.该路径计算一个检测位并且如果函数参数里的检测位 正确就返回一个 TRUE .这些可以通过用一个 CHECK 约束实现的.
CREATE FUNCTION ean_checkdigit(char, char) RETURNS boolean
AS 'funcs' LANGUAGE C;
CREATE TABLE product (
id char(8) PRIMARY KEY,
eanprefix char(8) CHECK (eanprefix ~ '[0-9]{2}-[0-9]{5}')
REFERENCES brandname(ean_prefix),
eancode char(6) CHECK (eancode ~ '[0-9]{6}'),
CONSTRAINT ean CHECK (ean_checkdigit(eanprefix, eancode))
);
这个例子创建一个在用户定义类型 complex 和内部类型 point 之间做类型转换的函数。该函数是用一个从 C 源代码编译的 动态装载的对象来实现的。(我们演示了使用声明共享目标文件 的准确路径名的过时方法). 对于 PostgreSQL 而言, 要自动寻找类型转换函数,SQL 函数必须和返回类型同名,因而重载是不可避免的。 该函数名通过使用 SQL定义里 AS 子句的第二种类型来重载:
CREATE FUNCTION point(complex) RETURNS point
AS '/home/bernie/pgsql/lib/complex.so', 'complex_to_point'
LANGUAGE C;
该函数的 C 声明可以是∶
Point * complex_to_point (Complex *z)
{
Point *p;
p = (Point *) palloc(sizeof(Point));
p->x = z->x;
p->y = z->y;
return p;
}
兼容性 SQL92
在 SQL99 里的确定义了一个CREATE FUNCTION PostgreSQL 的和它类似但是不兼容.这个属性是不可移植的,可以使用的不同语言也是如此.
又见
DROP FUNCTION , LOAD, PostgreSQL程序员手册
----------------------------
CREATE GROUP
CREATE GROUP
Name
CREATE GROUP -- 定义一个新的用户组
Synopsis
CREATE GROUP name [ [ WITH ] option [ ... ] ]
这里 option 可以是∶
SYSID gid
| USER username [, ...]
输入
name
组名。
gid
SYSID 子句可以用于选择 PostgreSQL 里新组的组标识(group id)。 不过,这样做不是必须的。
如果没有声明这个,将使用从 1 开始的,已分配的最高组标识加一作为缺省值。
username
包括到组里面的用户列表。用户必须已经存在。
输出
CREATE GROUP
成功创建组后的返回。
描述
CREATE GROUP 将在数据库节点上创建一个新组。参考管理员手册获取关于使用组来认证的信息。 要使用这条命令, 你必须是数据库超级用户。
使用 ALTER GROUP修改组成员,DROP GROUP删除一个组。
用法
创建一个空组:
CREATE GROUP staff
创建一个有成员的组:
CREATE GROUP marketing WITH USER jonathan, david
兼容性 SQL92
里没有 CREATE GROUP 。Roles 在概念上与组类似。
----------------------------
CREATE LANGUAGE
CREATE LANGUAGE
Name
CREATE LANGUAGE -- 定义一种新的过程语言
Synopsis
CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE langname
HANDLER call_handler
描述
使用 CREATE LANGUAGE, 一个PostgreSQL 用户可以在 PostgreSQL里注册一个新的语言.因而,函数和触发器过程可以用这种新语言定义.要注册新 语言用户必须具有 PostgreSQL 超级用户权限.
CREATE LANGUAGE将该语言的名字和一个调用句柄 关联起来,而该调用句柄负责执行该语言书写的函数.请参考程序员手册获取有关语言调用句柄的 更多信息.
请注意过程语言是对每个独立的数据库而言是自己的. 要让一种语言缺省时可以为所有数据库获得,那你应该把它安装到 template1 数据库里.
参数
TRUSTED
TRUSTED 说明对该语言的调用句柄是安全的;也就是说,它不会提供给非特权用户任何绕过访问限制的能力. 如果忽略这个关键字,只有具有 PostgreSQL 超级用户权限的人可以使用这个语言创建新的函数.
PROCEDURAL
这是个没有用的字.
langname
新的过程化语言的名称.语言名是大小写无关的. 一个过程化语言不能覆盖 PostgreSQL内置的语言.
出于向下兼容的原因,这个名字可以用单引号包围.
HANDLER call_handler
call_handler是一个以前注册过的函数的名字,该函数将被调用来执行这门过程语言写的函数.过程语言的调用句柄必须用一种编译语言书写,比如 C,调用风格必须 是版本 1 的调用风格,并且在 PostgreSQL 里注册为不接受参数并且返回 opaque 类型的函数, (opaque 是用于未声明或未定义类型的占位符). undefined types.
诊断
CREATE
如果语言成功创建,返回此信息.
ERROR: PL handler function funcname() doesn't exist
如果没有找到函数 funcname(), 则返回此信息.
注意
这条命令通常不应该由用户直接执行. 对于 PostgreSQL 版本里提供的过程语言,我们应该使用 createlang脚本, 它将为我们安装正确的调用句柄. (createlang 也会在内部调用 CREATE LANGUAGE.)
使用 CREATE FUNCTION 命令创建新函数.
使用 DROP LANGUAGE,或者更好是 droplang脚本删除一个过程语言.
系统表 pg_language 记录了更多有关 当前安装的过程语言的信息.
Table "pg_language"
Attribute | Type | Modifier
-----+---+----
lanname | name |
lanispl | boolean |
lanpltrusted | boolean |
lanplcallfoid | oid |
lancompiler | text |
lanname | lanispl | lanpltrusted | lanplcallfoid | lancompiler
-----+---+------+-----+-----
internal | f | f | 0 | n/a
C | f | f | 0 | /bin/cc
sql | f | f | 0 | postgres
目前,一种过程语言创建之后它的定义就不能再更改.
例子
下面两条顺序执行的命令将注册一门新的过程语言及其关联的调用句柄.
CREATE FUNCTION plsample_call_handler () RETURNS opaque
AS '$libdir/plsample'
LANGUAGE C;
CREATE LANGUAGE plsample
HANDLER plsample_call_handler;
兼容性 SQL92
CREATE LANGUAGE是 PostgreSQL 扩展.
历史
CREATE LANGUAGE命令第一次出现在 PostgreSQL 6.3.
又见
createlang, CREATE FUNCTION , droplang, DROP LANGUAGE, PostgreSQL 程序员手册
----------------------------
CREATE OPERATOR
CREATE OPERATOR
Name
CREATE OPERATOR -- 定义一个新的操作符
Synopsis
CREATE OPERATOR name ( PROCEDURE = func_name
[, LEFTARG = lefttype
] [, RIGHTARG = righttype ]
[, COMMUTATOR = com_op ] [, NEGATOR = neg_op ]
[, RESTRICT = res_proc ] [, JOIN = join_proc ]
[, HASHES ] [, SORT1 = left_sort_op ] [, SORT2 = right_sort_op ] )
输入
name
要定义的操作符。可用的字符见下文。
func_name
用于实现该操作符的函数。
lefttype
如果存在的话,操作符左手边的参数类型. 如果是左目操作符,这个参数可以省略。
righttype
如果存在的话,操作符右手边的参数类型. 如果是右目操作符,这个参数可以省略。
com_op
该操作符对应的交换(commutator)操作符。
neg_op
对应的负操作符。
res_proc
此操作符约束选择性计算函数。
join_proc
此操作符连接选择性计算函数。
HASHES
表明此操作符支持哈希(散列)连接。
left_sort_op
如果此操作符支持融合连接(join),此操作符的左手边数据的排序操作符。
right_sort_op
如果此操作符支持融合连接(join),此操作符的右手边数据的排序操作符。
输出
CREATE
成功创建操作符后的返回信息.
描述
CREATE OPERATOR定义一个新的操作符, name. 定义该操作符的用户成为其所有者.
操作符 name 是一个最多NAMEDATALEN-1 长的(缺省为 31 个)下列字符组成的字串:
+ - * / < > = ~ ! @ # % ^ & | ` ? $
你选择名字的时候有几个限制:
"$" 和 ":" 不能定义为单字符操作符, 但是它们可以是一个多字符操作符的名称的一部分.
"--" 和 "/*" 不能在操作符名字的任何地方出现, 因为它们会被认为是一个注释的开始.
一个多字符的操作符名字不能以 "+" 或 "-" 结尾, 除非该名字还包含至少下面字符之一:
~ ! @ # % ^ & | ` ? $
例如, @- 是一个允许的操作符名, 但 *- 不是. 这个限制允许 PostgreSQL 分析 SQL-有问题的查询而不要求在符号之间有空白.
注意: 当使用非 SQL-标准操作符名时, 你通常将需要用空白把联接的操作符分离开以避免含混.例如,如果你定义了一个左目操作符,名为 "@",你不能写
X*@Y;你必须写成 X* @Y 以保证 PostgreSQL 把它读做两个操作符而不是一个.
操作符 "!=" 在输入时映射成 "<>", 因此这两个名称总是相等的.
至少需要定义一个 LEFTARG 或 RIGHTARG. 对于双目操作符来说,两者都需要定义. 对右目操作符来说,只需要定义 LEFTARG, 而对于左目操作符来说,只需要定义 RIGHTARG.
同样, func_name 过程必须已经用 CREATE FUNCTION 定义过, 而且必须定义为接受正确数量的指定类型参数(一个或是两个).
如果存在换向操作符则必须指明,这样 PostgreSQL 可以按它的意愿转换操作符的方向.例如,操作符面积小于, <<<, 很有可能有一个转换操作符:面积大于操作符, >>>. 因此,查询优化器可以自由的将下面查询从:
box '((0,0), (1,1))' >>> MYBOXES.description
转换到
MYBOXES.description <<< box '((0,0), (1,1))'
这就允许执行代码总是使用后面的形式而某种程度上简化了查询优化器.
类似地,如果存在负号操作符则也应该声明。 假设一个操作符,面积相等, ===,存在,同样有一个面积不等操作符, !==. 负号操作符允许查询优化器将
NOT MYBOXES.description === box '((0,0), (1,1))'
简化成
MYBOXES.description !== box '((0,0), (1,1))'
如果提供了一个交换操作符名称, PostgreSQL 将在表中查找它.如果找到,而且其本身没有一个交换符,那么交换符表将被更新,以当前(最 新)创建的操作符作为它的交换符.这一点一样适用于负号操作符. 这就允许定义两个互为交换符或负号符的操作符.第一个操作符应该定义为没有交换符 或负号符(as appropriate). 当定义第二个操作符时,将第一个符号作为交换符或负号符.第一个将因上述的副作用一样被更新(而获得交换符 或负号符).(对于PostgreSQL 6.5, 把两个操作符指向对方同样也行。)
HASHES,SORT1 和 SORT2 选项将为查询优化器进行连接查询时提供支持. PostgreSQL 能够总是用反复替换来计算一个连接(也就是说,处理这样的子句,该子句有两个元组变量, 这两个变量被一个操作符分开,这个操作符返回一个boolean量) [WONG76]. 另外, PostgreSQL 可以延着 [SHAP86]实现一个散列-连接算法(hash-join algorithm);但是,我们必须知道这个策略是否可行.目前的散列-连接算法只是对代表相等 测试的操作符有效;而且,数据类型的相等必须意味着类型的表现是按位相等的。 (例如,一个包含未用的位的数据类型,这些位对相等测试没有影响,但却不能用于哈希连接。)HASHES 标记告诉优化器, 对这个操作符可以安全地使用哈希连接。
类似的,两目排序操作符告诉查询优化器一个融合-排序 (merge-sort)是否是一个可用的连接策略,并且告诉优化器使用哪个操作符来对这两个操 作数表排序.排序操作符应该只提供给相等操作符, 并且它们应该对应用于相应的左边和右边数据类型的小于操作符。
如果发现有其他联合策略可用, PostgreSQL 将更改优化器和运行时系统以利用这些策略,并且在定义一个操作符时将需要更多的声明.幸运的是,研究 团队不经常发明新的联合策略, 而且增加用户定义联合策略的方法看来与其实现的复杂性相比是不值得的。
RESTRICT 和 JOIN 选项帮助优化器计算结果的尺寸大小.如果像下面的语句:
MYBOXES.description <<< box '((0,0),(1,1))'
在判断条件中出现,那么 PostgreSQL 将不得不估计 MYBOXES 中满足该子句的记录数量的范围的大小. 函数 res_proc 必需是一个注册过的函数(也就是说它已经用 CREATE FUNCTION定义过了),它接受一个正确数据的数据类型作为参数,返回一个浮点数. 查询优化器只是简单的调 用这个函数,将参数 ((0,0),(1,1)) 传入并且把结果乘以关系(表)尺寸以获得所需要的记录的数值。
类似的,当操作符的两个操作数都包含记录变量时, 优化器必须计算联合结果的尺寸. 函数 join_proc 将返回另一个浮点数,这个数就是将两个表相关 的记录相乘,计算出预期结果的尺寸.
函数
my_procedure_1 (MYBOXES.description, box '((0,0), (1,1))')
和操作符
MYBOXES.description === box '((0,0), (1,1))'
之间的区别是 PostgreSQL 试图优化操作符并且可以决定使用索引来缩小相关操作符的搜索区间.但是,对函数将不会有任何优化的动作,而且是强制 执行.最后,函数可有任意个参数,而操作符限于一个或两个.
注意
请参阅 PostgreSQL 用户手册 中操作符章节获取更多信息.请使用 DROP OPERATOR 从数据库中删除用户定义操作符.
用法
下面命令定义一个新操作符,面积相等,用于 BOX 数据类型.
CREATE OPERATOR === (
LEFTARG = box,
RIGHTARG = box,
PROCEDURE = area_equal_procedure,
COMMUTATOR = ===,
NEGATOR = !==,
RESTRICT = area_restriction_procedure,
JOIN = area_join_procedure,
HASHES,
SORT1 = <<<,
SORT2 = <<<
);
兼容性 SQL92
CREATE OPERATOR是 PostgreSQL 扩展. 在中没有 CREATE OPERATOR 语句.
----------------------------
CREATE RULE
CREATE RULE
Name
CREATE RULE -- 定义一个新的重写规则
Synopsis
CREATE RULE name AS ON event
TO object [ WHERE condition ]
DO [ INSTEAD ] action
这里 action 可以是:
NOTHING
|
query
|
( query ; query ... )
|
[ query ; query ... ]
输入
name
创建的规则名.
event
事件是 SELECT, UPDATE,DELETE 或 INSERT 之一.
object
对象是 table 或 table.column.(目前只有 table 形式实际上是实现了的.
condition
任意 SQL 布尔条件表达式.条件表达式除了引用 new 和 old 之外不能引用任何表.
query
组成 action 的查询可以是任何 SQL SELECT,INSERT, UPDATE,DELETE,或 NOTIFY 语句之一.
在 condition 和 action 里,特殊表名字 new 和 old 可以用于指向引用表 ( object) 里的数值 new 在 ON INSERT 和 ON UPDATE 规则里 可以指向被插入或更新的新行. old 在 ON UPDATE,和 ON DELETE 规则里可以指向现存的被更新,或者删除的行.
输出
CREATE
成功创建规则后的返回信息.
描述
PostgreSQL 规则系统 允许我们在从数据库或表中更新, 插入或删除东西时定义一个可选的动作来执行。目前,规则用于实现表视图。
规则的语意是在一个单独的记录正被访问,更新,插入或删除时, 将存在一个旧记录(用于检索,更新和删除)和一个新记录 (用于更新和追加).这时给定事件类型和给定目标对象(表)的所有规则都将被检查, (顺序不定). 如果在 WHERE (如果有)子句里面所声明的 condition? 为真,那么 action 部分的规则就被执行. 如果声明了 INSTEAD,那么 action 就会代替原来的查询;否则,如果是 ON INSERT 那么它在原来的查询之后执行,如果是 ON UPDATE 或者 ON DELETE,那么它在原来的查询之前执行.在 condition 和 action 里面, 在旧记录里字段的数值和/或新记录里字段的数值被 old. attribute-name 和 new. attribute-name 代替.
规则的 action 部分可以由一条或者多条查询组成.要写多个查询,用圆括弧或者方括弧 把它们包围起来. 这样的查询将以声明的顺序执行(只是我们不能保证对一个对象的多个规则的执行顺序). action 还可以是 NOTHING 表示没有动作.因此,一个 DO INSTEAD NOTHING 规则制止了原来的查询的运行(当条件为真时); DO NOTHING 规则是没有用的.
规则的 action 部分 执行的时候带有和触发动作的用户命令相同的命令和事务标识符.
规则和视图
目前,ON SELECT 规则必须是无条件的 INSTEAD 规则并且 必须有一个由一条 SELECT 查询组成的动作.因此,一条 ON SELECT 规则有效地把对象表转成视图,它的可见内容 是规则的 SELECT 查询返回的记录而不是存储在表中的内容(如果有的话). 我们认为写一条 CREATE VIEW 命令比创建一个表然后定义一条 ON SELECT 规则在上面的风格要好.
CREATE VIEW 创建一个虚拟表(没有下层的存储) 以及相关的 ON SELECT 规则.系统不允许对视图进行更新, 因为它知道在视图上没有真正的表.你可以创建一个可以更新的视图的幻觉, 方法是在视图上定义 ON INSERT,ON UPDATE,和 ON DELETE 规则 (或者满足你需要的任何上述规则的子集),用合适的对其它表的更新替换 在视图上更新的动作.
如果你想在视图更新上使用条件规则,那么这里就有一个补充∶ 对你希望在视图上允许的每个动作,你都必须有一个无条件的 INSTEAD 规则.如果规则是有条件的,或者它不是 INSTEAD, 那么系统仍将拒绝执行更新动作的企图,因为它认为它最终会在某种 程度上在虚拟表上执行动作. 如果你想处理条件规则上的所由有用的情况,那也可以;只需要增加一个无条件的 DO INSTEAD NOTHING 规则确保系统明白它将决不会被 调用来更新虚拟表就可以了.然后把条件规则做成非 INSTEAD; 在这种情况下,如果它们被触发,那么它们就增加到缺省的 INSTEAD NOTHING 动作中.
注意
为了在表上定义规则,你必须有规则定义权限. 用 GRANT 和 REVOKE 修改权限.
有一件很重要的事情是要避免循环规则. 比如,尽管下面两条规则定义都是 PostgreSQL 可以接受的, select 命令会导致 PostgreSQL 报告 一条错误信息,因为该查询循环了太多次:
CREATE RULE bad_rule_combination_1 AS
ON SELECT TO emp
DO INSTEAD
SELECT * FROM toyemp;
CREATE RULE bad_rule_combination_2 AS
ON SELECT TO toyemp
DO INSTEAD
SELECT * FROM emp;
下面这个对 EMP 的查询企图将导致 PostgreSQL 产生一个错误信息, 因为该查询循环了太多次:
SELECT * FROM emp;
目前,如果一个规则包含一个 NOTIFY 查询,那么该 NOTIFY 将被 无条件执行 - 也就是说,如果规则不施加到任何行上头,该 NOTIFY 也会被发出.比如,在
CREATE RULE notify_me AS ON UPDATE TO mytable DO NOTIFY mytable;
UPDATE mytable SET name = 'foo' WHERE id = 42;
里,一个 NOTIFY 事件将在 UPDATE 的时候发出,不管是否有某行的 id = 42.这是一个实现的限制,将来的版本应该修补这个毛病.
兼容性 SQL92
CREATE RULE语句是 PostgreSQL 语言的扩展. 在里没有CREATE RULE 语句.
----------------------------
CREATE SEQUENCE
CREATE SEQUENCE
Name
CREATE SEQUENCE -- 创建一个新的序列发生器
Synopsis
CREATE [ TEMPORARY | TEMP ] SEQUENCE seqname [ INCREMENT increment ]
[ MINVALUE minvalue ] [ MAXVALUE maxvalue ]
[ START start ] [ CACHE cache ] [ CYCLE ]
输入
TEMPORARY 或 TEMP
如果声明了这个修饰词,那么该序列对象只为这个会话创建, 并且在会话结束的时候自动删除.在临时序列存在的时候, 同名永久序列是不可见的(在同一会话里).
seqname
将要创建的序列号名.
increment
INCREMENT increment 子句是可选的.一个正数将生成一个递增的序列, 一个负数将生成一个递减的序列.缺省值是一(1).
minvalue
可选的子句 MINVALUE minvalue 决定一个序列可生成的最小值.缺省分别是递增序列为 1 递减为 -2^63-1.
maxvalue
使用可选子句 MAXVALUE maxvalue 决定序列的最大值.缺省的分别是递增为 -2^63-1,递减为 -1.
start
可选的 START start 子句 使序列可以从任意位置开始.缺省初始值是递增序列为 minvalue 递减序列为 maxvalue.
cache
CACHE cache 选项使序列号预分配并且为快速访问存储在内存里面. 最小值(也是缺省值)是1(一次只能生成一个值, 也就是说没有缓存).
CYCLE
可选的 CYCLE 关键字可用于使序列到达 最大值(maxvalue) 或 最小值(minvalue) 时可复位并继续下去.如果达到极限,生成的下一个数据将分别是 最小值(minvalue) 或 最大值(maxvalue).如果没有 CYCLE,那么在到达极限之后再调用 nextval 将返回错误.
输出
CREATE
命令成功执行的返回信息.
ERROR: Relation 'seqname' already exists
如果声明的序列已经存在.
ERROR: DefineSequence: MINVALUE (start) can't be >= MAXVALUE (max)
如果声明的初始值超出范围,返回此信息.
ERROR: DefineSequence: START value (start) can't be < MINVALUE (min)
如果声明的初始值超出范围,返回此信息.
ERROR: DefineSequence: MINVALUE (min) can't be >= MAXVALUE (max)
如果最小值和最大值不连贯.
描述
CREATE SEQUENCE将向当前数据库里增加一个新的序列号生成器. 包括创建和初始化一个新的名为 seqname的 单行表.生成器将为使用此命令的用户"所有".
在序列创建后,你可以使用函数 nextval, currval 和 nextval 操作序列.这些函数在用户手册中有详细文档.
尽管你不能直接更新一个序列,但你可以使用象
SELECT * FROM seqname;
检查一个序列的参数和当前状态.特别是序列的 last_value 字段显示了任意后端进程分配的最后的数值. (当然,这些值在被打印出来的时候可能已经过时了 - 如果其它进程 正积极地使用 nextval.)
Caution
如果用语序列对象的cache 设置大于一, 而且该对象可能被多个后端同时使用就有可能产生不可预料的结果.每个后端 在访问过序列对象并递增序列对象的 last_value 后, 将分配跟在序列值后面"缓存数".这样,该后端在下面的 cache-1 次nextval调用将使用预分配好的数值, 而不对共享对象做任何更新. 所以,任何已经分配但在会话中没有使用的数字 将在会话结束时丢失.而且,尽管多个后端保证分配独立的序列值, 当考虑所有的后端时该数值却有可能是乱序的.(例如,设置 cache为10, 后端 A 可能保留数值 1..10 并且返回nextval=1, 而后端 B 可能保留数值 11..20 并在后端 A 生成nextval=2 之 前返回 nextval=11.)因此, 将cache 设为一可以安全地假设nextval的数值是顺序生成的; 当缓存数设置大于一,我 们只能假设nextval值都是独立的, 而不能假设它们都是纯粹顺序生成的. 同样,last_value将反映由任何后端保留的最 后数值,不管它是不是nextval曾返回过的. 另外一个问题是在这样的序列上执行的 setval 将不会被 其它后端知晓,直道它们用光所有预先分配的缓存数值.
注意
使用 DROP SEQUENCE 语句来删除序列.
序列是基于 bigint 运算的,因此其范围不能超过八字节的 整数范围(-9223372036854775808 到 9223372036854775807).在一些老一点的平台上可能没有对八字节整数的编译器支持, 这种情况下序列使用普通的 integer 运算(范围是 -2147483648 到 +2147483647).
如果 cache 大于一,那么每个后端使用其自身的缓存来存储分配的数字. 已分配但当前会话没有使用的数字将丢失,导致序列里面出现"空洞".
用法
创建一个叫 serial的递增序列,从101开始:
CREATE SEQUENCE serial START 101;
从此序列中选出下一个数字:
SELECT nextval ('serial');
nextval
---
114
在一个 INSERT 中使用此序列:
INSERT INTO distributors VALUES (nextval('serial'),'nothing');
在一个 COPY FROM 后更新序列:
BEGIN;
COPY distributors FROM 'input_file';
SELECT setval('serial', max(id)) FROM distributors;
END;
兼容性 SQL92
CREATE SEQUENCE是 PostgreSQL 语言扩展. 在里没有 CREATE SEQUENCE 语句.
----------------------------
CREATE TABLE AS
CREATE TABLE AS
Name
CREATE TABLE AS -- 从一条查询的结果中创建一个新表
Synopsis
CREATE [ [ LOCAL ] { TEMPORARY | TEMP } ] TABLE table_name [ (column_name [, ...] ) ]
AS query
描述
CREATE TABLE AS创建一个表并且用来自 SELECT 命令计算出来的数据填充该表. 该表的字段和 SELECT 输出字段 的名字及类型相关.(只不过你可以通过明确地给出一个字段名字 列表来覆盖 SELECT 的字段名).
CREATE TABLE AS和创建视图有点象, 不过两者之间实在是有比较大差异∶它创建一个新表并且只对 SELECT 计算一次来填充这个新表. 新表不能跟踪 SELECT 的源表随后做的变化. 相比之下,每次做查询的时候,视图都重新计算 SELECT.
这条命令和 SELECT INTO有相同的功能, 但是我们建议你多用这条命令,因为它不象 SELECT ... INTO 语法那样融合和一些其它用法混淆. ,
参数
[LOCAL] TEMPORARY 或 [LOCAL] TEMP
如果声明了这个选项,则该表作为临时表创建. 临时表在会话退出的时候自动删除. 在该临时表存在的期间(本次会话), 同名的永久表是不可见的. 任何在临时表上创建的索引也自动是临时的.
LOCAL 关键字是可选的.
table_name
要创建的表名.这个表不能是已经存在的. 不过,临时表可以创建为和现有永久表同名. (译注∶这里指的是同名临时表或永久表不能已经存在)
column_name
字段的名称.多字段的名称可以用逗号分隔的字段名列表声明. 如果没有提供字段名子,那么就从查询的输出字段名中获取.
query
有效的查询语句(也就是一条 SELECT 命令),请参考 SELECT 获取可以使用的语法的描述.
诊断
请参考 CREATE TABLE和 SELECT 获取可能的输出的概要.
注意
这条命令从功能上等效于 SELECT INTO , 但是我们更建议你用这个命令,因为它不太可能和 SELECT ... INTO 语法的其它方面的使用混淆.
兼容性 SQL92
这条命令是根据 Oracle 的一个特性 制作的.在 或 SQL99 中没有功能相等的命令.不过, 把CREATE TABLE 和 INSERT ... SELECT 组合起来可以通过略微多一些的工作完成同样的事情.
历史
自 PostgreSQL 6.3 开始就已经有 CREATE TABLE AS 命令了.
又见
CREATE TABLE, CREATE VIEW , SELECT , SELECT INTO
----------------------------
CREATE TABLE
CREATE TABLE
Name
CREATE TABLE -- 定义一个新表
Synopsis
CREATE [ [ LOCAL ] { TEMPORARY | TEMP } ] TABLE table_name (
{ column_name data_type [ DEFAULT default_expr ] [ column_constraint [, ... ] ]
| table_constraint } [, ... ]
)
[ INHERITS ( parent_table [, ... ] ) ]
[ WITH OIDS | WITHOUT OIDS ]
这里 column_constraint 可以是:
[ CONSTRAINT constraint_name ]
{ NOT NULL | NULL | UNIQUE | PRIMARY KEY |
CHECK (expression) |
REFERENCES reftable [ ( refcolumn ) ] [ MATCH FULL | MATCH PARTIAL ] [ ON DELETE action ] [ ON UPDATE action ] }
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
而 table_constraint 可以是:
[ CONSTRAINT constraint_name ]
{ UNIQUE ( column_name [, ... ] ) | PRIMARY KEY ( column_name [, ...
] ) |
CHECK ( expression ) |
FOREIGN KEY ( column_name [, ...
] ) REFERENCES reftable [ ( refcolumn [, ... ] ) ]
[ MATCH FULL | MATCH PARTIAL ] [ ON DELETE action ] [ ON UPDATE action ] }
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
描述
CREATE TABLE将在当前数据库创建一个新的, 初始为空的表.该表将由发出此命令的用户所有.
CREATE TABLE还自动创建一个数据类型, 该数据类型代表对应该表一行的元组类型(结构类型). 因此,表不能和一个现有数据类型同名.
一个表的字段数不能超过 1600.(实际上,真正的限制比这低, 因为还有元组长度的约束).表不能和系统表同名.
可选的约束子句声明约束(或者测试),新行或者更新的行必须满足这些约束才能成功插入或更新.约束是一个命名的规则∶ 它是一个 SQL 对象,它通过对发生在表上的插入,更新或者删除操作的结果进行限制来协助我们定义有效的数值集合.
定义约束又两种方法∶表约束和列约束.一个列约束是作为 一个列定义的一部分定义的.而表约束并不和某个列绑在一起,它可以作用于多于一个列上.每个列约束也可以写成表约束; 如果某个约束只影响一个列,那么列约束只是符号上的简洁方式而已.
参数
[LOCAL] TEMPORARY 或 [LOCAL] TEMP
如果声明了此参数,则该表创建为临时表.临时表在会话结束时自动删除. 现有同名永久表在临时表存在期间在本会话过程中是不可见的.任何在临时表上创建的索引也都会自动删除.
关键字 LOCAL 是可选的.又见 兼容性 SQL92 .
table_name
要创建的表的名字.
column_name
在新表中要创建的字段名字.
data_type
该字段的数据类型.它可以包括数组说明符.请参考 用户手册获取有关数据类型和数组的更多信息.
DEFAULT default_expr
DEFAULT 子句给它所出现的字段一个缺省数值.该数值可以是任何不含变量的表达式(不允许使用子查询和对本 表中的其它字段的交叉引用).缺省表达式的数据类型必须和字段类型匹配.
缺省表达式将被用于任何未声明该字段数值的插入操作. 如果字段上没有缺省值,那么缺省是 NULL.
INHERITS ( parent_table [, ... ] )
可选的 INHERITS 子句声明一列表,这个新表自动从这列表 中继承所有字段.如果在多于一个父表中存在同名的字段,那么就会报告一个错误,除非这些字段的数据类型在每个父表里都是匹配的. 如果没有冲突,那么重复的字段在新表中融合成一个字段. 如果新表的字段名列表中包括和继承的字段同名的,那么它的数据类型也必须和上面一样与继承字段匹配,并且这些字段定义会融合成一个. 不过,同名的继承和新字段声明可以声明不同的约束∶所有的继承过来的约束以及声明的约束都融合到一起,并且全部应用于新表. 如果新表为该字段明确的声明了一个缺省数值,那么此缺省数值覆盖任何 来自继承字段声明的缺省值.否则,任何为该字段声明了缺省数值的父表都必须声明相同的缺省,否则就会报告一个错误.
WITH OIDS 或 WITHOUT OIDS
这个可选的子句声明新表中的行是否应该拥有赋予它们的 OID (对象标识). 缺省是有 OID.(如果新表从任何有 OID 的表继承而来,那么就算 这条命令说了 WITHOUT OIDS,也会强制 WITH OIDS.)
声明 WITHOUT OIDS 允许用户禁止为行或者表生成 OID. 这么做对大表是值得的,因为这样可以减少 OID 消耗并且推迟 32 位 OID 计数器的消耗.一旦该计数器重叠,那么就不能再假设 OID 的唯一,这样它的实用性就大打折扣.
CONSTRAINT constraint_name
列或表约束的可选名字.如果没有声明,则由系统生成一个名字.
NOT NULL
字段不允许包含 NULL 数值.等效于列约束 CHECK (column NOT NULL).
NULL
该字段允许包含 NULL 数值.这是缺省.
这个子句的存在只是为和那些非标准 SQL 数据库兼容. 我们不建议在新应用中使用它.
UNIQUE (column constraint)
UNIQUE ( column_name [, ... ] ) (table constraint)
UNIQUE 声明一个规则,该规则表示一个表里的一个或者多个独立的字段组合的分组只能包含唯一的数值.表的唯一约束 的行为和列约束的一样,只不过多了跨多行的能力.
对于唯一约束的用途而言,系统认为 NULL 数值是不相等的.
每个唯一表约束都必须命名一个字段的集合,该集合必须和其它唯一 约束命名字段集合或者该表定义的主键约束不同.(否则就只是同样的 约束写了两次.)
PRIMARY KEY (column constraint)
PRIMARY KEY ( column_name [, ... ] ) (table constraint)
主键约束表明表中的一个或者一些字段只能包含唯一(不重复)非 NULL 的数值. 从技术上讲,PRIMARY KEY 只是 UNIQUE 和 NOT NULL 的组合,不过把一套字段标识为主键同时也体现了大纲设计的元数据,因为主键意味着其它表可以拿这套字段 用做行的唯一标识.
一个表只能声明一个主键,不管是作为字段约束还是表约束.
主键约束应该定义在同个表上的一个与其它唯一约束所定义的不同的字段集合上.
CHECK (expression)
CHECK 约束声明一个完整性约束或者测试,一次插入或者更新操作若想成功则必须满足这个条件. 每个约束都必须是一个生成布尔结果的表达式.一个在字段定义中出现的
目前,CHECK 表达式不能包含子查询或者 引用除本行字段之外的变量.
REFERENCES reftable [ ( refcolumn ) ] [ MATCH matchtype ] [ ON DELETE action ] [ ON UPDATE action ] (column constraint)
FOREIGN KEY ( column [, ... ] ) REFERENCES reftable [ ( refcolumn [, ... ] ) ] [ MATCH matchtype ] [ ON DELETE action ] [ ON UPDATE action ] (table constraint)
REFERENCES 列约束声明一个由新表中一列或者多列组成的组应该只包含匹配引用的表 reftable 中对应引用的字段 refcolumn 中的数值. 如果省略 refcolumn, 则使用 reftable 的主键. 被引用字段必须是被引用表中的唯一字段或者主键.
向这些字段增加的数值将使用给出的匹配类型与参考表中的参考列 中的数值进行匹配.有三种匹配类型∶MATCH FULL, MATCH PARTIAL,和一种缺省匹配类型(如果没有声明 匹配类型的话).MATCH FULL 将不允许一个多字段外键的 字段为 NULL,除非所有外键字段都为 NULL.缺省匹配类型允许某些 外键字段为 NULL 而外键的其它部分不是 NULL.MATCH PARTIAL 还没实现.
另外,当被参考字段中的数据改变的时候,那么将对本表的字段中的数据 执行某种操作.ON DELETE 子句声明当被参考表中的 被参考行将被删除的时候要执行的操作.类似,ON UPDATE 子句声明被参考表中被参考字段更新为新值的时候要执行的动作.如果该行被更新,但被参考的字段实际上没有变化,那么就不会有任何动作. 下面是每个子句的可能的动作∶
NO ACTION
生成一个错误,表明删除或者更新将产生一个违反外键约束的动作. 它是缺省动作.
RESTRICT
和 NO ACTION 一样.
CASCADE
删除任何引用了被删除行的行,或者分别把引用行的字段值更新为 被参考字段的新数值.
SET NULL
把引用行数值设置为 NULL.
SET DEFAULT
把引用列的数值设置为它们的缺省值.
如果主键字段经常更新,那么我们给 REFERENCES 字段增加一个索引可能是合适的,这样与 REFERENCES 字段 相关联的 NO ACTION 和 CASCADE 动作可以更有效地执行.
DEFERRABLE 或 NOT DEFERRABLE
这两个关键字设置该约束是否可推迟.一个不可推迟的约束将在每条命令之后 马上检查.可以推迟的约束检查可以推迟到事务结尾 (使用 SET CONSTRAINTS命令).缺省是 NOT DEFERRABLE.目前只有外键约束 接受这个子句.所有其它约束类型都是不可推迟的.
INITIALLY IMMEDIATE or INITIALLY DEFERRED
如果约束是可推迟的,那么这个子句声明检查约束的缺省时间. 如果约束是 INITIALLY IMMEDIATE, 那么每条语句之后就检查它.这个是缺省.如果约束是 INITIALLY DEFERRED,那么只有在事务结尾才检查它. 约束检查的时间可以用 SET CONSTRAINTS命令修改.
诊断
CREATE
如果表成功创建,返回此信息.
ERROR
如果表创建失败返回这条信息.通常它还带着一些描述性文本, 比如∶ ERROR: Relation 'table' already exists,这个错误出现在运行时 -- 如果声明的表已经在数据库中存在了.
注意
如果一个应用使用了 OID 标识表中的特定行,那么我们建议在该表的 oid 字段上创建一个唯一约束,以确保该表的 OID 即使在计数器重叠之后也是唯一的.如果你需要一个整个数据库范围的唯一 标识,那么就要避免假设 OID 是跨表唯一的,你可以用 tableoid 和行 OID 的组合来实现这个目的. (将来的 PostgreSQL 很可能为每个表使用独立 的 OID 计数器,因此包括 tableoid 组成数据库范围内 的唯一标识将是必须的,而不是可选的.)
提示: 对那些没有主键的表,我们不建议使用 WITHOUT OIDS, 因为如果既没有 OID 又没有唯一数据键字,那么就很难标识特定的行.
PostgreSQL 自动为每个唯一约束和主键约束 创建一个索引以确保唯一性.因此,我们不必为主键字段创建明确的索引. (参阅 CREATE INDEX获取更多信息.)
SQL 92 标准认为 CHECK 字段约束只能引用它们施加的字段; 只有 CHECK 表约束可以引用多个字段. PostgreSQL 并未强制这样的限制; 它把字段约束和表约束看成是类似的.
唯一约束和主键在目前的实现里是不能继承的. 这样,如果把继承和唯一约束组合在一起会导致无法运转.
例子
创建表 films 和 distributors∶
CREATE TABLE films (
code CHARACTER(5) CONSTRAINT firstkey PRIMARY KEY,
title CHARACTER VARYING(40) NOT NULL,
did DECIMAL(3) NOT NULL,
date_prod DATE,
kind CHAR(10),
len INTERVAL HOUR TO MINUTE
);
CREATE TABLE distributors (
did DECIMAL(3) PRIMARY KEY DEFAULT NEXTVAL('serial'),
name VARCHAR(40) NOT NULL CHECK (name <> '')
);
创建一个带有 2 维数组的表∶
CREATE TABLE array (
vector INT[][]
);
为表 films 定义一个唯一表约束. 唯一表约束可以在表的一个或多个字段上定义∶
CREATE TABLE films (
code CHAR(5),
title VARCHAR(40),
did DECIMAL(3),
date_prod DATE,
kind VARCHAR(10),
len INTERVAL HOUR TO MINUTE,
CONSTRAINT production UNIQUE(date_prod)
);
定义一个检查列约束∶
CREATE TABLE distributors (
did DECIMAL(3) CHECK (did > 100),
name VARCHAR(40)
);
定义一个检查表约束∶
CREATE TABLE distributors (
did DECIMAL(3),
name VARCHAR(40)
CONSTRAINT con1 CHECK (did > 100 AND name <> '')
);
为表 films 定义一个主键表约束. 主键表约束可以定义在表上的一个或多个字段.
CREATE TABLE films (
code CHAR(5),
title VARCHAR(40),
did DECIMAL(3),
date_prod DATE,
kind VARCHAR(10),
len INTERVAL HOUR TO MINUTE,
CONSTRAINT code_title PRIMARY KEY(code,title)
);
为表 distributors 定义一个主键约束. 下面两个例子是等效的,第一个例子使用了表约束语法,第二个使用了列约束表示法.
CREATE TABLE distributors (
did DECIMAL(3),
name CHAR VARYING(40),
PRIMARY KEY(did)
);
CREATE TABLE distributors (
did DECIMAL(3) PRIMARY KEY,
name VARCHAR(40)
);
下面这个例子给字段 name 赋予了一个文本常量 缺省值,并且将字段 did 的缺省值安排为 通过选择序列对象的下一个值生成.modtime 的缺省值将是该行插入的时候的时间.
CREATE TABLE distributors (
name VARCHAR(40) DEFAULT 'luso films',
did INTEGER DEFAULT NEXTVAL('distributors_serial'),
modtime TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
在表 distributors 上定义两个 NOT NULL 列约束,其中之一明确给出了名字∶
CREATE TABLE distributors (
did DECIMAL(3) CONSTRAINT no_null NOT NULL,
name VARCHAR(40) NOT NULL
);
为 name 字段定义一个唯一约束∶
CREATE TABLE distributors (
did DECIMAL(3),
name VARCHAR(40) UNIQUE
);
上面的和下面这样作为一个表约束声明是一样的∶
CREATE TABLE distributors (
did DECIMAL(3),
name VARCHAR(40),
UNIQUE(name)
);
兼容性 SQL92
CREATE TABLE遵循 和 SQL99 的一个子集 的中间状态,一些例外情况在下面和上面的诊断中列出.
临时表
除了局部临时表之外, 还定义了 CREATE GLOBAL TEMPORARY TABLE 语句. 全局临时表也可以在其它会话中可见.
对于临时表,有一个可选的 ON COMMIT 子句∶
CREATE { GLOBAL | LOCAL } TEMPORARY TABLE table ( ... ) [ ON COMMIT {
DELETE | PRESERVE } ROWS ]
ON COMMIT 子句表明该临时表在执行 COMMIT 的时候是否应该清空行. 如果省略了 ON OMMIT 子句, 声明缺省是 ON COMMIT DELETE ROWS.不过, PostgreSQL 的行为总是类似 ON COMMIT PRESERVE ROWS.
NULL "约束"
NULL "约束"(实际上不是约束) 是 PostgreSQL 对 的扩展,包括它是为了和其它一些 RDBMS 兼容(以及为了和 NOT NULL 约束对称).因为它是任何字段的缺省,所以它的出现只是噪音而已.
断言
断言是一种特殊类型的完整性约束,它和其它约束共享相同的名字空间. 不过,断言和约束不同的是,它不一定依赖于某个特定的表,因此 提供了 CREATE ASSERTION 语句作为定义 约束的一个可选的方法∶
CREATE ASSERTION name CHECK ( condition )
PostgreSQL 目前还没有实现断言.
继承
通过 INHERITS 子句的多重继承是 PostgreSQL 语言的扩展. SQL99(但不包括 )使用不同的语法和语义定义了单继承. SQL99 风格的继承还没有在 PostgreSQL 中实现.
对象 ID
PostgreSQL 的 OID 的概念不是标准.
又见
ALTER TABLE , DROP TABLE
----------------------------
CREATE TRIGGER
Name
CREATE TRIGGER -- 定义一个新的触发器
Synopsis
CREATE TRIGGER name { BEFORE | AFTER } { event [OR ...] }
ON table FOR EACH { ROW | STATEMENT }
EXECUTE PROCEDURE func ( arguments )
输入
name
赋予新触发器的名称.
table
现有表名称.
event
INSERT,DELETE 或 UPDATE 之一.
func
一个用户提供的函数.
输出
CREATE
如果触发器成功创建,返回此信息.
描述
CREATE TRIGGER将向现有数据库中增加一个新的触发器. 触发器将与表 table 相联并且将执行声明的函数 func.
触发器可以声明为在对记录进行操作之前 在检查约束之前和 INSERT,UPDATE 或 DELETE 执行前)或之后(在检 查约束之后和完成 INSERT, UPDATE 或 DELETE 操作)触发. 如果触发器在事件之前,触发器可能略过当前记录 的操作或改变被插入的(当前)记录(只对 INSERT 和 UPDATE 操作有效). 如果触发器在事件之后,所有更改,包括最后的插入, 更新或删除对触发器都是"可见"的.
SELECT并不更改任何行,因此你不能创建 SELECT 触发器.这种场合下规则和视图更合适些.
请参考 PostgreSQL 程序员手册中SPI 和触发器章节获取更多信息.
注意
CREATE TRIGGER是 PostgreSQL 语言扩展.
只有表所有者可以就此表创建一个触发器.
在当前的版本,STATEMENT 触发器还没有实现.
请参考 DROP TRIGGER 获取如何删除触发器的信息.
用法
在插入或更新表 films 之前检查一下声明的分销商代码是否存在于 distributors 表中:
CREATE TRIGGER if_dist_exists
BEFORE INSERT OR UPDATE ON films FOR EACH ROW
EXECUTE PROCEDURE check_primary_key ('did', 'distributors', 'did');
在删除或更新一个分销商的内容之前, 将所有记录移到表 films 中:
CREATE TRIGGER if_film_exists
BEFORE DELETE OR UPDATE ON distributors FOR EACH ROW
EXECUTE PROCEDURE check_foreign_key (1, 'CASCADE', 'did', 'films', 'did');
兼容性 SQL92
在 里没有 CREATE TRIGGER语句.
上面第二个例子可以使用一个 FOREIGN KEY 约束实现:
CREATE TABLE distributors (
did DECIMAL(3),
name VARCHAR(40),
CONSTRAINT if_film_exists
FOREIGN KEY(did) REFERENCES films
ON UPDATE CASCADE ON DELETE CASCADE
);
----------------------------
CREATE TYPE
CREATE TYPE
Name
CREATE TYPE -- 定义一个新的数据类型
Synopsis
CREATE TYPE typename ( INPUT = input_function, OUTPUT = output_function
, INTERNALLENGTH = { internallength | VARIABLE }
[ , EXTERNALLENGTH = { externallength | VARIABLE } ]
[ , DEFAULT = default ]
[ , ELEMENT = element ] [ , DELIMITER = delimiter ]
[ , SEND = send_function ] [ , RECEIVE = receive_function ]
[ , PASSEDBYVALUE ]
[ , ALIGNMENT = alignment ]
[ , STORAGE = storage ]
)
输入
typename
将要创建的类型名.
internallength
一个文本串,说明新类型的内部长度.
externallength
一个文本串,说明新类型的外部(显示)长度.
input_function
一个函数的名称,由 CREATE FUNCTION创建,将数据从外部类型转换成内部类型.
output_function
一个函数的名称,由 CREATE FUNCTION创建,将数据从内部格式转换成适于显示的形式.
element
被创建的类型是数组;这个声明数组元素的类型.
delimiter
将用做数组的数据元素之间分隔符的字符.
default
该类型的缺省值.通常是省略它的,所以缺省是 NULL.
send_function
用 CREATE FUNCTION 创建的函数名,它将该类型的数据转换成一个适合传输到其他机器的形式.
receive_function
用 CREATE FUNCTION 创建的函数名,将该类型从适于传输给其他机器的形式转换为内部形式.
alignment
该数据类型的存储对齐要求.如果声明了,必须是 'char', 'int2', 'int4' 或 'double'; 缺省是 'int4'.
storage
该数据类型的存储技术.如果声明了,必须是 'plain','external', 'extended',或 'main'; 缺省是 'plain'.
输出
CREATE
如果创建类型成功,返回此信息.
描述
CREATE TYPE允许用户在 PostgreSQL 当前数据库里创建一个新的用户数据类型.定义该类型的用户成为其所有者. typename 是新类型的名称而且必须在所定义的数据库中唯一.
CREATE TYPE需要在定义类型之前先注册两个函数(用 CREATE FUNCTION 命令). 新的基本类型的形式由 input_function决定,它将该类型的外部形式转换成可以被对该类型操作的操作符和函数识别的形式. 自然, output_function 用做相反用途. 输入函数可以声明为接受一个类型为 opaque 的参数,或者接受三个类型分别为 opaque,OID,int4 的参数. (第一个参数是 C 字串形式的输入文本,第二个是在该类型为数组类型时 其元素的类型,第三个是目标字段的 typmod,如果已知的话.) 输出函数可以声明为接受一个类型为 opaque 的参数, 或者接受两个类型为 opaque,OID 的参数. (第一个参数实际上是数据类型本身,但是因为输出函数必须首先声明,所以把它声明为接受 opaque 类型更简单.第二个参数也是 用于数组类型的数组元素类型.)
新的基本数据类型可定义成为定长,这时 internallength 是一个正整数,也可以是变长的,通过把 internallength 设置为 VARIABLE 表示.(在内部,这个状态是通过将 typlen 设置为 -1 实现的.)所有变长类型的内部形式 都必须以一个整数开头,这个整数给出此类型这个数值的全长.
外部表现形式的长度类似使用 externallength 关键字 声明.(目前这个值没有使用,通常是省略的,这样就缺省是 VARIABLE.)
要表示一个类型是数组,用 ELEMENT 关键字声明数组元素的 类型.比如,要定义一个 4 字节整数("int4")的数组,声明
ELEMENT = int4
有关数组类型的更多细节在下面描述.
要声明用于这种类型数组的外部形式的数值之间的分隔符,可用 delimiter 声明指定分隔符.缺省的分隔符是逗号(','). 请注意分隔符是和数组元素类型相关联,而不是数组类型本身.
如果用户希望字段的数据类型缺省时不是 NULL,而是其它什么东西,那么你可以声明一个缺省值. 在 DEFAULT 关键字里面声明缺省值. (这样的缺省可以被附着在特定字段上的明确的 DEFAULT 子句覆盖.)
可选的参数 send_function 和 receive_function 目前还没有使用,并且通常被忽略(允许它们分别缺省为 output_function 和 input_function.) 这些函数将来可能复活过来用于声明与机器相关的二进制表现.
可选的标签 PASSEDBYVALUE 表明该数据类型是通过传值传递的而不是传引用.请注意你不能对那些内部形式超过 Datum 类型宽度 (大多数机器上是四字节,有少数机器上是八字节.) 的类型进行传值.
alignment关键字 声明该数据类型要求的对齐存储方式.允许的数值等效于按照 1,2, 4,或者 8 字节边界对齐.请注意变长类型必须有至少 4 字节的对齐, 因为它们必须包含一个 int4 作为它们的第一个成份.
storage关键字 允许为变长数据类型选择 TOAST 存储方法 (定长类型只允许使用 plain). plain 为该数据类型关闭 TOAST:它将 总是用内联的方式而不是压缩的方式存储. extended 是 TOAST 完全兼容的:系统将首先试图压缩 一个长的数据值,然后如果它仍然太长的话就将它的值移出主表的行. external 允许将值移出主表的行,但系统将不会压缩它. main 允许压缩,但是不赞成把数值移动出主表.(用这种存储方法的数据项可能仍将移动出主表,如果不能放在一行里的话, 但是它们将比 extended 和 external 项更愿意呆在主表里.)
数组类型
在创建用户定义数据类型的时候,PostgreSQL 自动创建一个与之关联的数组类型,其名字由该基本类型的名字前缀一个下划线组成.分析器理解这个命名传统,并且把对类型为 foo[] 的字段的请求转换成对类型为 _foo 的字段的请求.这个隐含创建的数组类型是变长并且 使用内建的输入和输出函数 array_in 和 array_out.
你很可能会问"如果系统自动制作正确的数组类型,那为什么有个 ELEMENT选项?"使用 ELEMENT 有用的唯一 的场合是在你制作的定长类型碰巧在内部是一个 N 个相同事物的数组, 而你又想允许这 N 个事物可以通过脚标直接关联,以及那些你准备 把该类型当做整体进行的操作.比如,类型 name 就允许其 构成 char 用这种方法关联.一个二维的 point 类型也可以允许其两个构成浮点型按照类似 point[0] 和 point[1] 的方法关联. 请注意这个功能只适用与那些内部形式完全是 N 个相等字段的定长类型.一个可以脚标化的变长类型必须有被 array_in 和 array_out 使用的一般化的内部表现形式.出于历史原因(也就是说,那些明显错误但补救来得太迟的 问题),定长数组类型的脚标从零开始,而不是象变长类型那样的从一开始.
注意
类型名不能以下划线("_") 开头而且只能有 30 个字符长.(或者通常是 NAMEDATALEN-2, 而不是其它名字那样的可以有 NAMEDATALEN-1 个字符). 以下划线开头的类型名被解析成内部创建的数组类型名.
例子
这个命令创建box数据类型,并且将这种类型用于一个表定义:
CREATE TYPE box (INTERNALLENGTH = 16,
INPUT = my_procedure_1, OUTPUT = my_procedure_2);
CREATE TABLE myboxes (id INT4, description box);
如果 box 的内部结构是一个四个 float4 的数组,我们可以说
CREATE TYPE box (INTERNALLENGTH = 16,
INPUT = my_procedure_1, OUTPUT = my_procedure_2,
ELEMENT = float4);
它允许一个 box 的数值成分 float 可以用脚标关联. 否则该类型和前面的行为一样.
这条命令创建一个大对象类型并将其用于一个表定义:
CREATE TYPE bigobj (INPUT = lo_filein, OUTPUT = lo_fileout,
INTERNALLENGTH = VARIABLE);
CREATE TABLE big_objs (id int4, obj bigobj);
兼容性 SQL92
CREATE TYPE命令是 PostgreSQL 扩展.在 SQL99 里 有一个 CREATE TYPE 语句,但是细节上和 PostgreSQL 的有比较大区别.
又见
CREATE FUNCTION , DROP TYPE , PostgreSQL 程序员手册
延伸阅读:
MySQL Group By用法
MySQL Order By语法
使用mysql show processlist函数显示mysql查询进程
MySql常用命令总结
SQL中CONVERT转化函数, Concat , COALESCE的用法
经典SQL语句总结
SQL中EXISTS的用法