SQL基础知识1

SQL 命令
这部分包含那些 PostgreSQL 支持的 SQL 命令的信息．这里的 "SQL" 就是该语言通常的含义； 每条命令的与标准有关的兼容性的信息可以在相关的参考页中找到．
Table of Contents
ABORT --  退出当前事务
ALTER GROUP --  向组中增加用户或从组中删除用户  
ALTER USER --  改变数据库用户帐号．
ANALYZE --  收集与数据库有关的统计
BEGIN --  开始一个事务块
CHECKPOINT -- 强制一个事务日志检查点
CLOSE --  关闭一个游标
CLUSTER --  根据一个索引对某个表集簇
COMMENT --  定义或者改变一个对象的评注
COMMIT --  提交当前事务
COPY --  在表和文件之间拷贝数据
CREATE AGGREGATE --  定义一个新的聚集函数
CREATE CONSTRAINT TRIGGER --  定义一个新的约束触发器
CREATE DATABASE --  创建新数据库
CREATE FUNCTION --  定义一个新函数
CREATE GROUP --  定义一个新的用户组
CREATE INDEX --  定义一个新索引
CREATE LANGUAGE -- 定义一种新的过程语言
CREATE OPERATOR --  定义一个新的操作符
CREATE RULE --  定义一个新的重写规则
CREATE SEQUENCE --  创建一个新的序列发生器
CREATE TABLE --  定义一个新表
CREATE TABLE AS -- 从一条查询的结果中创建一个新表
CREATE TRIGGER --  定义一个新的触发器
CREATE TYPE --  定义一个新的数据类型
CREATE USER --  创建一个新的数据库用户帐户
CREATE VIEW --  定义一个视图
DECLARE --  定义一个游标
DELETE --  删除一个表中的行
DROP AGGREGATE --  删除一个用户定义的聚集函数
DROP DATABASE --  删除一个数据库．
DROP FUNCTION --  删除一个用户定义的函数
DROP GROUP --  删除一个用户组
DROP INDEX --  删除一个索引
DROP LANGUAGE --  删除一个用户定义的过程语言
DROP OPERATOR --  删除一个用户定义操作符
DROP RULE --  删除一个重写规则
DROP SEQUENCE --  删除一个序列
DROP TABLE --  删除一个表
DROP TRIGGER --  删除一个触发器定义．
DROP TYPE --  删除一个用户定义数据类型
DROP USER --  删除一个数据库用户帐号
DROP VIEW --  删除一个视图
END --  提交当前的事务
EXPLAIN --  显示语句执行规划
FETCH --  用游标从表中抓取行
GRANT --  定义访问权限
INSERT --  在表中创建新行
LISTEN --  监听一个通知
LOAD -- 装载或重载一个共享库文件
LOCK --  明确地锁定一个表
MOVE --  把游标放到表中的特定的行
NOTIFY --  生成一个通知
REINDEX --  恢复一个损坏了的索引
RESET -- 把一个运行时参数值恢复为缺省值
REVOKE --  删除访问权限．
ROLLBACK --  退出当前事务
SELECT --  从表或视图中取出若干行．
SELECT INTO --  从一个查询的结果中创建一个新表
SET -- 改变运行时参数
SET CONSTRAINTS -- 设置当前事务的约束模式
SET SESSION AUTHORIZATION --  为当前会话设置会话用户标识符和当前用户标识符
SET TRANSACTION -- 设置当前事务的特性
SHOW -- 显示运行时参数的数值
TRUNCATE --  清空一个表
UNLISTEN --  停止监听通知信息
UPDATE --  更新一个表中的行
VACUUM --  垃圾收集以及可选地分析一个数据库

--------------------------------------------------------------------------------

ABORT 退出当前事务
ABORT   Name
ABORT  --  退出当前事务
Synopsis
ABORT [ WORK | TRANSACTION ]
输入
无
输出
ROLLBACK         成功的返回信息．
NOTICE: ROLLBACK: no transaction in progress
如果当前没有任何正在处理的事务存在．
描述
ABORT回卷当前事务并且废弃所有当前事务中做的更新． 这个命令和 命令 ROLLBACK 完全一样， 只是由于历史原因而保留下来．
注意
用COMMIT语句可以成功地结束/提交一个事务．
用法
取消所有更改：
ABORT WORK;   
兼容性 SQL92   
此命令是 PostgreSQL 基于历史原因做的扩展． ROLLBACK 是 中等价的命令．

--------------------------------------------------------------------------------

ALTER GROUP向组中增加用户或从组中删除用户
ALTER GROUP
Name
ALTER GROUP  --  向组中增加用户或从组中删除用户
Synopsis
ALTER GROUP name ADD USER username [, ... ]
ALTER GROUP name DROP USER username [, ... ]
输入
Name
要更改的组名称。
Username
准备向组中增加或从组中删除的用户名。用户名必须已经存在。
输出
ALTER GROUP
更改成功的返回信息。
描述
ALTER GROUP用于向组中增加用户或者从组中删除用户。 只有数据库超级用户才能使用这条命令。向组中增加用户并不创建用户。同样从组中删除用户也不删除用户本身。
使用 CREATE GROUP创建新组以及 DROP GROUP删除一个组。
用法
向组中增加用户：
ALTER GROUP staff ADD USER Karl, john;
从组中删除用户：
ALTER GROUP workers DROP USER Beth;
兼容性 SQL92   
里没有 ALTER GROUP 语句。角色（roles）的概念与之类似。

--------------------------------------------------------------------------------

ALTER TABLE修改表的定义
ALTER TABLE
Name
ALTER TABLE  --  修改表的定义
Synopsis
ALTER TABLE [ ONLY ] table [ * ]
    ADD [ COLUMN ] column type [ column constraint [ ... ] ]

ALTER TABLE [ ONLY ] table [ * ]
    ALTER [ COLUMN ] column { SET DEFAULT value | DROP DEFAULT }
ALTER TABLE [ ONLY ] table [ * ]
    ALTER [ COLUMN ] column SET STATISTICS integer
ALTER TABLE [ ONLY ] table [ * ]
    RENAME [ COLUMN ] column TO new column
