PostgreSQL7.0手册-用户手册-19. SQL命令-INSERT
名称
INSERT — 向表中插入新行
语法
INSERT INTO table [ ( column [, ...] ) ]
{ VALUES ( expression [, ...] ) SELECT query }
输入
table
现存表的名称.
column
表 table 中的列/字段名.
expression
赋予 column 的一个有效表达式或值.
query
一个有效的查询.请参考 SELECT 语句获取有效参数的进一步描述.
输出
INSERT oid 1
如果只插入了一行,返回此信息.oid是被插入行的数字标识.
INSERT 0 #
如果插入了超过一行,返回此信息.# 是插入的行数.
描述
INSERT 允许我们向表中插入新行.我们可以一次插入一行或多行作为查询结果.目标列表中的列/字段可以按任何顺序排列.
在目标列中没有出现的列/字段将插入缺省值,要么是定义了的 DEFAULT 值或者 NULL。如果向定义为 NOT NULL 的列中插入 NULL 值,Postgres 将拒绝新列。
如果每行的表达式不是正确的数据类型,将试图进行自动的类型转换.
要想向表中插入数据,你必须有插入权限,同样也要有选择权限用于处理 WHERE 子句里声明的任何表。
用法
向表 films 里插入一行:
INSERT INTO films VALUES
('UA502','Bananas',105,'1971-07-13','Comedy',INTERVAL '82 minute');
在第二个例子里面省略了字段 date_prod (译注:原文错,应为字段 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 语句与 SQL92 完全兼容.可能碰到的关于 query 子句特性的限制在 SELECT 语句中有相关文档.