UPDATE:
UPDATE A SET ApproverID=NULL
FROM [SH_MaterialApplyBuyBill] A
LEFT JOIN [SH_MaterialApplyBuyBillDetail] B ON A.ID=B.[MaterialApplyBuyBillID]
WHERE A.id=125 AND @InDetailCount=0
DELETE:
DELETE A FROM [SH_ClosingBalance] A LEFT JOIN [SH_StoreHouse] B ON A.StoreHouseID=B.ID
WHERE B.departmentID='1000'
======================================================================
Update XXX set XXX where 这种写法大家肯定都知道,才发现update和delete居然支持inner join的update方式,这个在表间关联来做更新和删除操作非常有用.
列子:
- update tb_User
- set pass=''
- from tb_User usr
- inner join tb_Address addr on usr.nAddressFK = addr.nAddressID
- where usr.id=123
update tb_User set pass='' from tb_User usr inner join tb_Address addr on usr.nAddressFK = addr.nAddressID where usr.id=123
update的格式是
update t1 set t1.name=’Liu’ from t1 inner join t2 on t1.id = t2.tid
MYSQL,ACCESS 写法如下:
- UPDATE mem_world AS mw1 INNER JOIN mem_world AS mw2
- ON mw1.parentid = mw2.wid
- SET mw1.level = mw2.level
- WHERE mw2.baseid = 107
- AND mw2.parentid = 0
- AND mw2.size > 1;
UPDATE mem_world AS mw1 INNER JOIN mem_world AS mw2 ON mw1.parentid = mw2.wid SET mw1.level = mw2.level WHERE mw2.baseid = 107 AND mw2.parentid = 0 AND mw2.size > 1;
on是表连接的筛选条件
就是说,表连接后,会产生一个类似于临时的视图这么一个东西
where是从这个临时的视图中筛选数据的
所以,你首先要搞清,你的所谓的2个条件属于哪一种
Delete
delete 语句也是类似
delete from t1 from t1 inner join t2 on t1.id = t2.tid
注意蓝色部分。
mysql:
- DELETE mwb FROM mem_world_building AS mwb INNER JOIN mem_world AS mw
- ON mwb.wid = mw.wid
- where mw.type between 11 and 15
- and baseid = 107
- and mw.parentid <> 0
- and mw.size > 1;
DELETE mwb FROM mem_world_building AS mwb INNER JOIN mem_world AS mw ON mwb.wid = mw.wid where mw.type between 11 and 15 and baseid = 107 and mw.parentid <> 0 and mw.size > 1;
下面是ORACLE的:
- DELETE TABLE1 where exists ( select 1 from table2 where and table1.khid=table2.khid and FWDWID=8);
DELETE TABLE1 where exists ( select 1 from table2 where and table1.khid=table2.khid and FWDWID=8);
- DELETE TABLE1 where KHID exists ( select KHID from table2 where FWDWID=8)
Oracle的 update (SQL) t set t.XX =
========================================================================================
sql 大全
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 认为它们都没有什么用, (比如,在一个唯一键字的字段上没有公共的数值)或者是该字段数据类型不支持相关的操作符,那么它们都可以忽略.在用户手册 中有关于统计的更多信息.
分析的广度可以通过用 ALTERTABLE ALTER COLUMN SET STATISTICS (参阅 ALTERTABLE调整每字段的统计目标来控制.目标数值设置最常用数值列表中的记录的最大数目以及包线图中的最大块数.缺省的目标数值是10,不过我们可以调节 这个数值获取规划器计算精度和 ANALYZE 运行所需要的 时间以及 pg_statistic里面占据的空间数目之间的 平衡.特别是,把统计目标设置为零就关闭了该字段的统计收集. 对那些从来不参与到查询的 WHERE,GROUPBY,或者 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 里缺省的事务隔离级别是 READCOMMITTED, 这时在事务内部的查询只看到查询提交之前的(数据)修改。 所以,如果你需要更严格的事务隔离,你必须在 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 TOstdout,然后抓取/存储 psql 客户端可以访问的一个文件里. 因此,使用 copy 的时候,可访问性和访问权限取决于客户端而不是服务器端.
注意
BINARY 关键字将强制使用二进制对象而不是文本存储/读取所有数据. 这样做在一定程度上比传统的拷贝命令快,但二进制拷贝文件在不同机器体系间的植性不是很好.
缺省地,文本拷贝使用 tab (" ")字符作为分隔符. 分隔符仍然可以用关键字 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 的时候是由后端强制 进行的,但是对于 COPYFROM,你的确有从一个声明为相对路径的文件里读取的选择.该路径将解释为相对于后端的 工作目录(在 $PGDATA 里的什么地方),而不是客户端的工作目录.
文件格式
文本格式
当不带 BINARY 选项使用 COPY TO 时,生成的文件每条元组占据一行,每列(字段)用分隔符分开.内嵌的分隔符字 符将由一个反斜杠("")开头.字段值本身是由与每个字段类型相关的输出函数生成的字符串.某一类型的输出函数本身不应该生成反斜杠;这个任务由 COPY 本身完成.
每个元组的实际格式是
<attr1><separator><attr2><separator>...<separator><attrn><newline> 请注意每行的结尾是用 Unix 风格的换行符("
")标记的. 如果给出的文件包含 DOS 或 Mac 风格的换行符,那么 COPYFROM 将会出错.
如果声明了 WITH OIDST,它将被放在每行的开头.
如果 COPY TO将它的输出输出到标准输出而不是一个文件, 在拷贝结束时,它将在一个新行上输出一个反斜杠("")和一个句点("."),最后是一个换行符做为文件结束符.类似,如果 COPY FROM 从标准输入读入数据,它将把一行开头的由一个反斜杠("")和一个句点(".")和一个换行符组成的这三个连续字符作为文件结束符. 不过,如果在这个特殊的文件结束模式出现前关闭了输入联接,那么COPY FROM 将正确结束(接着就是后端自身).
反斜杠有其他的含义.一个文本反斜杠字符输出成两个连续的反斜杠 ("\") 一个文本tab字符用一个反斜 杠后面跟一个tab代表. (如果你使用了非 tab作为列分隔符,那么在数据中出现的该字符将会使用反斜扛转意.) 一个文本新行字符用一个反斜杠和一个新行代表. 当装载不是由 PostgreSQL生成的文件时,你需要将反 斜杠字符 ("")转换成双反斜杠("\")以保证正确装载.
二进制格式
在PostgreSQLv7.1 中的 COPY BINARY 的文件格式做了变化.新格式由一个文件头,零或多条元组, 以及文件尾组成.
文件头
文件头由 24 个字节的固定域组成,后面跟着一个变长的头扩展区.固定域是:
签名
12-字节的序列 "PGBCOPY
377
" ---请注意空是签名是要求的一部分.(使用这个签名是为了让我们能够很容易看出文件是否已经被一个非 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
377
004 003 002 0010000020 003 377 377 006 0000040 A F 377 377017 A F G H A N I S0000060 T A N 003 377 377 006 A L 3770000100 377 v A L B A N I A 003 0000120 377 377 006 D Z377 377 v A L0000140 G E R I A 003 377377 006 Z0000160 M 377 377
Z A M B I A 0030000200 377 377 006 Z W 377 377 f Z0000220 I M B A B W E 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
命令执行成功的返回信息.
描述
CREATEAGGREGATE允许用户或程序员通过定义新的聚集函数来扩展 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 子句为空,那么 CREATEFUNCTION 假设函数的 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 子句为空,那么 CREATEFUNCTION 假设函数的 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).当定义第二个操作符时,将第一个符号作为交换符或负号符.第一个将因上述的副作用一样被更新(而获得交换符 或负号符).(对于PostgreSQL6.5, 把两个操作符指向对方同样也行。)
HASHES,SORT1 和 SORT2 选项将为查询优化器进行连接查询时提供支持.PostgreSQL 能够总是用反复替换来计算一个连接(也就是说,处理这样的子句,该子句有两个元组变量,这两个变量被一个操作符分开,这个操作符返回一个boolean量) [WONG76]. 另外, PostgreSQL 可以延着[SHAP86]实现一个散列-连接算法(hash-joinalgorithm);但是,我们必须知道这个策略是否可行.目前的散列-连接算法只是对代表相等测试的操作符有效;而且,数据类型的相等必须意味着类型的表现是按位相等的。(例如,一个包含未用的位的数据类型,这些位对相等测试没有影响,但却不能用于哈希连接。)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 在 ONINSERT 和 ON UPDATE 规则里 可以指向被插入或更新的新行. old 在 ON UPDATE,和 ON DELETE规则里可以指向现存的被更新,或者删除的行.
输出
CREATE
成功创建规则后的返回信息.
描述
PostgreSQL 规则系统 允许我们在从数据库或表中更新, 插入或删除东西时定义一个可选的动作来执行。目前,规则用于实现表视图。
规则的语意是在一个单独的记录正被访问,更新,插入或删除时, 将存在一个旧记录(用于检索,更新和删除)和一个新记录(用于更新和追加).这时给定事件类型和给定目标对象(表)的所有规则都将被检查, (顺序不定). 如果在 WHERE (如果有)子句里面所声明的condition? 为真,那么 action 部分的规则就被执行. 如果声明了 INSTEAD,那么 action就会代替原来的查询;否则,如果是 ON INSERT 那么它在原来的查询之后执行,如果是 ON UPDATE 或者 ONDELETE,那么它在原来的查询之前执行.在 condition 和 action 里面, 在旧记录里字段的数值和/或新记录里字段的数值被old. attribute-name 和 new. attribute-name 代替.
规则的 action部分可以由一条或者多条查询组成.要写多个查询,用圆括弧或者方括弧 把它们包围起来.这样的查询将以声明的顺序执行(只是我们不能保证对一个对象的多个规则的执行顺序). action 还可以是 NOTHING表示没有动作.因此,一个 DO INSTEAD NOTHING 规则制止了原来的查询的运行(当条件为真时); DO NOTHING规则是没有用的.
规则的 action 部分 执行的时候带有和触发动作的用户命令相同的命令和事务标识符.
规则和视图
目前,ON SELECT 规则必须是无条件的 INSTEAD 规则并且 必须有一个由一条 SELECT 查询组成的动作.因此,一条 ONSELECT 规则有效地把对象表转成视图,它的可见内容 是规则的 SELECT 查询返回的记录而不是存储在表中的内容(如果有的话).我们认为写一条 CREATE VIEW 命令比创建一个表然后定义一条 ON SELECT 规则在上面的风格要好.
CREATEVIEW 创建一个虚拟表(没有下层的存储) 以及相关的 ON SELECT 规则.系统不允许对视图进行更新,因为它知道在视图上没有真正的表.你可以创建一个可以更新的视图的幻觉, 方法是在视图上定义 ON INSERT,ON UPDATE,和 ONDELETE 规则 (或者满足你需要的任何上述规则的子集),用合适的对其它表的更新替换 在视图上更新的动作.
如果你想在视图更新上使用条件规则,那么这里就有一个补充∶ 对你希望在视图上允许的每个动作,你都必须有一个无条件的 INSTEAD 规则.如果规则是有条件的,或者它不是INSTEAD, 那么系统仍将拒绝执行更新动作的企图,因为它认为它最终会在某种 程度上在虚拟表上执行动作.如果你想处理条件规则上的所由有用的情况,那也可以;只需要增加一个无条件的 DO INSTEAD NOTHING 规则确保系统明白它将决不会被调用来更新虚拟表就可以了.然后把条件规则做成非 INSTEAD; 在这种情况下,如果它们被触发,那么它们就增加到缺省的 INSTEADNOTHING 动作中.
注意
为了在表上定义规则,你必须有规则定义权限. 用 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)
FOREIGNKEY ( column [, ... ] ) REFERENCES reftable [ ( refcolumn [, ... ] ) ][ MATCH matchtype ] [ ON DELETE action ] [ ON UPDATE action ] (tableconstraint)
REFERENCES 列约束声明一个由新表中一列或者多列组成的组应该只包含匹配引用的表 reftable中对应引用的字段 refcolumn 中的数值. 如果省略 refcolumn, 则使用 reftable 的主键.被引用字段必须是被引用表中的唯一字段或者主键.
向这些字段增加的数值将使用给出的匹配类型与参考表中的参考列中的数值进行匹配.有三种匹配类型∶MATCH FULL, MATCH PARTIAL,和一种缺省匹配类型(如果没有声明匹配类型的话).MATCH FULL 将不允许一个多字段外键的 字段为 NULL,除非所有外键字段都为 NULL.缺省匹配类型允许某些外键字段为 NULL 而外键的其它部分不是 NULL.MATCH PARTIAL 还没实现.
另外,当被参考字段中的数据改变的时候,那么将对本表的字段中的数据 执行某种操作.ON DELETE 子句声明当被参考表中的 被参考行将被删除的时候要执行的操作.类似,ONUPDATE 子句声明被参考表中被参考字段更新为新值的时候要执行的动作.如果该行被更新,但被参考的字段实际上没有变化,那么就不会有任何动作.下面是每个子句的可能的动作∶
NO ACTION
生成一个错误,表明删除或者更新将产生一个违反外键约束的动作. 它是缺省动作.
RESTRICT
和 NO ACTION 一样.
CASCADE
删除任何引用了被删除行的行,或者分别把引用行的字段值更新为 被参考字段的新数值.
SET NULL
把引用行数值设置为 NULL.
SET DEFAULT
把引用列的数值设置为它们的缺省值.
如果主键字段经常更新,那么我们给 REFERENCES 字段增加一个索引可能是合适的,这样与 REFERENCES 字段 相关联的 NO ACTION 和 CASCADE 动作可以更有效地执行.
DEFERRABLE 或 NOT DEFERRABLE
这两个关键字设置该约束是否可推迟.一个不可推迟的约束将在每条命令之后 马上检查.可以推迟的约束检查可以推迟到事务结尾 (使用 SETCONSTRAINTS命令).缺省是 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 ]
ONCOMMIT 子句表明该临时表在执行 COMMIT 的时候是否应该清空行. 如果省略了 ON OMMIT 子句, 声明缺省是 ONCOMMIT 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 是新类型的名称而且必须在所定义的数据库中唯一.
CREATETYPE需要在定义类型之前先注册两个函数(用 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 程序员手册
--------------------------------------------------------------------------------
CREATE USER
Name
CREATE USER -- 创建一个新的数据库用户帐户
Synopsis
CREATE USER username [ [ WITH ] option [ ... ] ]
这里 option 可以是∶
SYSID uid
| [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'
| CREATEDB | NOCREATEDB
| CREATEUSER | NOCREATEUSER
| IN GROUP groupname [, ...]
| VALID UNTIL 'abstime'
输入
username
用户名
uid
SYSID 子句可以用于选择正在被创建的用户的 PostgreSQL 用户标识。 这个用户标识不需要和 UNIX 系统用户标识匹配,但是有些人愿意让两者相同。
如果没有声明这个,缺省使用已分配的最高用户标识加一。
[ encrypted | unencrypted ] password
设置用户的口令,如果你不准备使用口令认证, 那么你可以省略这个选项,否则该用户将不能联接到一个口令认证的服务器上。
ENCRYPTED/UNENCRYPTED 控制口令在数据库中是否以加密 形式存储.使用加密口令存储的时候老的客户端可能有通讯问题.
参阅 管理员手册中关于客户端认证的部分 获取关于如何设置认证机制的详细信息。
CREATEDB
NOCREATEDB
这个子句定义用户的创建数据库权限. 如果声明了 CREATEDB,被定义的用户将允许创建其自己的数据库.而使用 NOCREATEDB 将否决该用户的创建数据库的能力. 如果忽略本子句,缺省是 NOCREATEDB.
CREATEUSER
NOCREATEUSER
该子句决定一个用户是否能创建一个新的用户. 这个选项同样把次用户变成数据库超级用户,可以跨越所有 访问限制。省略这个参数将置用户的这个属性为 NOCREATEUSER.
groupname
一个组名称,把这个用户设为该组成员。 你可以列出多个组名字.
abstime
VALID UNTIL (有效期)子句设置一个绝对时间,过了该时间后用户的 PostgreSQL 登陆将不再有效. 如果省略这个子句,登陆将总是有效的.
输出
CREATE USER
如果命令成功完成,返回此信息.
描述
CREATE USER将向一个 PostgreSQL 实例增加一个新用户.参考管理员手册获取关于管理用户和认证的信息。 要执行这条命令,你必须是一个数据库超级用户。
使用 ALTER USER修改用户的口令和权限, DROP USER删除一个用户。 使用 ALTER GROUP从组中增加或删除用户。PostgreSQL 里有一个脚本 createuser与此命令相同的功能(实际上,它调用这条命令), 但是可以在命令行上运行。
用法
创建一个没有口令的用户:
CREATE USER jonathan
创建一个有口令的用户:
CREATE USER davide WITH PASSWORD 'jw8s0F4'
创建一个有口令的用户,其帐号在2001年底失效. 注意当2002年走过一秒后,该帐号将不再有效:
CREATE USER miriam WITH PASSWORD 'jw8s0F4' VALID UNTIL 'Jan 1 2002'
创建一个拥有创建数据库权限的用户:
CREATE USER manuel WITH PASSWORD 'jw8s0F4' CREATEDB
兼容性 SQL92
在里没有CREATE USER 语句.
--------------------------------------------------------------------------------
CREATE VIEW
Name
CREATE VIEW -- 定义一个视图
Synopsis
CREATE VIEW view AS SELECT query
输入
view
所要创建的视图名称.
query
一个将为视图提供行和列的 SQL 查询.
请参阅 SELECT 语句获取有效参数的更多信息.
输出
CREATE
如果视图创建成功,返回此信息.
ERROR: Relation 'view' already exists
如果在数据库中已经存在所声明的视图.
NOTICE: Attribute 'column' has an unknown type
如果不声明,所创建的视图将有一个未知类型的字段. 例如,下面命令返回一个警告:
CREATE VIEW vista AS SELECT 'Hello World'
然而下面命令将不出现警告:
CREATE VIEW vista AS SELECT text 'Hello World'
描述
CREATE VIEW将定义一个表的视图. 这个视图不是物理上实际存在(于磁盘)的.具体的说,自动生成 一个改写索引规则的查询用以支持在视图上的检索.
注意
目前,视图是只读的∶系统将不允许在视图上插入,更新,或者删除数据.你可以通过在视图上创建把插入等动作重写为向其它表做合适操作的规则来 实现可更新视图的效果.更多信息详见 CREATE RULE .
使用 DROP VIEW 语句删除视图.
用法
创建一个由所有 Comedy (喜剧)电影组成的视图:
CREATE VIEW kinds AS
SELECT *
FROM films
WHERE kind = 'Comedy';
SELECT * FROM kinds;
code | title | did | date_prod | kind | len
-------+---------------------------+-----+------------+--------+-------
UA502 | Bananas | 105 | 1971-07-13 | Comedy | 01:22
C_701 | There's a Girl in my Soup | 107 | 1970-06-11 | Comedy | 01:36
(2 rows)
兼容性 SQL92
为 CREATE VIEW 声明了一些附加的功能:
CREATE VIEW view [ column [, ...] ]
AS SELECT expression [ AS colname ] [, ...]
FROM table [ WHERE condition ]
[ WITH [ CASCADE | LOCAL ] CHECK OPTION ]
完整的命令可选的子句是:
CHECK OPTION
这个选项用于可更新视图. 所有对视图的 INSERT 和 UPDATE 都要经过视图定义条件的校验. 如果 没有通过校验,更新将被拒绝.
LOCAL
对这个视图进行完整性检查.
CASCADE
对此视图和任何相关视图进行完整性检查. 在既没有声明 CASCADE 也没有声明 LOCAL 时,假设为 CASCADE.
--------------------------------------------------------------------------------
DECLARE
DECLARE
Name
DECLARE -- 定义一个游标
Synopsis
DECLARE cursorname [ BINARY ] [ INSENSITIVE ] [ SCROLL ]
CURSOR FOR query
[ FOR { READ ONLY | UPDATE [ OF column [, ...] ] ]
输入
cursorname
将在随后 FETCH 操作中使用的游标名.
BINARY
令游标以二进制而不是文本格式获取数据.
INSENSITIVE
关键字, 表明从游标检索出来的数据不应该被其他进程或游标的更新动作影响. 因为在 PostgreSQL 里,游标的操作总是发生在事务 里,所以总是符合上面描述.这个关键字没有作用.
SCROLL
关键字,表明每个 FETCH 操作可以检索出多行数据. 因为在PostgreSQL 在任何情况下都允许这样, 所以这个关键字没有作用.
query
一个 SQL 查询,它提供由游标控制的行. 请参考 SELECT 语句获取有关有效参数的详细信息.
READ ONLY
关键字,表明游标将用于只读模式. 因为这是 PostgreSQL 唯一的游标访问模式,所以该关键字没有作用.
UPDATE
关键字,表明游标将被用于更新表. 因为游标更新目前还不被 PostgreSQL 支持,所以这个关键字将产生一个错误信息.
column
将被更新的列.因为游标更新目前不被 PostgreSQL 支持, 所以 UPDATE 子句将产生一个错误信息.
输出
SELECT
如果 SELECT 成功运行,返回此信息.
NOTICE: Closing pre-existing portal "cursorname"
如果在当前的事务块中此游标名称已经定义,返回此信息. 前面定义的游标被丢弃.
ERROR: DECLARE CURSOR may only be used in begin/end transaction blocks
如果一个游标没有在事务块内部定义,返回此信息.
描述
DECLARE允许用户创建游标, 用于在一个大的查询里面检索少数几行数据. 使用 FETCH,游标可以既可以返回文本也可以返回二进制格式。 .
通常游标返回文本格式,要么是 ASCII 要么是某种由 PostgreSQL 特定的后端决定的编码方式.因为数据在系统内部是用二进制格式存储的, 系统必须对数据做一定转换以生成文本格式.另外,文本格式一般都比对应的二进制格式占的存储空间大.一旦格式转换回文本,客户应用需要将文本转换为二进制格式来操作. BINARY 游标给你返回内部二进制形态的数据。
作为例子,如果查询从一个整数列返回一个一, 在通常的游标里你将获得一个字符串'1'而如果是一个二进制查询,你将得到一个 4-字节的等于ctrl-A('^A')的数值.
游标应该小心使用 BINARY. 一些用户应用如 psql 是不识别二进制游标的, 而且期望返回的数据是文本格式.
而且,字符串表示方式是与硬件体系无关的, 而二进制格式会因不同的硬件体系不同而不同,而且 PostgreSQL对二进制游标不做字节序解析或者其他格式转换 。 因此,如果你的客户机和服务器使用不同的格式 (如: "高位高字节" 和"底位底字节").你可能就不会希望你的数据以二进制格式返回.所以二进制游标将比文本略微快一点,因为二进制在服务器和客户端的数据传输中有较少的转换.
小技巧: 如果你希望用 ASCII 显示数据, 将数据以 ASCII 模式访问将节省客户端的工作.
注意
游标只能在事务中使用.使用 BEGIN, COMMIT和 ROLLBACK定义一个事务块。
在中游标只能在嵌入 SQL (ESQL) 的应用中使用. PostgreSQL 后端没有一个明确的 OPEN cursor语句;一个游标被认为在定义时就已经打开了. 不过,PostgreSQL嵌入的 SQL 预编译器, ecpg, 支持 习惯,包括那些和DECLARE 和 OPEN 相关的语句.
用法
定义一个游标:
DECLARE liahona CURSOR
FOR SELECT * FROM films;
兼容性 SQL92
只允许在嵌入的 SQL 中和模块中使用游标. PostgreSQL 允许交互地使用游标. 允许嵌入或模块的游标更新数据库信息. 所有 PostgreSQL 的游标都是只读的. BINARY 关键字是 PostgreSQL 扩展.
--------------------------------------------------------------------------------
DELETE
DELETE
Name
DELETE -- 删除一个表中的行
Synopsis
DELETE FROM [ ONLY ] table [ WHERE condition ]
输入
table
一个现存表的名字
condition
这是一个 SQL 选择查询,它返回要被删除的行.
请参考 SELECT 语句获取关于 WHERE 子句的更多信息.
输出
DELETE count
如果行被成功的删除返回此信息. count 是要被删除的行数.
如果 count 为 0, 没有行被删除.
描述
DELETE从指明的表里删除满足 WHERE condition (条件)的行.
如果 condition (WHERE 子句)不存在, 效果是删除表中所有行.结果是一个有效的空表.
小技巧: TRUNCATE 是一个 PostgreSQL 扩展, 它提供一个更快的从表中删除所有行的机制。
缺省时DELETE将删除所声明的表和所有它的子表的记录. 如果你希望只更新提到的表,你应该使用OLNY子句.
要对表进行修改,你必须有写权限,同样也必须有读表的权限,这样才能对符合 condition(条件) 的值进行读取操作.
用法
删除所有电影(films)但不删除音乐(musicals):
DELETE FROM films WHERE kind <> 'Musical';
SELECT * FROM films;
code | title | did | date_prod | kind | len
-------+---------------------------+-----+------------+---------+-------
UA501 | West Side Story | 105 | 1961-01-03 | Musical | 02:32
TC901 | The King and I | 109 | 1956-08-11 | Musical | 02:13
WD101 | Bed Knobs and Broomsticks | 111 | | Musical | 01:57
(3 rows)
清空表 films:
DELETE FROM films;
SELECT * FROM films;
code | title | did | date_prod | kind | len
------+-------+-----+-----------+------+-----
(0 rows)
兼容性 SQL92
允许定位的 DELETE (删除)语句:
DELETE FROM table WHERE
CURRENT OF cursor
这里 cursor 表示一个打开的游标. PostgreSQL 里交互式游标是只读的.
--------------------------------------------------------------------------------
DROP AGGREGATE
DROP AGGREGATE
Name
DROP AGGREGATE -- 删除一个用户定义的聚集函数
Synopsis
DROP AGGREGATE name type
输入
name
现存的聚集函数名。
type
现存的聚集函数的输入数据类型,或者 * -- 如果这个聚集函数接受任意输入类型.(请参考 PostgreSQL 用户手册 获取关于数据类型的更多信息)。
输出
DROP
命令成功的返回信息.
ERROR: RemoveAggregate: aggregate 'name' for type type does not exist
如果声明的函数在数据库中不存在,返回此信息.
描述
DROP AGGREGATE将删除对一个现存聚集函数的所有索引. 执行这条命令的用户必须是该聚集函数的所有者.
注意
使用 CREATE AGGREGATE语句创建一个聚集函数。
用法
将类型 int4的聚集函数 myavg 删除:
DROP AGGREGATE myavg(int4);
兼容性 SQL92
在 中没有 DROP AGGREGATE语句. 该语句是一个 PostgreSQL 语言的扩展.
--------------------------------------------------------------------------------
DROP DATABASE
Name
DROP DATABASE -- 删除一个数据库.
Synopsis
DROP DATABASE name
输入
name
要被删除的现有数据库名.
输出
DROP DATABASE
如果命令成功执行,返回此命令.
DROP DATABASE: cannot be executed on the currently open database
你不能和准备删除的数据库建立联接.你需要和 template1 或者任何其它的数据库相连来运行这些命令.
DROP DATABASE: cannot be executed on the currently open database
执行这条命令之前你必须先结束正在处理的事务。
描述
DROP DATABASE删除一个现存数据库的目录入口并且删除包含数据的目录.只有数据库所有者能够执行这条命令(通常也是数据库创建者).
DROP DATABASE不能撤销,小心使用.
注意
这条命令在和目标数据库联接时不能执行. 通常更好的做法是用 dropdb脚本代替,该脚本是此命令的一个封装。 ,
请参考 CREATE DATABASE语句获取如何创建数据库的信息.
兼容性 SQL92
DROP DATABASE是一个 PostgreSQL 语言的扩展. 在 中没有这条命令.
--------------------------------------------------------------------------------
DROP FUNCTION
Name
DROP FUNCTION -- 删除一个用户定义的函数
Synopsis
DROP FUNCTION name ( [ type [, ...] ] )
输入
name
现存的函数名称.
type
函数参数的类型.
输出
DROP
命令成功执行的返回信息.
NOTICE RemoveFunction: Function "name" ("types") does not exist
如果当前数据库里不存在所声明的函数,返回此信息.
描述
DROP FUNCTION 将删除一个现存的函数的引用.要执行这条命令,用户必须是函数的所有者. 必须声明函数的输入参数类型,因为几个不同的函数可能会有同样的名字 和不同的参数列表.
注意
请参考 CREATE FUNCTION 获取创建聚集函数的信息.
对依赖于该函数的类型, 操作符访问方式或者触发器是否事先被删除不做任何校验.
用法
这条命令删除平方根函数:
DROP FUNCTION sqrt(int4);
兼容性 SQL92
DROP FUNCTION是 PostgreSQL 语言的扩展.
SQL/PSM
SQL/PSM 是一个为实现函数扩展能力而提出的标准. SQL/PSM DROP FUNCTION 语句有下面的语法:
DROP [ SPECIFIC ] FUNCTION name { RESTRICT | CASCADE }
--------------------------------------------------------------------------------
DROP GROUP
DROP GROUP
Name
DROP GROUP -- 删除一个用户组
Synopsis
DROP GROUP name
输入
name
现存组名。
输出
DROP GROUP
成功删除组后返回的信息。
描述
DROP GROUP从数据库中删除指定的组。组中的用户不被删除。 组中的用户不被删除。
使用 CREATE GROUP增加新组,用 ALTER GROUP修改组的成员。
用法
删除一个组:
DROP GROUP staff;
兼容性 SQL92
里没有 DROP GROUP.
--------------------------------------------------------------------------------
DROP INDEX
Name
DROP INDEX -- 删除一个索引
Synopsis
DROP INDEX index_name [, ...]
输入
index_name
要删除的索引名.
输出
DROP
如果索引成功删除返回的信息.
ERROR: index "index_name" does not exist
如果 index_name 不是这个数据库的索引,返回此信息.
描述
DROP INDEX从数据库中删除一个现存的索引. 要执行这个命令,你必须是索引的所有者. the index.
注意
DROP INDEX是PostgreSQL 语言扩展.
请参考 CREATE INDEX语句获取如何创建索引的信息.
用法
此命令将删除title_idx 索引:
DROP INDEX title_idx;
兼容性 SQL92
定义用于访问纯关系型数据库的命令. 索引是一个与具体实现相关的特性,因而没有与具体实现相关的特性或定义在 语言里面.
--------------------------------------------------------------------------------
DROP LANGUAGE
DROP LANGUAGE
Name
DROP LANGUAGE -- 删除一个用户定义的过程语言
Synopsis
DROP [ PROCEDURAL ] LANGUAGE 'name'
输入
name
现存语言的名称.
输出
DROP
如果语言成功删除,返回此信息.
ERROR: Language "name" doesn't exist
如果语言 name 没有找到,返回此信息.
描述
DROP PROCEDURAL LANGUAGE将删除曾注册过的过程语言 name.
注意
DROP PROCEDURAL LANGUAGE语句是 PostgreSQL 语言的扩展.
请参考 CREATE LANGUAGE获取如何创建过程语言的信息.
将不会校验用这种语言注册的函数或触发器是否仍然存在. 要想重新使用这些东西而不用删除和重新创建所有这些函数, 函数 pg_proc 的 prolang字段/属性必须调整为为 PL 重新创建的 pg_language 入口的新对象标识( OID).
用法
下面命令删除 PL/Sample 语言:
DROP PROCEDURAL LANGUAGE 'plsample';
兼容性 SQL92
在里没有 DROP PROCEDURAL LANGUAGE.
--------------------------------------------------------------------------------
DROP OPERATOR
DROP OPERATOR
Name
DROP OPERATOR -- 删除一个用户定义操作符
Synopsis
DROP OPERATOR id ( lefttype | NONE , righttype | NONE )
输入
id
一个现存的操作符的标识符.
lefttype
该操作符左参数的类型.如果该操作符没有左参数, 写 NONE.
righttype
该操作符右参数的类型.如果该操作符没有右参数, 写 NONE.
输出
DROP
命令成功执行的返回函数.
ERROR: RemoveOperator: binary operator 'oper' taking 'lefttype' and 'righttype' does not exist
如果声明的双目操作符不存在,返回此信息.
ERROR: RemoveOperator: left unary operator 'oper' taking 'lefttype' does not exist
如果声明的左目操作符不存在,返回此信息.
ERROR: RemoveOperator: right unary operator 'oper' taking 'righttype' does not exist
如果声明的右目操作符不存在,返回此信息.
描述
DROP OPERATOR语句从数据库中删除一个现存的操作符. 要执行这个命令,你必须是操作符所有者.
左目操作符的右类型或右目操作符的左类型可以声明为 NONE.
注意
DROP OPERATOR语句是 PostgreSQL 语言扩展.
请参考 CREATE OPERATOR获取如何创建操作符的信息.
删除任何依赖于被删除的操作符的访问模式和操作符表是用户的责任.
用法
将用于int4的幂操作符 a^n 删除:
DROP OPERATOR ^ (int4, int4);
删除用于boolean变量的左目取反操作符(! b):
DROP OPERATOR ! (none, bool);
删除用于 int4的阶乘 (! i) : int4:
DROP OPERATOR ! (int4, none);
兼容性 SQL92
在里没有 DROP OPERATOR 语句.
--------------------------------------------------------------------------------
DROP RULE
DROP RULE
Name
DROP RULE -- 删除一个重写规则
Synopsis
DROP RULE name [, ...]
输入
name
要删除的现存的规则.
输出
DROP
删除成功返回的信息.
ERROR: Rule or view "name" not found
如果声明的规则不存在,返回此信息.
描述
DROP RULE从声明的 PostgreSQL规则系统里删除一个规则. PostgreSQL 将立即停止使用之并且将会把它从系统表中清理出去.
注意
DROP RULE语句是 PostgreSQL 语言的扩展.
请参考 CREATE RULE 获取如何创建规则的信息.
一旦一个规则被删除掉,该规则所写的历史记录信息将可能不存在.
用法
删除重写规则 newrule:
DROP RULE newrule;
兼容性 SQL92
在 中没有DROP RULE.
--------------------------------------------------------------------------------
DROP SEQUENCE
DROP SEQUENCE
Name
DROP SEQUENCE -- 删除一个序列
Synopsis
DROP SEQUENCE name [, ...]
输入
name
序列名.
输出
DROP
序列成功删除后返回的信息.
ERROR: sequence "name" does not exist
如果声明的序列不存在,返回此信息.
描述
DROP SEQUENCE从数据库中删除序列号生成器. 因为目前的序列实现是作为一个特殊的表,所以此语句就象 DROP TABLE 语句一样.
注意
DROP SEQUENCE语句是 Postgres 语言扩展.
请参考 CREATE SEQUENCE 语句获取如何创建一个序列的信息.
用法
从数据库中删除序列 serial:
DROP SEQUENCE serial;
兼容性 SQL92
在里没有 DROP SEQUENCE.
--------------------------------------------------------------------------------
DROP TABLE
DROP TABLE
Name
DROP TABLE -- 删除一个表
Synopsis
DROP TABLE name [, ...]
输入
name
要删除的现存表或视图.
输出
DROP
如果命令成功完成,返回此信息.
ERROR: table "name" does not exist
果声明的表或视图在数据库中不存在.
描述
DROP TABLE从数据库中删除表或视图. 只有其所有者才能删除一个表或视图. 使用 DELETE 一个表可能没有任何行,但不会被删除.
如果被删除的表有从索引,它们将首先被删除. 从索引的删除将对所属表的内容没有任何影响.
注意
请参考 CREATE TABLE 和 ALTER TABLE 获取如何创建或更改表的信息.
用法
删除 films 和 distributors表:
DROP TABLE films, distributors;
兼容性 SQL92
为 DROP TABLE 声明了一些附加的功能:
DROP TABLE table { RESTRICT | CASCADE }
RESTRICT
确保只有不存在相关视图或完整性约束的表才可以被删除.
CASCADE
任何引用的视图或完整性约束都将被删除.
小技巧: 目前,要删除一个视图,你必须明确删除之.
--------------------------------------------------------------------------------
DROP TRIGGER
DROP TRIGGER
Name
DROP TRIGGER -- 删除一个触发器定义.
Synopsis
DROP TRIGGER name ON table
输入
name
现存的触发器名.
table
表的名称.
输出
DROP
如果触发器成功的删除,返回此信息.
ERROR: DropTrigger: there is no trigger name on relation "table"
如果声明的触发器不存在,返回此信息.
描述
DROP TRIGGER将删除所有对一个现存触发器的引用. 要执行这个命令,当前用户必须是触发器的所有者.
注意
DROP TRIGGER是 PostgreSQL 语言的扩展.
请参考 CREATE TRIGGER 获取如何创建触发器的信息.
用法
删除表films的if_dist_exists触发器:
DROP TRIGGER if_dist_exists ON films;
兼容性 SQL92
在里没有DROP TRIGGER.
--------------------------------------------------------------------------------
DROP TYPE
DROP TYPE
Name
DROP TYPE -- 删除一个用户定义数据类型
Synopsis
DROP TYPE typename [, ...]
输入
typename
现存的类型名.
输出
DROP
命令执行成功的返回信息.
ERROR: RemoveType: type 'typename' does not exist
如果声明的类型没有找到,返回此信息.
描述
DROP TYPE将从系统表里删除用户的类型.
只有类型所有者可以删除类型.
注意
DROP TYPE 语句是 PostgreSQL 语言的扩展.
请参考 CREATE TYPE 获取如何创建类型的信息.
用户有责任删除任何使用了被删除类型的操作符,函数,聚集,访问模式, 子类型和表.不过,相关等数组数据类型(由 CREATE TYPE 自动创建)将自动删除.
如果删除了一个内建的类型,后端的行为将不可预测.
用法
删除 box 类型:
DROP TYPE box;
兼容性 SQL92
SQL3
DROP TYPE是 SQL3 语句.
--------------------------------------------------------------------------------
DROP USER
DROP USER
Name
DROP USER -- 删除一个数据库用户帐号
Synopsis
DROP USER name
输入
name
一个现存用户的名称.
输出
DROP USER
用户被成功删除的返回信息.
ERROR: DROP USER: user "name" does not exist
如果用户名没有找到,返回此信息.
DROP USER: user "name" owns database "name", cannot be removed
你必须先删除数据库或者改变其所有者。
描述
DROP USER从数据库中删除指定的用户。 它不删除数据库里此用户所有的表,视图或其他对象。 如果该用户拥有任何数据库,你会收到一个错误信息。
使用 CREATE USER增加新用户,用 ALTER USER修改用户属性。 PostgreSQL 还有一个脚本 dropuser,这个脚本和这条命令功能相同(实际上,脚本里调用此命令),但是可以在命令行上运行。
用法
删除一个用户帐户:
DROP USER jonathan;
兼容性 SQL92
在里没有DROP USER.
--------------------------------------------------------------------------------
DROP VIEW
DROP VIEW
Name
DROP VIEW -- 删除一个视图
Synopsis
DROP VIEW name [, ...] 输入
name
现存视图名称.
输出
DROP
命令成功执行的返回.
ERROR: view name does not exist
如果声明的视图在数据库中不存在,返回此信息.
描述
DROP VIEW从数据库中删除一个现存的视图. 执行这条命令必须是视图的所有者.
注意
请参考CREATE VIEW 获取关于如何创建视图的信息.
用法
下面命令将删除视图 kinds:
DROP VIEW kinds; 兼容性 SQL92
为 DROP VIEW 声明了一些附加的功能:
DROP VIEW view { RESTRICT | CASCADE } 输入
RESTRICT
确保只有不存在关联视图或完整性约束的视图可以被删除.
CASCADE
任何引用的视图和完整性约束都将被删除.
注意
目前,要从 PostgreSQL 数据库中删除一个视图, 你必须明确地将其删除.
--------------------------------------------------------------------------------
END
Name
END -- 提交当前的事务
Synopsis
END [ WORK | TRANSACTION ]
输入
WORK
TRANSACTION
可选关键字。没有作用。
输出
COMMIT
事务成功提交后的返回信息。
NOTICE: COMMIT: no transaction in progress
如果没有正在处理的事务,返回此信息。
描述
END是 PostgreSQL 而 -兼容的同义语句是 COMMIT.
注意
关键字 WORK 和 TRANSACTION 是多余的,可以省略。
使用 ROLLBACK退出一个事务。
用法
令所有改变生效:
END WORK;
兼容性 SQL92
END是 PostgreSQL 的扩展,提供与 COMMIT相同的功能。
--------------------------------------------------------------------------------
EXPLAIN
EXPLAIN
Name
EXPLAIN -- 显示语句执行规划
Synopsis
EXPLAIN [ VERBOSE ] query
输入
VERBOSE
显示详细查询规划的标志.
query
任何 query (查询).
输出
NOTICE: QUERY PLAN: plan
PostgreSQL 后端明确的查询规划.
EXPLAIN
查询规划显示后发送的标志.
描述
这条命令显示PostgreSQL规划器为所提供的查询生成的执行规划。执行规划显示查询引用的表是如何被扫描的--- 是简单的顺序扫描,还是 索引扫描等 --- 并且如果引用了多个表, 采用了什么样的连接算法从每个输入的表中取出所需要的记录。
显示出来的最关键的部分是预计的查询执行开销,这就是规划器对运行该查询所需时间的估计(以磁盘页面存取为单位计量)。实际上显示了两个数字:返回第一条记录前的启动时间,和返回所有记录的总时间。对于大多数查询而言,关心的是总时间,但是, 在某些环境下,比如一个 EXISTS 子查询里,规划器将选择最小启动时间而不是最小总时间 (因为执行器在获取一条记录后总是要停下来)。同样, 如果你用一条 LIMIT 子句限制返回的记录数,规划器会在最终的开销上做一个合理的插值以计算哪个规划开销最省。
VERBOSE 选项输出规划树在系统内部的完整内容, 而不仅仅是一个概要(并且还把它发送给 postmaster 日志文件)。 通常这个选项只是对调试PostgreSQL有用。
注意
在 PostgreSQL 中只有很少的关于使用优化器的开销的文档.通常的关于查询优化的开销的估算可以在数据库的手册中找到. 请参考 程序员手册 中关于索引和基因查询优化器的章节获取更多信息.
用法
显示一个对只有一个 int4 列和 128 行的表的简单查询的查询规划:
EXPLAIN SELECT * FROM foo;
NOTICE: QUERY PLAN:
Seq Scan on foo (cost=0.00..2.28 rows=128 width=4)
EXPLAIN
对同一个拥有支持查询 equijoin 条件的索引的表, EXPLAIN 将显示一个不同的规划:
EXPLAIN SELECT * FROM foo WHERE i = 4;
NOTICE: QUERY PLAN:
Index Scan using fi on foo (cost=0.00..0.42 rows=1 width=4)
EXPLAIN
最后,同一个拥有支持查询 equijoin 条件的索引的表, EXPLAIN对使用一个聚集函数的查询将显示下面内容:
EXPLAIN SELECT sum(i) FROM foo WHERE i = 4;
NOTICE: QUERY PLAN:
Aggregate (cost=0.42..0.42 rows=1 width=4)
-> Index Scan using fi on foo (cost=0.00..0.42 rows=1 width=4)
注意这里显示的数字, 甚至还有选择的查询策略都有可能在各个 PostgreSQL版本之间不同--因为规划器在不断改进。
兼容性 SQL92
在 中没有EXPLAIN 语句.
--------------------------------------------------------------------------------
FETCH
Name
FETCH -- 用游标从表中抓取行
Synopsis
FETCH [ direction ] [ count ] { IN | FROM } cursor
FETCH [ FORWARD | BACKWARD | RELATIVE ] [ # | ALL | NEXT | PRIOR ] { IN | FROM } cursor
输入
direction
selector定义抓取的方向.它可以是下述之一:
FORWARD
抓取后面的行. selector 省略时这是缺省值.
BACKWARD
抓取前面行.
RELATIVE
为 兼容设置的多余键字.
count
count决定抓取几行.可以是下列之一:
#
一个表明抓取几行的整数. 注意负整数等效于改变 FORWARD 和 BACKWARD 属性.
ALL
检索所有剩余的行.
NEXT
等效于声明 count 为 1.
PRIOR
等效于声明 count 为 -1.
cursor
一个打开的游标的名称.
输出
FETCH返回由声明游标定义的查询结果. 如果查询失败,将返回下面的信息:
NOTICE: PerformPortalFetch: portal "cursor" not found
如果 cursor 在前面没有定义,返回此信息.游标必须在一个事务块中定义.
NOTICE: FETCH/ABSOLUTE not supported, using RELATIVE
PostgreSQL 不支持游标的绝对定位.
ERROR: FETCH/RELATIVE at current position is not supported
允许我们用下面语句在"当前位置"不停地检索游标
FETCH RELATIVE 0 FROM cursor.
PostgreSQL 目前不支持这种用法;实际上,零被保留用于检索所有行, 等效于声明 ALL 关键字.如果使用 RELATIVE 关键字, PostgreSQL 假设用户试图使用 的特性,因而返回此错误.
描述
FETCH允许用户使用游标检索行.所要检索的行数用 # 声明.如果游标中剩下的行小于 #, 那么只有那些可用的抓过来.用关键字 ALL代替数字将导致游标中所有剩余行被抓过来. 记录可以 FORWARD (向前)抓,也可以 BACKWARD (向后)抓.缺省的方向是FORWARD (向前).
注意: 可以用负数作为行记数, 符号等效于颠倒抓取方向关键字(FORWARD 和 BACKWARD).例如, FORWARD -1 等效于 BACKWARD 1.
注意
注意 FORWARD 和 BACKWARD 关键字是 PostgreSQL 扩展. 语法也支持,在此命令的第二种形式中声明. 详细的兼容性 SQL92 信息见下面.
在游标中更新数据还不被 PostgreSQL, 支持,因为将游标更新影射回基本表是不太可能的,这一点对 VIEW 更新也一样.因而用户必须显式的使用 UPDATE 命令来更新数据.
游标只能用于事务内部,因为它们存储的数据跨越了多个用户的查询.
使用 MOVE语句改变游标位置.使用 DECLARE语句定义一个游标.使用 BEGIN, COMMIT, 和 ROLLBACK语句获取更多关于事务的信息.
用法
下面的例子用一个游标跨过一个表。
-- 建立一个游标:
BEGIN WORK;
DECLARE liahona CURSOR FOR SELECT * FROM films;
-- 抓取头 5 行到游标 liahona 里:
FETCH FORWARD 5 IN liahona;
code | title | did | date_prod | kind | len
-------+-------------------------+-----+------------+----------+-------
BL101 | The Third Man | 101 | 1949-12-23 | Drama | 01:44
BL102 | The African Queen | 101 | 1951-08-11 | Romantic | 01:43
JL201 | Une Femme est une Femme | 102 | 1961-03-12 | Romantic | 01:25
P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08
P_302 | Becket | 103 | 1964-02-03 | Drama | 02:28
-- 抓取前面行:
FETCH BACKWARD 1 IN liahona;
code | title | did | date_prod | kind | len
-------+---------+-----+------------+--------+-------
P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08
-- 关闭游标并提交事务:
CLOSE liahona;
COMMIT WORK;
兼容性 SQL92
注意: 非嵌入式游标的使用是 PostgreSQL 扩展.游标的语法和用途与定义与 里定义的嵌入式用法相似。
允许游标在 FETCH 中的绝对定位, 并且允许将结果放在明确的变量里:
FETCH ABSOLUTE #
FROM cursor
INTO :variable [, ...]
ABSOLUTE
游标将放置在写明的绝对的行数的位置上.在 PostgreSQL 中所有的行数都是相对数量,所以这一功能不支持.
:variable
目标宿主变量.
--------------------------------------------------------------------------------
GRANT
Name
GRANT -- 定义访问权限
Synopsis
GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER } [,...] | ALL [ PRIVILEGES ] }
ON [ TABLE ] objectname [, ...] TO { username | GROUP groupname | PUBLIC } [, ...]
描述
GRANT命令将某对象(表,视图,序列) 上的特定权限给予一个用户或者多个用户或者一组用户.这些权限将增加到那些已经赋予的权限上,如果存在这些权限的话.
键字 PUBLIC 表示该权限要赋予所有用户, 包括那些以后可能创建的用户.PUBLIC可以看做是一个隐含定义好的组,它总是包括所有用户.请注意,任何特定的用户都将拥有直接赋予他/她的权限,加上 他/她所处的任何组,以及再加上赋予PUBLIC 的权限的总和.
在创建完对象之后,除了对象的创建者之外, 其它用户没有任何访问该对象的权限,除非创建者赋予某些权限.对对象的创建者而言,没有什么权限需要赋予,因为创建者自动持有所有权限.(不过,创建者出于安全考虑可以选择废弃一些他自己的权限.请注意赋予和废止权限的能力是创建者与生具来的,并且不会丢失.删除对象的权利也是创建者固有的,并且不能赋予或 撤销.)
可能的权限有∶
SELECT
允许对声明的表,试图,或者序列 SELECT 仁义字段.还允许做 COPY 的源.
INSERT
允许向声明的表 INSERT 一个新行. 同时还允许做 COPY 的目标.
UPDATE
允许对声明的表中任意字段做 UPDATE . SELECT ... FOR UPDATE 也要求这个权限 (除了 SELECT 权限之外).比如, 这个权限允许使用nextval, currval 和 setval.
DELETE
允许从声明的表中 DELETE 行.
RULE
允许在该表/视图上创建规则.(参阅 CREATE RULE 语句.)
REFERENCES
要在一个表上创建一个外键约束,你必须在带参考健字的表上 拥有这个权限.
TRIGGER
允许在声明表上创建触发器.(参阅 CREATE TRIGGER 语句.)
ALL PRIVILEGES
把上面所有权限都一次赋予.PRIVILEGES 关键字在 PostgreSQL 里是可选的, 但是严格的 SQL 要求有这个关键字.
其它命令要求的权限都在相应的命令的参考页上列出.
注意
我们要注意数据库 superusers 可以访问所有对象, 而不会受对象的权限设置影响.这个特点类似 Unix 系统的 root 的权限.和 root 一样,除了必要的情况,总是以超级用户 身分进行操作是不明智的做法.
目前,要在 PostgreSQL 里只对某几列 赋予权限,你必须创建一个拥有那几行的视图然后给那个视图赋予权限.
使用 psql的 z 命令 获取在现有对象上的与权限有关的信息.
Database = lusitania
+------------------+---------------------------------------------+
| Relation | Grant/Revoke Permissions |
+------------------+---------------------------------------------+
| mytable | {"=rw","miriam=arwdRxt","group todos=rw"} |
+------------------+---------------------------------------------+
Legend:
uname=arwR -- privileges granted to a user
group gname=arwR -- privileges granted to a group
=arwR -- privileges granted to PUBLIC
r -- SELECT ("read")
w -- UPDATE ("write")
a -- INSERT ("append")
d -- DELETE
R -- RULE
x -- REFERENCES
t -- TRIGGER
arwdRxt -- ALL PRIVILEGES
用 REVOKE 命令删除访问权限.
例子
把表 films 的插入权限赋予所有用户∶
GRANT INSERT ON films TO PUBLIC;
赋予用户manuel对视图kinds的所有权限∶
GRANT ALL PRIVILEGES ON kinds TO manuel;
兼容性 SQL92
在 ALL PRIVILEGES 里的 PRIVILEGES 关键字是必须的.SQL 不支持在一条命令里 对多个表设置权限.
的 GRANT 语法允许在一个表里 为独立的字段设置权限,并且允许设置一个权限用来给其它人赋予同样的权限∶
GRANT privilege [, ...]
ON object [ ( column [, ...] ) ] [, ...]
TO { PUBLIC | username [, ...]
} [ WITH GRANT OPTION ]
SQL 允许对其它类型的对象赋予 USAGE 权限∶CHARACTER SET,COLLATION,TRANSLATION,DOMAIN.
TRIGGER 权限是 SQL99 引入的.RULE 权限是 PostgreSQL 扩展.
又见
REVOKE
--------------------------------------------------------------------------------
INSERT
Name
INSERT -- 在表中创建新行
Synopsis
INSERT INTO table [ ( column [, ...] ) ]
{ DEFAULT VALUES | VALUES ( expression [, ...] ) | SELECT query }
输入
table
现存表的名称.
column
表 table 中的列/字段名.
DEFAULT VALUES
所有字段都会用NULL或者创建表时用DEFAULT子句声明的值填充.
expression
赋予 column 的一个有效表达式或值.
query
一个有效的查询.请参考 SELECT 语句获取有效参数的进一步描述.
输出
INSERT oid 1
如果只插入了一行,返回此信息. oid OID 是被插入行的数字标识.
INSERT 0 #
如果插入了超过一行,返回此信息. # 是插入的行数.
描述
INSERT允许我们向表中插入新行. 我们可以一次插入一行或多行作为查询结果. 目标列表中的列/字段可以按任何顺序排列.
在目标列中没有出现的列/字段将插入缺省值, 要么是定义了的 DEFAULT 值或者 NULL。 如果向定义为 NOT NULL 的列中插入 NULL 值, PostgreSQL 将拒绝新列。
如果每行的表达式不是正确的数据类型,将试图进行自动的类型转换.
要想向表中插入数据,你必须有插入权限, 同样也要有选择权限用于处理 WHERE 子句里声明的任何表。
用法
向表 films 里插入一行:
INSERT INTO films VALUES
('UA502','Bananas',105,'1971-07-13','Comedy',INTERVAL '82 minute');
在第二个例子里面省略了字段 len 因此在它里面将只存储缺省的 NULL 值:
INSERT INTO films (code, title, did, date_prod, kind)
VALUES ('T_601', 'Yojimbo', 106, DATE '1961-06-16', 'Drama');
向表 distributors 里插入一行;注意只声明了字段 name ,而没有声明的字段 did 将被赋于它的缺省值:
INSERT INTO distributors (name) VALUES ('British Lion');
从表 tmp 中插入几行到表 films 中:
INSERT INTO films SELECT * FROM tmp;
插入数组(请参考 PostgreSQL 用户手册 获取关于数组的更多信息):
-- 创建一个空的 3x3 游戏板来玩圈-和-叉游戏
-- (所有这些查询创建相同的板属性)
INSERT INTO tictactoe (game, board[1:3][1:3])
VALUES (1,'{{"","",""},{},{"",""}}');
INSERT INTO tictactoe (game, board[3][3])
VALUES (2,'{}');
INSERT INTO tictactoe (game, board)
VALUES (3,'{{,,},{,,},{,,}}');
兼容性 SQL92
INSERT语句与 完全兼容. 可能碰到的关于 query 子句特性的限制在 SELECT语句中有相关文档.