ALTER TABLE
    RENAME TO new table
ALTER TABLE
    ADD table constraint definition
ALTER TABLE [ ONLY ] table
        DROP CONSTRAINT constraint
{ RESTRICT | CASCADE }
ALTER TABLE table
        OWNER TO new owner

输入
table
试图更改的现存表的名称．
column
现存或新的列名称．
type
新列的类型．
newcolumn
现存列的新名称．
new table
表的新名称．
table constraint definition
表的新的约束定义．
New user
该表的新所有者的用户名．
输出
ALTER
从被改名的列或表返回的信息．
ERROR
如果一个列或表不存在返回的信息．
描述
ALTER TABLE变更一个现存表的定义．
ADD COLUMN形式使用与 CREATE TABLE一样的语法向表中增加一个新列/字段。
ALTER COLUMN SET/DROP DEFAULT形式允许你从列/字段中设置或者删除缺省（值）。 注意缺省（值）只适用于随后的 INSERT 命令。 它们不会改变已经存在于表中的行．
ALTER COLUMN SET STATISTICS形式允许你为 随后的 ANALYZE 操作 设置收集统计信息的对象．
RENAME 子句可以在不影响任何相关数据的情况下更改 一个表，字段，索引或者序列名称。因此， 在此命令执行后数据仍将是相同尺寸和类型。
ADD table constraint definition子句使用与 CREATE TABLE一样的语法向表中增加一个新的约束。
DROP CONSTRAINT constraint子句删除所有表上匹配 constraint 的 CHECK 约束(以及其子表)
OWNER 把该表的所有者改为用户 new user.
如果要改变表的纲要，你必须是表的所有者．
注意
COLUMN 关键字是多余的，可以省略．
在目前的 ADD COLUMN实现里还不支持 新列/字段的缺省（值）和 NOT NULL 子句。不过你可以随后用 ALTER TABLE 的 SET DEFAULT 形式设置缺省（值）。（你可能还想用 UPDATE 把已存在行更新为缺省值。）
目前只有 CHECK 约束可以从表中删除．RESTRICT 关键字是必须的，尽管 并不检查依赖性．还不支持 CASCADE 选项．要删除一个 PRIMARY 或者 UNIQUE 约束，用 DROP INDEX 命令删除相关的索引． 要删除 FOREIGN KEY 约束，你需要重新创建并重新装载该表， 创建的时候使用 CREATE TABLE命令的其它参数．
比如，要删除在表 distributors 上的所有约束∶
CREATE TABLE temp AS SELECT * FROM distributors;
DROP TABLE distributors;
CREATE TABLE distributors AS SELECT * FROM temp;
DROP TABLE temp;
    
要修改表的结构，你必须是表的所有人。不允许更改系统表结构的任何部分。 PostgreSQL 用户手册里有关于继承的更多信息．
请参考CREATE TABLE 部分获取更多有效参数的描述．
用法
向表中增加一个 varchar 列：
ALTER TABLE distributors ADD COLUMN address VARCHAR(30);   
对现存列改名：
ALTER TABLE distributors RENAME COLUMN address TO city;   
更改现存表的名字∶
ALTER TABLE distributors RENAME TO suppliers;   
给一个表增加一个检查约束∶
ALTER TABLE distributors ADD CONSTRAINT zipchk CHECK (char_length(zipcode) = 5);   
删除一个表和它的所有子表的监查约束∶
ALTER TABLE distributors DROP CONSTRAINT zipchk;   
向表中增加一个外键约束：
ALTER TABLE distributors ADD CONSTRAINT distfk FOREIGN KEY (address) REFERENCES addresses(address) MATCH FULL;   
给表增加一个(多字段)唯一约束∶
ALTER TABLE distributors ADD CONSTRAINT dist_id_zipcode_key UNIQUE (dist_id, zipcode);   
兼容性 SQL92  
ADD COLUMN 形式是兼容的，除了上面说的缺省（值）和 NOT NULL 约束外。 ALTER COLUMN 形式是完全兼容的。
对 ALTER TABLE 声明了一些附加的 PostgreSQL 目前还不直接支持的功能：
ALTER TABLE table DROP [ COLUMN ] column { RESTRICT | CASCADE }
      
从一个表中删除一个列． 目前，要删除一个现存的列，表必须重新创建和重新装载：
CREATE TABLE temp AS SELECT did, city FROM distributors;    
DROP TABLE distributors;
CREATE TABLE distributors (
    did      DECIMAL(3) DEFAULT 1,
    name     VARCHAR(40) NOT NULL
);
INSERT INTO distributors SELECT * FROM temp;
DROP TABLE temp;
       
重命名表，列/字段，索引，和序列的名字是 PostgreSQL 对 的扩展。

--------------------------------------------------------------------------------

ALTER USER
ALTER USER
Name
ALTER USER  --  改变数据库用户帐号．
Synopsis
ALTER USER username [ [ WITH ] option [ ... ] ]
这里 option 可以是∶
          [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'
        | CREATEDB | NOCREATEDB
        | CREATEUSER | NOCREATEUSER
        | VALID UNTIL 'abstime'
输入
username
想进行更改的用户的名字。
[ encrypted | unencrypted ] password
此帐号所使用的新口令。 Encrypted/ unencrypted 控制该口令在数据库里是否以加密形式存储．
CREATEDB
NOCREATEDB
这个子句定义该用户创建数据库的能力。 如果声明了 CREATEDB，该用户可以创建她自己的数据库。用 NOCREATEDB 将剥夺一个用户创建数据库的能力。
CREATEUSER
NOCREATEUSER
这个子句决定一个用户能否创建新用户。 这个选项同样还令该用户成为超级用户，可以超越所有访问限制。
abstime
该用户帐号口令的有效日期（和可选的时间）。
输出
ALTER USER
更改成功的返回信息．
ERROR: ALTER USER: user "username" does not exist
如果数据库不认识你所声明的用户返回的信息．
描述
ALTER USER用于更改用户的 PostgreSQL 帐号的属性．没有在该命令中出现的属性保持原值．
只有一个数据库超级用户可以用这个命令更改权限和口令有效期。 普通用户只能更改他们自己的口令。
ALTER USER无法改变一个用户的组的成员性． 用 ALTER GROUP实现这个目地．
使用 CREATE USER创建新用户和 DROP USER删除用户。
用法
更改一用户口令：
ALTER USER divide WITH PASSWORD 'hu8jmn3';
更改一用户有效期
ALTER USER Manuel VALID UNTIL 'Jan 31 2030';
更改一用户有效期， 声明其权限应该在用比UTC早一小时的时区记时的1998年5月4日正午失效
ALTER USER Chris VALID UNTIL 'May 4 12:00:00 1998 +1';
赋予一用户创建新用户和新数据库的权限：
ALTER USER Miriam CREATEUSER CREATEDB;
兼容性 SQL92   
里没有 ALTER USER． 该标准将用户定义部分交给具体数据库实现处理．

--------------------------------------------------------------------------------

ANALYZE
ANALYZE
Name
ANALYZE  --  收集与数据库有关的统计
Synopsis
ANALYZE [ VERBOSE ] [ table [ (column [, ...] ) ] ]
输入
VERBOSE
打开处理过程信息的显示．
table
要分析的特定表的名字．缺省是所有表．
column
要分析的特定行的名字．缺省是所有列．
输出
ANALYZE
命令已经结束了．
描述
ANALYZE收集有关 PostgreSQL 表的内容的统计，然后把结果保存在系统表 pg_statistic 里．随后，查询规划器就可以使用这些统计帮助判断查询的最有效的 规划．
如果没有参数，ANALYZE 检查在当前数据库里的所有 表．如果有参数，ANALYZE 只检查那个表． 你还可以给出一列字段名字，这个时候只有那些字段的统计信息被更新．
注意
周期性地运行 ANALYZE，或者在对表的 大部分内容做了更改之后马上运行它是个好习惯，准确的统计信息将帮助规划器选择最合适的查询规划，并因此 而改善查询处理的速度．一种比较经常采用的策略是每天在 低负荷的时候运行一次 VACUUM和 ANALYZE．
和 VACUUM FULL 不同的是， ANALYZE 只需要在目标表上有一个读取锁， 因此它可以和表上的其它活动并行地运行．
对于大表，ANALYZE 采集表内容的一个随机的抽样做统计，而不是检查每一行．这样即使是很大的表，我们也只需要很少的一些时间就可以完成分析．不过要注意的是统计只是近似的结果，而且每次运行 ANALYZE都会有一些小变化，即使表内容实际上 没有改变也这样．这样会导致 EXPLAIN 所显示的 规划器计算的开销有一些小变化，
收集的统计信息通常包括一个每字段最常用数值的列表以及一个包线图，显示每个字段里数据的近似分布．如果 ANALYZE 认为它们都没有什么用， (比如，在一个唯一键字的字段上没有公共的数值) 或者是该字段数据类型不支持相关的操作符，那么它们都可以忽略．在用户手册中有关于统计的更多信息．
分析的广度可以通过用 ALTER TABLE ALTER COLUMN SET STATISTICS (参阅 ALTER TABLE调整每字段的统计目标来控制．目标数值设置最常用数值列表中的记录的最大数目以及包线图中的最大块数．缺省的目标数值是 10，不过我们可以调节 这个数值获取规划器计算精度和 ANALYZE 运行所需要的 时间以及 pg_statistic 里面占据的空间数目之间的 平衡．特别是，把统计目标设置为零就关闭了该字段的统计收集． 对那些从来不参与到查询的 WHERE，GROUP BY，或者 ORDER BY 子句里的字段 是很有用的，因为规划器不会使用到这样的字段上的统计． )
在被分析的字段中最大的统计目标决定为统计采样的表中的行的数目． 增大目标会导致做 ANALYZE 的时候成比例地 增大对时间和空间的需求．
兼容性 SQL92   
里没有 ANALYZE 语句．

--------------------------------------------------------------------------------

BEGIN
BEGIN
Name
BEGIN  --  开始一个事务块
Synopsis
BEGIN [ WORK | TRANSACTION ]
输入
WORK
TRANSACTION
可选关键字。没什么作用。
输出
BEGIN
这表明一个新的事务已经开始．
NOTICE: BEGIN: already a transaction in progress
这表明该事务已经运行，当前事务不受影响．
描述
缺省时，PostgreSQL 以 非链接模式（unchained mode）（在其他数据库系统里也称之为"自动提交（"autocommit"））"。换句话说，每个用户语句都是在其自身的事务中运行并且在语句结束时隐含的调用一个提交（commit）（如果执行成功则提交，否则调用一个回卷）。 BEGIN 以链接模式（chained mode）初始化一个用户事务，也就是说所有 BEGIN 命令后的用户语句都将在一个事务里面执行直到一个明确的 COMMIT， ROLLBACK，或执行退出（abort）。在链接模式里执行的语句很明显地快得多，因为事务开始/提交（start/commit）需要大量的CPU 和磁盘活动。在一个事务内部执行多条语句时因为可能修改若干个相关的表因而同样需要一致性。
在 PostgreSQL 里缺省的事务隔离级别是 READ COMMITTED， 这时在事务内部的查询只看到查询提交之前的（数据）修改。所以，如果你需要更严格的事务隔离，你必须在 BEGIN 后马上使用 SET TRANSACTION ISOLATION LEVEL SERIALIZABLE。 在 SERIALIZABLE 模式里，查询将只能看到整个事务开始之前的修改。（实际上是在一个可串行化事务内部第一个 DML 语句执行前的数据）。
如果提交了事务， PostgreSQL 将保证要么实现所有更新， 要么所有更新都没有实现。事务有标准的 ACID （原子性，一致性，隔离性，持续性） （atomic，consistent，isolatable，and durable）属性。
注意
请参考 LOCK语句获取关于在事务内部锁定一个表的详细信息．
使用 COMMIT或者 ROLLBACK结束一个事务．
用法
开始一个用户事务：
BEGIN WORK;
兼容性 SQL92  
BEGIN是 PostgreSQL 语言的扩展． 在 中没有明确的 BEGIN 的定义；事务初始化总是隐含的而且使用一个 COMMIT 或者 ROLLBACK 语句终止．
注意: 许多关系型数据库为了方便提供一个自动提交（autocommit）特性。
顺便说一句，BEGIN 关键字在嵌入 SQL 里用于不同的目的。 我们建议你在移植数据库应用时仔细检查事务的语意。
还要求事务的缺省隔离级别是 SERIALIZABLE。
CHECKPOINT
CHECKPOINT
Name
CHECKPOINT -- 强制一个事务日志检查点
Synopsis
CHECKPOINT
描述
预写式日志（Write-Ahead Logging (WAL)）缺省时在事务日志中每隔一段时间放一个检查点．（要调整这个原子化的检查点间隔，你可以参考运行时 选项 CHECKPOINT_SEGMENTS 和 CHECKPOINT_TIMEOUT ．） CHECKPOINT 强迫在命令声明时立即进行检查，而不是等到下一次调度时的检查点．
检查点是一个事务日志训练中的点，在该点，所有数据文件都被更新 以反映日志中的信息．所有数据文件都将被冲刷到磁盘．请参考 PostgreSQL 管理员手册获取更多有关 WAL 系统的信息．
只有超级用户可以调用 CHECKPOINT． 该命令不是设计用于正常操作过程中的．
又见
PostgreSQL 管理员手册
兼容性 SQL92
CHECKPOINT命令是 PostgreSQL 语言的扩展．

--------------------------------------------------------------------------------

CLOSE
CLOSE
Name
CLOSE  --  关闭一个游标
Synopsis
CLOSE cursor
输入
cursor       一个待关闭的游标的名字．
输出
CLOSE  游标关闭成功返回的信息．
NOTICE PerformPortalClose: portal "cursor" not found
如果该 cursor 没有声明或已经关闭，返回该信息．
描述
CLOSE释放和一个游标关联的资源． 一个游标关闭后，不允许对其再做任何操作．一个不再使用的游标应该关闭掉．
如果用 COMMIT 或 ROLLBACK 提交了一个事务，将对每个打开的游标执行隐含的关闭操作．
注意
PostgreSQL 没有明确的 OPEN （打开）游标的语句； 我们认为一个游标在声明时就打开了．使用 DECLARE 语句声明一个游标．
用法
关闭游标liahona：
CLOSE liahona;
兼容性 SQL92   
CLOSE与 完全兼容．

--------------------------------------------------------------------------------

CLUSTER
Name
CLUSTER  --  根据一个索引对某个表集簇
Synopsis
CLUSTER indexname ON table name

输入
indexname
一个索引名称．
table
准备建簇的表的名称．
输出
CLUSTER
成功建簇．
ERROR: relation <tablerelation_number> inherits "table"
ERROR: Relation table does not exist!
描述
CLUSTER指示PostgreSQL 近似地基于索引 indexname 的度量对表 table 进行存储建簇． 索引必须已经在表 table name. 上定义了．
当对一个表建簇后，该表的物理存储将基于索引信息进行． 建簇是静态的，也就是说，当表被更新后，改变的内容不会建簇． 不会试图对更新过的记录重新建簇．如果需要，可以通过手工执行该命令的方法重建簇．
注意
该表实际上按索引顺序拷贝到了一个临时表中，然后重新改成原名． 因此，在建簇时所有赋予的权限和其它索引都将丢失．
如果你只是随机的访问表中的行， 那么在堆表中的数据的实际存储顺序是无关紧要的． 但是，如果你对某些数据的访问多于其他数据，而且有一个索引将这些数据分组，那你就将从 使用 CLUSTER 中获益．
另一个CLUSTER 很有帮助的例子是当你用索引从一个表中取出几个记录时. 如果你从一个表中请求一定索引范围的值，或者是一个索引过的值对应多行， CLUSTER 也会有助于应用，因为如果索引标识出第一匹配行所在的堆存储页，所有 其他行也可能已经在同一堆存储页里了，这样便节省了磁盘访问的时间，加速了查询．
有两种建簇的数据．第一种是用 CLUSTER 命令，此命令将原表按你声明的索引重新排列．这个动作在操作大表时可能会很慢，因为每一行都从堆存储页里按索引顺序取出，如果存储页表没有排序，整个表是随机存放在各个页面的，因而每行都要进行依次磁盘页面操作． PostgreSQL 有一个缓冲， 但一个大表的主体是不可能都放到缓冲去的．
另一个对数据建簇的方法是使用
SELECT column list INTO TABLE new table
     FROM table ORDER BY column list
    
这个用法使用PostgreSQL 排序的代码 ORDER BY 来匹配索引，在对未排序的数据操作时速度快得多． 然后你可以删除旧表，用 ALTER TABLE...RENAME将 new table 改成旧表名， 并且重建该表所有索引．唯一的问题是 OID 将不保留．这时再做 CLUSTER 将快得多， 因为大多数堆栈数据已经排过序了而且使用现有的索引．
用法
以雇员的薪水属性对雇员关系建簇．
CLUSTER emp_ind ON emp;
兼容性 SQL92   
在 规范里没有 CLUSTER 语句．

--------------------------------------------------------------------------------

COMMENT
COMMENT
Name
COMMENT  --  定义或者改变一个对象的评注
Synopsis
COMMENT ON
[
[ DATABASE | INDEX | RULE | SEQUENCE | TABLE | TYPE | VIEW ] object_name |
COLUMN table_name.column_name|
AGGREGATE agg_name agg_type|
FUNCTION func_name (arg1, arg2, ...)|
OPERATOR op (leftoperand_type rightoperand_type) |
TRIGGER trigger_name ON table_name
] IS 'text'
输入
object_name, table_name, column_name, agg_name, func_name, op, trigger_name
要加入评注的对象名称．
text
要加入的评注．
输出
COMMENT     成功对表评注后的返回．
描述
COMMENT 存储一个数据库对象的评注， 这个评注可以很容易用 psql的 \dd或 \d+ 或者 \l+ 命令检索出来．其它检索评注的用户接口可以建设在 psql 所用地同样地内部函数的基础上，也就是 obj_description() 和 col_description()．
要修改一个评注，为同一个对象发出一条新的 COMMENT 命令即可．每个对象只存储一条评注． 要删除评注，在文本字串的位置写上 NULL．当删除对象时，评注自动被删除掉．
需要说明的是目前评注没有安全机制∶任何联接到某数据库上地用户 都可以看到所有该数据库对象地评注(尽管只有超级用户可以修改 不属于它地对象的评注)．因此，不要在评注里放安全性敏感地信息．
用法
给表mytable 加评注：
COMMENT ON mytable IS 'This is my table.';   
一些例子：
COMMENT ON DATABASE my_database IS 'Development Database';
COMMENT ON INDEX my_index IS 'Enforces uniqueness on employee id';
COMMENT ON RULE my_rule IS 'Logs UPDATES of employee records';
COMMENT ON SEQUENCE my_sequence IS 'Used to generate primary keys';
COMMENT ON TABLE my_table IS 'Employee Information';
COMMENT ON TYPE my_type IS 'Complex Number support';
COMMENT ON VIEW my_view IS 'View of departmental costs';
COMMENT ON COLUMN my_table.my_field IS 'Employee ID number';
COMMENT ON AGGREGATE my_aggregate (double precision) IS 'Computes sample variance';
COMMENT ON FUNCTION my_function (timestamp) IS 'Returns Roman Numeral';
COMMENT ON OPERATOR ^ (text, text) IS 'Performs intersection of two text';
COMMENT ON TRIGGER my_trigger ON my_table IS 'Used for R.I.';   
兼容性 SQL92   
里没有COMMENT．

--------------------------------------------------------------------------------

COMMIT
COMMIT
Name
COMMIT  --  提交当前事务
Synopsis
COMMIT [ WORK | TRANSACTION ]
输入
WORK
TRANSACTION
可选关键字。没有作用。
输出
COMMIT
提交成功返回此信息．
NOTICE: COMMIT: no transaction in progress
如果过程中没有事务，返回此信息．
描述
COMMIT提交当前事务． 所有事务的更改都将为其他事务可见，而且保证当崩溃发生时的可持续性．
注意
关键字 WORK 和 TRANSACTION 都可以忽略．
使用 ROLLBACK语句退出一次事务．
用途
要让所有变更永久化：
COMMIT WORK;   
兼容性 SQL92   
只声明了两种形式 COMMIT 和 COMMIT WORK。否则完全兼容。

--------------------------------------------------------------------------------

COPY
COPY
Name
COPY  --  在表和文件之间拷贝数据
Synopsis
COPY [ BINARY ] table [ WITH OIDS ]    FROM { 'filename' | stdin }    [ [USING] DELIMITERS 'delimiter' ]    [ WITH NULL AS 'null string' ]COPY [ BINARY ] table [ WITH OIDS ]    TO { 'filename' | stdout }    [ [USING] DELIMITERS 'delimiter' ]    [ WITH NULL AS 'null string' ] 输入
BINARY
改变字段格式行为，强制所有数据都使用二进制格式存储和读取， 而不是以文本的方式． DELIMITERS 和 WITH NULL 选项和二进制格式无关．
table
现存表的名字．
WITH OIDS
拷贝每行的内部唯一对象标识（OID）．
filename
输入或输出的 Unix 文件的绝对文件名．
stdin
声明输入是来自客户端应用．
stdout
声明输入前往客户端应用．
delimiter
用于在文件中每行中分隔各个字段的字符．
null string
个代表 NULL 值的字串。缺省是 "\N" （反斜杠-N）。 当然，你可以自己挑一个空字串。
注意: 对于拷贝入（copy in），任何匹配这个字串的字串将被存储为 NULL 值， 所以你应该确保你用 的字串和拷贝出（copy out）相同。
输出
COPY
拷贝成功完成．
ERROR: reason
拷贝失败，原因在错误信息里．
描述
COPY在 PostgreSQL表和标准文件系统文件之间交换数据． COPY TO 把一个表的所有内容都拷贝到一个文件， 而 COPY FROM 从一个文件里拷贝数据到一个表里 （把数据附加到表中已经存在的内容里）．
COPY指示 PostgreSQL 后端直接从文件中读写数据．如果声明了文件名，那么该文件必须为后 端可见，而且文件名必须从后端的角度声明．如果声明的是 stdin 或 stdout， 数据通过客户前端流到后端．
小提示: 不要把 COPY 和 psql 指令 \copy 混淆在一起． \copy 调用 COPY FROM stdin 或 COPY TO stdout，然后抓取/存储 psql 客户端可以访问的一个文件里． 因此，使用 \copy 的时候，可访问性和访问权限取决于客户端而不是服务器端．
注意
BINARY 关键字将强制使用二进制对象而不是文本存储/读取所有数据． 这样做在一定程度上比传统的拷贝命令快，但二进制拷贝文件在不同机器体系间的植性不是很好．
缺省地，文本拷贝使用 tab （"\t"）字符作为分隔符． 分隔符仍然可以用关键字 USING DELIMITERS 改成任何其它的字符． 在数据中碰巧与分隔符相同的字符将用反斜扛引起．
你对任何要COPY 出来的数据必须有select 权限，对任何要 COPY 入数据的表必须有 insert 或 update 权限． 使用 COPY 时后端同样需要适当的对文件操作的 Unix 权限．
COPY TO不会激活规则，也不会处理字段缺省值。不过它的确激活触发器和检查约束。
COPY 在第一个错误处停下来．这些在 COPY FROM中不应该导致问题，但在 COPY TO 时目的表会已经接收到早先的行，这些行将不可见或不可访问，但是仍然会占据磁盘空间．如果你碰巧是拷贝很大一块数据文件的话，积累起来，这些东西可能会占据相当大的一部分磁盘空间．你可以调用 VACUUM来恢复那些磁盘空间．
COPY命令里面的文件必须是可以由后端直接读或写的文件，而不是由客户端应用读写．因此，它们必须位于数据库服务器上或者可以为数据库服务器所访问，而不是由客户端做这些事情．它们必须是PostgreSQL用户（服务器运行的用户 ID） 可以访问到并且 可读或者可写，而不是客户端． COPY 到一个命名文件是只允许数据库超级用户进行的， 因为它允许写任意后端有权限写的文件．
小技巧: psql指令 \copy 以客户的权限读或写在客户端的文件，因此不局限于超级用户．
我们建议在 COPY 里的文件名字总是使用 绝对路径．在 COPY TO 的时候是由后端强制 进行的，但是对于 COPY FROM，你的确有从一个声明为相对路径的文件里读取的选择．该路径将解释为相对于后端的 工作目录（在 $PGDATA 里的什么地方），而不是客户端的工作目录．
文件格式
文本格式
当不带 BINARY 选项使用 COPY TO 时，生成的文件每条元组占据一行，每列（字段）用分隔符分开．内嵌的分隔符字符将由一个反斜杠（"\"）开头．字段值本身是由与每个字段类型相关的输出函数生成的字符串．某一类型的输出函数本身不应该生成反斜杠；这个任务由 COPY 本身完成．
每个元组的实际格式是
<attr1><separator><attr2><separator>...<separator><attrn><newline>    请注意每行的结尾是用 Unix 风格的换行符（"\n"）标记的． 如果给出的文件包含 DOS 或 Mac 风格的换行符，那么 COPY FROM 将会出错．
如果声明了 WITH OIDST，它将被放在每行的开头．
如果 COPY TO 将它的输出输出到标准输出而不是一个文件，在拷贝结束时，它将在一个新行上输出一个反斜杠（"\"）和一个句点（"."），最后是一个换行符做为文件结束符．类似，如果 COPY FROM 从标准输入读入数据，它将把一行开头的由一个反斜杠（"\"）和一个句点（"."）和一个换行符组成的这三个连续字符作为文件结束符．不过，如果在这个特殊的文件结束模式出现前关闭了输入联接，那么COPY FROM 将正确结束（接着就是后端自身）．
反斜杠有其他的含义．一个文本反斜杠字符输出成两个连续的反斜杠 （"\\"） 一个文本tab字符用一个反斜 杠后面跟一个tab代表． (如果你使用了非 tab 作为列分隔符，那么在数据中出现的该字符将会使用反斜扛转意．) 一个文本新行字符用一个反斜杠和一个新行代表．当装载不是由 PostgreSQL 生成的文件时，你需要将反 斜杠字符 （"\"）转换成双反斜杠（"\\"）以保证正确装载．
二进制格式
在PostgreSQLv7.1 中的 COPY BINARY 的文件格式做了变化．新格式由一个文件头，零或多条元组， 以及文件尾组成．
文件头
文件头由 24 个字节的固定域组成，后面跟着一个变长的头扩展区．固定域是：
签名
12- 字节的序列 "PGBCOPY\n\377\r\n\0" --- 请注意空是签名是要求的一部分．（使用这个签名是为了让我们能够很容易看出文件是否已经被一个非 8 位安全的转换器给糟蹋了．这个签名会被换行符转换过滤器，删除空，删除高位，或者奇偶的改变而改变．）
整数布局域
以源机器的字节序的 int32 常量 0x1020304．如果在这里侦测到错误的字节序，那么读者很可能在后面的字段列造成了字节错位．
标志域
int32 位掩码表示该文件格式的重要方面．位是从 0（LSB）到 31 （MSB）编码的 --- 请注意这个域是以源机器的位权重存储的，后继的整数都是如此．位 16 - 31 是保留用做关键文件格式的；如果读者发现一个不认识的位出现在这个范围内，那么它应该退出．位 0-15 都保留为标志向后兼容的格式使用；读者可以忽略这个范围内的不认识的位．目前只定义了一个标志位，而其它的必须是零：
Bit 16
如果为 1，那么在倾倒中包括了 OID；如果为 0，则没有
头扩展范围长度
int32 以字节计的头剩余长度，不包括自身．在初始的版本里，它将会是零，后面紧跟第一条元组．对该格式的更多的修改都将允许额外的数据出现在头中．读者应该忽略任何它不知道该如何处理的头扩展数据．
头扩展数据是一个用来保留一个自定义的数据训练用的．这个标志域无意告诉读者扩展区的内容是什么．头扩展的具体设计内容留给以后的版本用．
这样设计就允许向下兼容头附加（增加头扩展块，或者设置低位序标志位） 以及非向下兼容修改（设置高位标志位以标识这样的修改，并且根据需要向扩展区域增加支持数据）．
元组
每条元组都以一个 int16 计数开头，该计数是元组中字段的数目．（目前，在一个表里的每条元组都有相同的计数，但可能不会永远这样．）然后后面不断出现元组中的各个字段，在字段数据后面可能跟着一个 int16 类型长度字．类型长度域是这样解释的：
零
数据域是 NULL．没有数据跟着．
> 0
数据域是定长数据类型．和类型长字相同的准确的 N 字节．
-1
数据域是变长的数据类型．下面四个字节是变长头， 它包含包括其自身在内的所有值长度．
< -1
保留为将来使用．
对于非 NULL 域，读者可以检查这个类型长度是否匹配目标列的长度．这样就提供了一种简单但有用的检查，核实该数据是否预期数据．
在数据域之间没有对奇填充或者任何其它额外的数据．还要注意该格式并不区分一种数据类型是传值还是传参．这些东西都是非常有意的：它们可能可以提高这些文件的移植性（尽管位权重和浮点格式等问题可能仍然不能让你进行跨机器移动二进制数据）．
如果在倾倒中包括了 OID，那么该 OID 域立即跟在域计数字后面．它是一个普通的域，只不过它没有包括在域计数．但它包括类型长度 --- 这样就允许我们不用花太多的劲就可以处理 4 字节和 8 字节，并且如果某个家伙允许 OID 是可选的话，那么还可以把 OID 显示成 NULL．
文件尾
文件尾包括一个 int16 字减 1．这样就很容易与一条元组的域计数字 相区分．
如果一个域计数字既不是 -1 也不是预期的字段的数目，那么读者应该报错．这样就提供了对丢失与数据的同步的额外的检查．
用法
下面的例子把一个表拷贝到标准输出， 使用竖直条（|）作为域分隔符：
COPY country TO stdout USING DELIMITERS '|'; 从一个 Unix 文件中拷贝数据到一个表范围中：
COPY country FROM '/usr1/proj/bray/sql/country_data'; 下面是一个可以从 stdin 中拷贝数据 到表中的例子（因此它在最后一行中有终止序列）：
AF      AFGHANISTANAL      ALBANIADZ      ALGERIAZM      ZAMBIAZW      ZIMBABWE\. 请注意在这里每行里的空白实际上是一个 TAB．
下面的是同样的数据，在一台 Linux/i586 机器上以二进制形式输出．这些数据是用 Unix 工具 od -c 过滤之后输出的．该表有三个域；第一个是 char(2)，第二个是 text， 第三个是integer．所有的行在第三个域都是一个 null 值．
0000000   P   G   B   C   O   P   Y \n 377 \r \n \0 004 003 002 0010000020 \0 \0 \0 \0 \0 \0 \0 \0 003 \0 377 377 006 \0 \0 \00000040   A   F 377 377 017 \0 \0 \0   A   F   G   H   A   N   I   S0000060   T   A   N \0 \0 003 \0 377 377 006 \0 \0 \0   A   L 3770000100 377 \v \0 \0 \0   A   L   B   A   N   I   A \0 \0 003 \00000120 377 377 006 \0 \0 \0   D   Z 377 377 \v \0 \0 \0   A   L0000140   G   E   R   I   A \0 \0 003 \0 377 377 006 \0 \0 \0   Z0000160   M 377 377 \n \0 \0 \0   Z   A   M   B   I   A \0 \0 0030000200 \0 377 377 006 \0 \0 \0   Z   W 377 377 \f \0 \0 \0   Z0000220   I   M   B   A   B   W   E \0 \0 377 377 兼容性 SQL92   在里没有 COPY 语句．

--------------------------------------------------------------------------------

CREATE AGGREGATE
CREATE AGGREGATE
Name
CREATE AGGREGATE  --  定义一个新的聚集函数
Synopsis
CREATE AGGREGATE name ( BASETYPE = input_data_type,
    SFUNC = sfunc, STYPE = state_type
    [ , FINALFUNC = ffunc ]
    [ , INITCOND = initial_condition ] )

输入
name
要创建的聚集函数名．
input_data_type
本聚集函数要处理的基本数据类型． 对于不检查输入类型的聚集来说，这个参数可以声明为 ANY． （比如 count(*)）．
sfunc
用于处理源数据列里的每一个输入数据的状态转换函数名称． 它通常是一个两个参数的函数，第一个参数的类型是 state_type 而第二个参数的类型是 input_data_type. 另外，对于一个不检查输入数据的聚集，该函数只接受一个类型为 state_type 的参数． 不管是哪种情况，此函数必须返回一个类型为 state_type的值． 这个函数接受当前状态值和当前输入数据条目，而返回下个状态值．
state_type
聚集的状态值的数据类型．
ffunc
在转换完所有输入域/字段后调用的最终处理函数．它计算聚集的结果． 此函数必须接受一个类型为 state_type 的参数．聚集的输出数据类型被定义为此函数的返回类型．如果没有声明 ffunc 则使用聚集结果的状态值作为聚集的结果，而输出类型为 state_type．
initial_condition
状态值的初始设置（值）．它必须是一个数据类型 state_type 可以接受的文本常量值． 如果没有声明，状态值初始为 NULL．
输出
CREATE
命令执行成功的返回信息．
描述
CREATE AGGREGATE允许用户或程序员通过定义新的聚集函数来扩展 PostgreSQL 的功能．一些用于基本类型的聚集函数如 min(integer) 和 avg(double precision) 等已经包含在基础软件包里了．如果你需要定义一个新类型或需要一个还没有提供的聚集函数，这时便可用 CREATE AGGREGATE 来提供我们所需要的特性．
一个聚集函数是用它的名字和输入数据类型来标识的． 如果两个聚集的输入数据不同，它们可以有相同的名字．要避免冲突， 不要写一个与聚集同名而且输入函数也相同的普通函数．
一个聚集函数是用一个或两个普通函数做成的： 一个状态转换函数 sfunc, 和一个可选的终计算函数 ffunc. 它们是这样使用的：
sfunc( internal-state, next-data-item ) ---> next-internal-state
ffunc( internal-state ) ---> aggregate-value
   
PostgreSQL 创建一个类型为 stype的临时变量． 它保存这个聚集的当前内部状态．对于每个输入数据条目，都调用状态转换函数计算内部状态值的新数值．在处理完所有数据后，调用一次最终处理函数以计算聚集的输出值．如果没有最终处理函数，那么将最后的状态值当做返回值．
一个聚集函数还可能提供一个初始条件，也就是说， 所用的该内部状态值的初始值．这个值是作为类型 text 的数据域存储在数据库里的， 不过它们必须是状态值数据类型的合法的外部表现形式的常量． 如果没有提供状态，那么状态值初始化为 NULL．
如果在 pg_proc 里该状态转换函数被定义为 "strict"， 那么 NULL 输入就不能调用它．这个时候，带有这样的转换函数的聚集执行起来的现象如下所述．NULL 输入的值被忽略（不调用此函数并且保留前一个状态值）．如果初始状态值是 NULL，那么由第一个非 NULL 值替换该状态值，而状态转换函数从第二个非 NULL 的输入值开始调用．这样做让我们比较容易 实现象 max 这样的聚集．请注意这种行为只是当 state_type 与 input_data_type 相同的时候才表现出来． 如果这些类型不同，你必须提供一个非 NULL 的初始条件或者使用一个非strice的状态转换函数．
如果状态转换函数不是 strict（严格）的， 那么它将无条件地为每个输入值调用，并且必须自行处理 NULL 输入和 NULL 转换值， 这样就允许聚集的作者对聚集中的 NULL 有完全的控制．
如果终转换函数定义为"strict"，则如果最终状态值是 NULL 时就不能调用它； 而是自动输出一个NULL的结果．（当然，这才是 strict 函数的正常特征．） 不管是那种情况，终处理函数可以选择返回 NULL．比如， avg 的终处理函数在零输入记录时就会返回 NULL．
注意
使用 DROP AGGREGATE 删除聚集函数．
CREATE AGGREGATE的参数可以以任何顺序书写，而不只是上面显示的顺序．
用法
请参考 PostgreSQL 程序员手册 聚集函数章节的聚集函数部分获取完整的例子．
兼容性 SQL92   
CREATE AGGREGATE是 PostgreSQL 语言的扩展． 在 里没有 CREATE AGGREGATE．

--------------------------------------------------------------------------------

CREATE CONSTRAINT TRIGGER
CREATE CONSTRAINT TRIGGER
Name
CREATE CONSTRAINT TRIGGER  --  定义一个新的约束触发器
Synopsis
CREATE CONSTRAINT TRIGGER name
    AFTER events ON
    relation constraint attributes
    FOR EACH ROW EXECUTE PROCEDURE func '(' args ')'

输入
name
约束触发器的名称．
events
触发该触发器的事件范围．
relation
被触发的关系名称．
constraint
实际的约束声明．
attributes
约束属性．
func(args)
触发器处理所调用的函数．
输出
CREATE CONSTRAINT
成功创建后的返回信息．
描述
CREATE CONSTRAINT TRIGGER被 CREATE/ALTER TABLE 内部使用以及被 pg_dump 用于创建那些用于参考完整性的特殊的触发器．
这条语句不是做一般用途用的．

--------------------------------------------------------------------------------

CREATE DATABASE
CREATE DATABASE
Name
CREATE DATABASE  --  创建新数据库
Synopsis
CREATE DATABASE name
    [ WITH [ LOCATION = 'dbpath' ]
           [ TEMPLATE = template ]
           [ ENCODING = encoding ] ]

输入
name
要创建的数据库名．
dbpath
在文件系统里存储新数据库的可选位置；用字串文本声明． 或者用 DEFAULT 表示使用缺省位置．
template
从哪个模板创建新数据库，这是模板名．或者用 DEFAULT 使用缺省模板（template1）．
encoding
创建新数据库用的多字节编码方法．声明一个字串文本名字 （比如，'SQL_ASCII'），或者一个整数编号，或者是 DEFAULT 表示使用缺省编码．
输出
CREATE DATABASE
命令成功执行的返回信息．
ERROR: user 'username' is not allowed to create/drop databases
你必须有特殊的 CREATEDB 权限来创建数据库。参阅 See CREATE USER。
ERROR: createdb: database "name" already exists
如果声明的数据库 name 已经存在返回的信息．
ERROR: database path may not contain single quotes
数据库路径名 dbpath 不能包含单引号。这样要求是为了创建数据库目录的 shell 命令能够正确执行。
ERROR: CREATE DATABASE: may not be called in a transaction block
如果你有一个明确的事务块正在处理，你不能调用 CREATE DATABASE。你必须先结束事务。
ERROR: Unable to create database directory 'path'.
ERROR: Could not initialize database directory.
这种情况最有可能是因为对数据目录权限不够， 磁盘已满或其他文件系统问题。数据库服务器运行的机器上的用户必 须能访问该路径。
描述
CREATE DATABASE创建一个新的 PostgreSQL 数据库．创建者成为新数据库的管理员．
可以声明一个可选的数据库位置，例如，在另一块硬盘上存放数据库。 该路径必须是事先用 initlocation命令准备好了的．
如果路径名不包含斜杠，那么它被解释成一个环境变量，该变量必须为服务进程所知。这样数据库管理员可以对能够在那里创建数据库进行控制。（例如，一个用户化的选择是 'PGDATA2'。）如果服务器带着 ALLOW_ABSOLUTE_DBPATHS （缺省时没有）选项编译，那么也允许使用以斜杠开头为标识的绝对路径（例如， ' '/usr/local/pgsql/data'）。
缺省时，新数据库将通过克隆标准系统数据库 template1 来创建．不同的模板可以用 TEMPLATE = name 来写．尤其是，如果你用 TEMPLATE = template0，你可以创建一个很纯净的数据库，只包括你的版本的 PostgreSQL 预定义的标准对象．这个方法可以避免把任何已经加入到template1 里的本地安装对象拷贝到新数据库．
可选的编码参数允许选择数据库编码， 如果你的服务器是带着多字节编码支持编译的话． 如果没有声明，缺省是所选用的模板数据库用的编码．
可选参数可以以任意顺序写，而不仅是上面显示的顺序．
注意
CREATE DATABASE是 PostgreSQL 语言的扩展．
使用 DROP DATABASE删除一个数据库．
程序 createdb是 是这个命令的 shell 脚本的封装，提供来方便使用。
在用绝对路径指定的可选数据库位置时， 有一些安全和数据完整性的问题， 而且缺省时只有后端识别的环境变量可以声明为可选的路径．参考管理员手册获取更多的信息．
尽管我们可以通过把某数据库名声明为模板从非template1数据库拷贝数据库，但是这（还）不是一个通用的 COPY DATABASE 功能． 因此，我们建议当做模板使用的数据库都应该是以只读方式对待的．参阅管理员手册获取更多信息．
用法
创建一个新的数据库：
olly=> create database lusiadas;
   
在另一个地方 ~/private_db创建新数据库：
$ mkdir private_db
$ initlocation ~/private_db
    The location will be initialized with username "olly".
This user will own all the files and must also own the server process.
Creating directory /home/olly/private_db
Creating directory /home/olly/private_db/base

initlocation is complete.
$ psql olly
Welcome to psql, the PostgreSQL interactive terminal.

Type: \copyright for distribution terms
       \h for help with SQL commands
       \? for help on internal slash commands
       \g or terminate with semicolon to execute query
       \q to quit
olly=> CREATE DATABASE elsewhere WITH LOCATION = '/home/olly/private_db';
CREATE DATABASE
兼容性 SQL92   
在 里没有 CREATE DATABASE 语句． 数据库等同于目录，其创建是由实现决定的．

--------------------------------------------------------------------------------

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 试图优化操作符并且可以决定使用索引来缩小相关操作符的搜索区间．但是，对函数将不会有任何优化的动作，而且是强制 执行．最后，函数可有任意个参数，而操作符限于一个或两个．