# CREATE TABLE
## Name
CREATE TABLE -- 定义一个新表
## Synopsis
```
CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] _table_name_ ( [
{ _column_name_ _data_type_ [ COLLATE _collation_ ] [ _column_constraint_ [ ... ] ]
| _table_constraint_
| LIKE _source_table_ [ _like_option_ ... ] }
[, ... ]
] )
[ INHERITS ( _parent_table_ [, ... ] ) ]
[ WITH ( _storage_parameter_ [= _value_] [, ... ] ) | WITH OIDS | WITHOUT OIDS ]
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
[ TABLESPACE _tablespace_name_ ]
CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] _table_name_
OF _type_name_ [ (
{ _column_name_ WITH OPTIONS [ _column_constraint_ [ ... ] ]
| _table_constraint_ }
[, ... ]
) ]
[ WITH ( _storage_parameter_ [= _value_] [, ... ] ) | WITH OIDS | WITHOUT OIDS ]
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
[ TABLESPACE _tablespace_name_ ]
这里的`_column_constraint_`是:
[ CONSTRAINT _constraint_name_ ]
{ NOT NULL |
NULL |
CHECK ( _expression_ ) [ NO INHERIT ] |
DEFAULT _default_expr_ |
UNIQUE _index_parameters_ |
PRIMARY KEY _index_parameters_ |
REFERENCES _reftable_ [ ( _refcolumn_ ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ]
[ ON DELETE _action_ ] [ ON UPDATE _action_ ] }
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
而`_table_constraint_`是:
[ CONSTRAINT _constraint_name_ ]
{ CHECK ( _expression_ ) [ NO INHERIT ] |
UNIQUE ( _column_name_ [, ... ] ) _index_parameters_ |
PRIMARY KEY ( _column_name_ [, ... ] ) _index_parameters_ |
EXCLUDE [ USING _index_method_ ] ( _exclude_element_ WITH _operator_ [, ... ] ) _index_parameters_ [ WHERE ( _predicate_ ) ] |
FOREIGN KEY ( _column_name_ [, ... ] ) REFERENCES _reftable_ [ ( _refcolumn_ [, ... ] ) ]
[ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE _action_ ] [ ON UPDATE _action_ ] }
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
`_like_option_`是:
{ INCLUDING | EXCLUDING } { DEFAULTS | CONSTRAINTS | INDEXES | STORAGE | COMMENTS | ALL }
在`UNIQUE`、`PRIMARY KEY`和
`EXCLUDE`约束中的`_index_parameters_`是:
[ WITH ( _storage_parameter_ [= _value_] [, ... ] ) ]
[ USING INDEX TABLESPACE _tablespace_name_ ]
`_exclude_element_` in an `EXCLUDE` constraint is:
{ _column_name_ | ( _expression_ ) } [ _opclass_ ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ]
```
## 描述
`CREATE TABLE`在当前数据库创建一个新的空白表。 该表将由发出此命令的用户所拥有。
如果给出了模式名(比如`CREATE TABLE myschema.mytable ...`), 那么在指定的模式中创建表,否则在当前模式中创建。临时表存在于一个特殊的模式里, 因此创建临时表的时候不能指定模式名。表名字必需在同一模式中的其它表、 序列、索引、视图或外部表名字中唯一。
`CREATE TABLE`还自动创建一个与该表的行对应的复合数据类型。 因此,表不能和同模式中的现有数据类型同名。
可选的约束子句声明约束,新行或者更新的行必须满足这些约束才能成功插入或更新。 约束是一个 SQL 对象,它以多种方式协助在表上定义有效数值的集合。
定义约束有两种方法:表约束和列约束。列约束是作为一个列定义的一部分定义的。 而表约束并不和某个列绑在一起,它可以作用于多个列上。每个列约束也可以写成表约束; 如果某个约束只影响一个列,那么列约束只是符号上的简洁方式而已。
要能创建一个表,你必须分别在所有列类型或`OF` 子句的类型上有`USAGE`权限。
## 参数
`TEMPORARY` 或 `TEMP`
如果声明了,则创建为临时表。临时表在会话结束或(可选)当前事务的结尾 (参阅下面的`ON COMMIT`)自动删除。除非用模式修饰的名字引用, 否则现有的同名永久表在临时表存在期间,在本会话过程中是不可见的。 任何在临时表上创建的索引也都会被自动删除。
[自动清理进程](#calibre_link-77)不能访问,因此不能清理或分析临时表。 由于这个原因,适当的清理和分析操作应该通过会话SQL命令来执行。例如, 如果一个临时表用于复杂查询中,那么在填充临时表之后在临时表上运行 `ANALYZE`是明智的。
可以选择在`TEMPORARY`或`TEMP`前面放上`GLOBAL` 或`LOCAL`。不过这目前对PostgreSQL来说没有任何区别, 并且已经废弃了;可以参阅[_兼容性_](#calibre_link-78)。
`UNLOGGED`
如果指定了,则表作为非日志表来创建。写入到非日志表中的数据并不写入预写式日志 (参阅[Chapter 29](#calibre_link-79)),这使得他们比普通表快的多。不过, 他们不是崩溃安全的:一个非日志表在崩溃或不清理关机之后被自动截断。 非日志表的内容也不复制到备用服务器。任何在非日志表上创建的索引也自动是非日志的。
`IF NOT EXISTS`
如果同名的关系已经存在,那么不要抛出一个错误。在这种情况下发出一个通知。 请注意,不保证已经存在的关系和要创建的关系相像。
`_table_name_`
要创建的表的名字(可以用模式修饰)
`OF` `_type_name_`
创建一个_类型化的表_,它的结构来自指定的复合类型 (名字可以有模式修饰)。一个类型化的表绑定到它的类型; 例如,如果类型被删除(使用`DROP TYPE ... CASCADE`), 则该表也将被删除。
当类型化的表被创建时,字段的数据类型取决于底层复合类型, 而不是通过`CREATE TABLE`命令指定。 但是`CREATE TABLE`命令可以给表添加缺省和约束, 并且可以指定存储参数。
`_column_name_`
在新表中要创建的字段名字。
`_data_type_`
该字段的数据类型。它可以包括数组说明符。有关PostgreSQL 支持的数据类型的更多信息,请参考[Chapter 8](#calibre_link-5)。
`COLLATE` `_collation_`
`COLLATE`给字段(必须是可排序的数据类型)分配一个排序规则。 如果没有指定,则使用字段数据类型的缺省排序。
`INHERITS (` `_parent_table_` [, ... ] )
可选的`INHERITS`子句声明一系列的表,新表自动从这一系列表中继承所有字段。
使用`INHERITS`将在新的子表和其父表之间创建一个永久的关系。 对父表结构的修改通常也会传播到子表。缺省时,扫描父表的时候也会扫描子表。
如果在多个父表中存在同名字段,那么就会报告一个错误, 除非这些字段的数据类型在每个父表里都是匹配的。如果没有冲突, 那么重复的字段在新表中融合成一个字段。如果列出的新表字段名和继承字段同名, 那么它的数据类型也必须和继承字段匹配,并且这些字段定义会融合成一个。 如果新表为该字段明确声明了缺省值,那么此缺省值将覆盖任何继承字段的缺省值。 否则,该字段的所有父字段缺省值都必须相同,否则就会报错。
`CHECK`约束本质上以和字段一样的方式合并:如果多个父表和/或新表的定义包含相同名字的 `CHECK`约束,那么这些约束必须都有相同的检查表达式,否则会报告一个错误。 有相同名字和表达式的约束将合并到一个。在父表中标记为`NO INHERIT` 的约束将不被考虑。请注意,新表中未命名的`CHECK`约束将永远不被合并, 因为它将永远都有一个唯一的名字。
字段`STORAGE`设置也从父表中拷贝。
`LIKE` `_source_table_` [ `_like_option_` ... ]
`LIKE`子句声明一个表, 新表自动从这个表里面继承所有字段名及其数据类型和非空约束。
和`INHERITS`不同,新表与原来的表之间在创建动作完毕之后是完全无关的。 在源表做的任何修改都不会传播到新表中,并且也不可能在扫描源表的时候包含新表的数据。
字段缺省表达式只有在声明了`INCLUDING DEFAULTS`之后才会包含进来。 缺省是不包含缺省表达式的,结果是新表中所有字段的缺省值都是 NULL 。
非空约束将总是复制到新表中,`CHECK`约束则仅在指定了 `INCLUDING CONSTRAINTS`的时候才复制。源表上的索引、 `PRIMARY KEY`和`UNIQUE`约束仅在指定了 `INCLUDING INDEXES`子句的时候才在新表上创建。 此规则同时适用于表约束和列约束。
拷贝字段定义的`STORAGE`设置只在声明了`INCLUDING STORAGE` 的时候才拷贝。缺省是不包括`STORAGE`设置的, 结果是新表中的拷贝字段有特定类型的缺省设置。关于`STORAGE` 设置的更多信息,请参阅[Section 58.2](#calibre_link-80)。
拷贝字段、约束和索引的注释只在声明了`INCLUDING COMMENTS` 的时候拷贝。缺省是不包含注释的,结果是新表中拷贝的字段和约束没有注释。
`INCLUDING ALL`是`INCLUDING DEFAULTS INCLUDING CONSTRAINTS INCLUDING INDEXES INCLUDING STORAGE INCLUDING COMMENTS` 的一个简写形式。
请注意,和`INHERITS`不同,通过`LIKE` 拷贝的列和约束并不使用相同的名字进行融合。 如果明确的指定了相同的名字或者在另外一个`LIKE`子句中,那么将会报错。
`LIKE`子句也可以用来从视图、外表或复合类型中拷贝字段。 不适用的选项(如,从一个视图中`INCLUDING INDEXES`)都被忽略。
`CONSTRAINT` `_constraint_name_`
可选的列约束或表约束的名字。如果约束本身是非法的,那么其名字将会出现在错误信息中, 因此像`col must be positive`这样的名字可以表达有用的约束信息。 如果约束名中含有空格则必须用双引号界定。如果没有指定约束名,那么系统将会自动生成一个名字。
`NOT NULL`
字段不允许包含 NULL 值
`NULL`
字段允许包含 NULL 值,这是缺省。
这个子句的存在只是为和那些非标准 SQL 数据库兼容。不建议在新应用中使用它。
`CHECK (` `_expression_` ) [ NO INHERIT ]
`CHECK`约束声明一个生成布尔结果的表达式, 每次将要插入的新行或者将要被更新的行必须使表达式结果为真或未知才能成功, 否则会抛出一个异常并且不会修改数据库。 声明为字段约束的检查约束应该只引用该字段的数值, 而在表约束里出现的表达式可以引用多个字段。
目前,`CHECK`表达式不能包含子查询也不能引用除当前行字段之外的变量。
用`NO INHERIT`标记的约束将不会传递到子表中去。
`DEFAULT` `_default_expr_`
`DEFAULT`子句给字段指定缺省值。该数值可以是任何不含变量的表达式 (不允许使用子查询和对本表中的其它字段的交叉引用)。 缺省表达式的数据类型必须和字段类型匹配。
缺省表达式将被用于任何未声明该字段数值的插入操作。 如果没有指定缺省值则缺省值为 NULL 。
`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`的组合,不过把一套字段标识为主键同时也体现了模式设计的元数据, 因为主键意味着可以拿这套字段用做行的唯一标识。
一个表只能声明一个主键,不管是作为字段约束还是表约束。
主键约束使用的字段集合应该与其它唯一约束都不同。
`EXCLUDE [ USING` `_index_method_` ] ( `_exclude_element_` WITH `_operator_` [, ... ] ) `_index_parameters_` [ WHERE ( `_predicate_` ) ]
`EXCLUDE`子句定义一个排除约束,保证了两个行在指定的字段或使用指定操作符的表达式上比较时, 并不都返回`TRUE`。如果所有指定的操作符测试都相等, 那么就等同于`UNIQUE`约束,尽管一个普通的唯一约束会更快速。 不过,排除约束可以指定比简单相等更普通的约束。例如, 你可以通过使用`&&`操作符指定一个约束, 在一个表中没有两个行包含重叠的圆圈(参阅[Section 8.8](#calibre_link-81))。
排除约束是使用索引实现的,所以每个指定的操作符都必须和索引访问方法的一个合适的操作符类 (参阅[Section 11.9](#calibre_link-82))相关。要求操作符是可交换的。 每个`_exclude_element_` 可以指定一个操作符类和/或排序选项;这些在[CREATE INDEX](#calibre_link-83)中有充分的描述。
访问方法必须支持`amgettuple` (参阅[Chapter 54](#calibre_link-84)); 目前,这意味着不能使用GIN。尽管允许使用, 但是在排除约束中使用B-tree或哈希索引没什么意义, 因为一个普通唯一约束做的更好。所以实际中,访问方法总是GiST 或SP-GiST。
`_predicate_`允许在表的子集上声明一个排除约束; 在内部这创建了一个部分索引。请注意,谓语需要有括号包围。
`REFERENCES` `_reftable_` [ ( `_refcolumn_` ) ] [ MATCH `_matchtype_` ] [ ON DELETE `_action_` ] [ ON UPDATE `_action_` ] (column constraint)
`FOREIGN KEY (` `_column_name_` [, ... ] ) REFERENCES `_reftable_` [ ( `_refcolumn_` [, ... ] ) ] [ MATCH `_matchtype_` ] [ ON DELETE `_action_` ] [ ON UPDATE `_action_` ] (table constraint)
这些子句声明一个外键约束,外键约束要求新表中一列或多列组成的组应该只包含 匹配被参考的表中对应字段中的值。如果省略`_refcolumn_`,则使用 `_reftable_`的主键。 被参考字段必须是被参考表中的唯一字段或者主键。请注意, 不能在临时表和永久表之间定义外键约束。
向参考字段插入的数值将使用给出的匹配类型与被参考表中被参考列的数值进行匹配。 有三种匹配类型:`MATCH FULL`, `MATCH PARTIAL`, `MATCH SIMPLE`(缺省)。`MATCH FULL` 不允许一个多字段外键的字段为 NULL ,除非所有外键字段都为 NULL; 如果都是NULL,那么该行在引用的表中不需要有匹配。`MATCH SIMPLE` 允许任意外键字段为 NULL;如果都是NULL,那么该行在引用的表中不需要有匹配。 `MATCH PARTIAL`目前尚未实现。(当然,`NOT NULL` 约束可以应用于引用字段,以阻止这些情况的发生。)
另外,当被参考字段中的数据改变的时候,那么将对本表的字段中的数据执行某种操作。 `ON DELETE`子句声明当被参考表中的被参考行被删除的时候要执行的操作。 类似的,`ON UPDATE`子句声明被参考表中被参考字段更新为新值的时候要执行的动作。 如果该行被更新,但被参考的字段实际上没有变化,那么就不会有任何动作。 除了`NO ACTION`检查之外的其他参考动作都不能推迟, 即使该约束声明为可推迟也是如此。下面是每个子句的可能动作:
`NO ACTION`
生成一个错误,表明删除或更新将产生一个违反外键约束的动作。 如果该约束是可推迟的,并且如果还存在任何引用行,那么这个错误将在检查约束的时候生成。 这是缺省动作。
`RESTRICT`
生成一个表明删除或更新将导致违反外键约束的错误。 和`NO ACTION`一样,只是动作不可推迟。
`CASCADE`
删除任何引用了被删除行的行,或者分别把引用行的字段值更新为被参考字段的新数值。
`SET NULL`
把引用行设置为 NULL 。
`SET DEFAULT`
把引用字段设置为它们的缺省值。(如果他们为非空,那么被引用的表中必须有一行匹配缺省值, 否则该操作将会失败。)
如果被参考字段经常更新,那么给引用字段增加一个索引可能是合适的, 这样与外键约束相关联的引用动作可以更有效地执行。
`DEFERRABLE`
`NOT DEFERRABLE`
这两个关键字设置该约束是否可推迟。一个不可推迟的约束将在每条命令之后马上检查。 可推迟约束可以推迟到事务结尾使用[SET CONSTRAINTS](#calibre_link-85)命令检查。 缺省是`NOT DEFERRABLE`。目前,只有`UNIQUE`、 `PRIMARY KEY`、`EXCLUDE`和`REFERENCES`(外键) 约束接受这个子句。`NOT NULL`和`CHECK`约束都是不可推迟的。
`INITIALLY IMMEDIATE`
`INITIALLY DEFERRED`
如果约束是可推迟的,那么这个子句声明检查约束的缺省时间。 如果约束是`INITIALLY IMMEDIATE`(缺省), 那么每条语句之后就立即检查它。如果约束是`INITIALLY DEFERRED`, 那么只有在事务结尾才检查它。约束检查的时间可以用 [SET CONSTRAINTS](#calibre_link-85)命令修改。
`WITH (` `_storage_parameter_` [= `_value_`] [, ... ] )
这个子句为表或索引指定一个可选的存储参数,参见[_存储参数_](#calibre_link-86)获取更多信息。 用于表的`WITH`子句还可以包含`OIDS=TRUE`或单独的 `OIDS`来指定给新表中的每一行都分配一个 OID(对象标识符), 或者`OIDS=FALSE`表示不分配 OID 。如果没有指定`OIDS` 默认行为取决于[default_with_oids](#calibre_link-87)配置参数。 如果新表是从有 OID 的表继承而来,那么即使明确指定`OIDS=FALSE` 也将强制按照`OIDS=TRUE`执行。
如果明确或隐含的指定了`OIDS=FALSE`,新表将不会存储 OID , 也不会为插入的行分配 OID 。这将减小 OID 的开销并因此延缓了 32-bit OID 计数器的循环。因为一旦计数器发生循环之后 OID 将不能被视为唯一, 这将大大降低 OID 的实用性。另外, 排除了 OID 的表也为每条记录减小了 4 字节的存储空间(在大多数机器上), 从而可以稍微提升一些性能。
可以使用[ALTER TABLE](#calibre_link-88)从已有的表中删除 OID 列。
`WITH OIDS`
`WITHOUT OIDS`
这些是被废弃的、分别等价于`WITH (OIDS)`和`WITH (OIDS=FALSE)` 的语法。如果想同时给出`OIDS`设置和存储参数,必须使用 `WITH ( ... )`语法;见上文。
`ON COMMIT`
可以使用`ON COMMIT`控制临时表在事务块结尾的行为。 这三个选项是:
`PRESERVE ROWS`
在事务的结尾不采取任何特别的动作,这是缺省。
`DELETE ROWS`
在每个事务块的结尾都删除临时表中的所有行。 本质上是在每次提交事务后自动执行一个[TRUNCATE](#calibre_link-89)命令。
`DROP`
在当前事务块的结尾删除临时表。
`TABLESPACE` `_tablespace_name_`
指定新表将要在`_tablespace_name_` 表空间内创建。如果没有声明,将使用[default_tablespace](#calibre_link-90), 如果该表为临时表,那么将使用[temp_tablespaces](#calibre_link-91)。
`USING INDEX TABLESPACE` `_tablespace_name_`
这个子句允许选择与一个`UNIQUE`、`PRIMARY KEY` 或`EXCLUDE`约束相关的索引创建时所在的表空间。如果没有声明, 将使用[default_tablespace](#calibre_link-90), 如果该表为临时表,那么将使用[temp_tablespaces](#calibre_link-91)。
### 存储参数
`WITH`子句可以为表指定_存储参数_,并在索引上创建 `UNIQUE`、`PRIMARY KEY`或`EXCLUDE` 约束。用于索引的存储参数在[CREATE INDEX](#calibre_link-83)里面描述。 目前可以在表上使用的存储参数在下面列出。对于每个参数,除非指明了, 有一个额外的参数是相同的名字加上`toast.`前缀, 可以用来控制表的次要TOAST表的行为,如果有 (参阅[Section 58.2](#calibre_link-80)获取更多关于TOAST的信息)。 请注意,TOAST表从它的父表中继承`autovacuum_*`值, 如果没有设置`toast.autovacuum_*`设置。
`fillfactor` (`integer`)
一个表的填充因子(fillfactor)是一个介于 10 和 100 之间的百分数。 100(完全填充)是默认值。如果指定了较小的填充因子,`INSERT` 操作仅按照填充因子指定的百分率填充表页。每个页上的剩余空间将用于在该页上更新行, 这就使得`UPDATE`有机会在同一页上放置同一条记录的新版本, 这比把新版本放置在其它页上更有效。对于一个从不更新的表将填充因子设为 100 是最佳选择,但是对于频繁更新的表,较小的填充因子则更加有效。 这个参数不能为TOAST表设置。
`autovacuum_enabled`, `toast.autovacuum_enabled` (`boolean`)
在一个特别的表上启用或禁用自动清理守护进程。如果为真, 当更新或删除的元组的数量超过`autovacuum_vacuum_threshold` 加上`autovacuum_vacuum_scale_factor`倍的当前关系中评估的活动的元组时, 自动清理守护进程将在一个特定的表上发起一个`VACUUM`操作。 相似的,当插入、更新或删除的元组的数量超过`autovacuum_analyze_threshold` 加上`autovacuum_analyze_scale_factor`倍的当前关系中评估的活动的元组时, 自动清理守护进程将发起一个`ANALYZE`操作。如果为假, 这个表将不被自动清理,除了防止事务Id循环。参阅[Section 23.1.5](#calibre_link-92) 获取更多关于预防循环的信息。注意,这个变量从[autovacuum](#calibre_link-93) 设置中继承值。
`autovacuum_vacuum_threshold`, `toast.autovacuum_vacuum_threshold` (`integer`)
在一个特定的表上发起`VACUUM`操作之前,更新或删除的元组的最小值。
`autovacuum_vacuum_scale_factor`, `toast.autovacuum_vacuum_scale_factor` (`float4`)
添加到`autovacuum_vacuum_threshold`的`reltuples`的乘数。
`autovacuum_analyze_threshold` (`integer`)
在一个特定的表上发起`ANALYZE`操作之前,插入、更新或删除的元组的最小值。
`autovacuum_analyze_scale_factor` (`float4`)
添加到`autovacuum_analyze_threshold`的`reltuples`乘数。
`autovacuum_vacuum_cost_delay`, `toast.autovacuum_vacuum_cost_delay` (`integer`)
自定义[autovacuum_vacuum_cost_delay](#calibre_link-94)参数。
`autovacuum_vacuum_cost_limit`, `toast.autovacuum_vacuum_cost_limit` (`integer`)
自定义[autovacuum_vacuum_cost_limit](#calibre_link-95)参数。
`autovacuum_freeze_min_age`, `toast.autovacuum_freeze_min_age` (`integer`)
自定义[autovacuum_vacuum_cost_limit](#calibre_link-95)参数。请注意, 自动清理将忽略设置一个每表`autovacuum_freeze_min_age` 大于半个系统范围的[autovacuum_freeze_max_age](#calibre_link-96)设置的尝试。
`autovacuum_freeze_max_age`, `toast.autovacuum_freeze_max_age` (`integer`)
自定义[autovacuum_freeze_max_age](#calibre_link-96)参数。请注意, 自动清理将忽略设置一个每表`autovacuum_freeze_max_age` 大于系统范围的设置的尝试(它只能设置的较小一些)。注意, 你可以将`autovacuum_freeze_max_age`设置的非常小,甚至为零, 这通常是不明智的,因为它将强制频繁的清理。
`autovacuum_freeze_table_age`, `toast.autovacuum_freeze_table_age` (`integer`)
自定义[vacuum_freeze_table_age](#calibre_link-97)参数。
## 注意
不建议在新应用中使用 OID ,可能情况下,更好的选择是使用一个`SERIAL` 或者其它序列发生器做表的主键。如果一个应用使用了 OID 标识表中的特定行, 那么建议在该表的`oid`字段上创建一个唯一约束, 以确保该表的 OID 即使在计数器循环之后也是唯一的。 如果你需要一个整个数据库范围的唯一标识,那么就要避免假设 OID 是跨表唯一的, 你可以用`tableoid`和行 OID 的组合来实现这个目的。
> **Tip:** 对那些没有主键的表,不建议使用`OIDS=FALSE`, 因为如果既没有 OID 又没有唯一数据字段,那么就很难标识特定的行。
PostgreSQL 自动为每个唯一约束和主键约束创建一个索引以确保其唯一性。因此, 不必为主键字段明确的创建索引。参阅[CREATE INDEX](#calibre_link-83)获取更多信息。
唯一约束和主键在目前的实现里是不能继承的。 如果把继承和唯一约束组合在一起会导致无法运转。
一个表不能超过 1600 个字段。实际的限制比这个更低,因为还有元组长度限制。
## 例子
创建`films`和`distributors`表:
```
CREATE TABLE films (
code char(5) CONSTRAINT firstkey PRIMARY KEY,
title varchar(40) NOT NULL,
did integer NOT NULL,
date_prod date,
kind varchar(10),
len interval hour to minute
);
CREATE TABLE distributors (
did integer PRIMARY KEY DEFAULT nextval('serial'),
name varchar(40) NOT NULL CHECK (name <> '')
);
```
创建一个带有 2 维数组的表:
```
CREATE TABLE array_int (
vector int[][]
);
```
为表`films`定义一个唯一表约束。 唯一表约束可以在表的一个或多个字段上定义:
```
CREATE TABLE films (
code char(5),
title varchar(40),
did integer,
date_prod date,
kind varchar(10),
len interval hour to minute,
CONSTRAINT production UNIQUE(date_prod)
);
```
定义一个检查列约束:
```
CREATE TABLE distributors (
did integer CHECK (did > 100),
name varchar(40)
);
```
定义一个检查表约束:
```
CREATE TABLE distributors (
did integer,
name varchar(40)
CONSTRAINT con1 CHECK (did > 100 AND name <> '')
);
```
为表`films`定义一个主键表约束。
```
CREATE TABLE films (
code char(5),
title varchar(40),
did integer,
date_prod date,
kind varchar(10),
len interval hour to minute,
CONSTRAINT code_title PRIMARY KEY(code,title)
);
```
为表`distributors`定义一个主键约束。下面两个例子是等效的, 第一个例子使用了表约束语法,第二个使用了列约束语法。
```
CREATE TABLE distributors (
did integer,
name varchar(40),
PRIMARY KEY(did)
);
CREATE TABLE distributors (
did integer 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 integer CONSTRAINT no_null NOT NULL,
name varchar(40) NOT NULL
);
```
为`name`字段定义一个唯一约束:
```
CREATE TABLE distributors (
did integer,
name varchar(40) UNIQUE
);
```
相同的,声明为一个表约束:
```
CREATE TABLE distributors (
did integer,
name varchar(40),
UNIQUE(name)
);
```
创建同样的表,并为表以及唯一索引指定 70% 填充率:
```
CREATE TABLE distributors (
did integer,
name varchar(40),
UNIQUE(name) WITH (fillfactor=70)
)
WITH (fillfactor=70);
```
创建一个带有排除约束的表`circles`, 阻止任意两个圆重叠:
```
CREATE TABLE circles (
c circle,
EXCLUDE USING gist (c WITH &&)
);
```
在表空间`diskvol1`里创建`cinemas`表:
```
CREATE TABLE cinemas (
id serial,
name text,
location text
) TABLESPACE diskvol1;
```
创建一个复合类型和类型化的表:
```
CREATE TYPE employee_type AS (name text, salary numeric);
CREATE TABLE employees OF employee_type (
PRIMARY KEY (name),
salary WITH OPTIONS DEFAULT 1000
);
```
## 兼容性
`CREATE TABLE`遵循SQL标准, 一些例外情况在下面列出。
### 临时表
尽管`CREATE TEMPORARY TABLE`的语法和 SQL 标准的类似,但是效果是不同的。 在标准里,临时表只是定义一次并且从空内容开始自动存在于任何需要它们的会话中。 PostgreSQL要求每个会话为它们使用的每个临时表发出它们自己的 `CREATE TEMPORARY TABLE`命令。 这样就允许不同的会话将相同的临时表名字用于不同的目的, 而标准的实现方法则把一个临时表名字约束为具有相同的表结构。
标准定义的临时表的行为被广泛地忽略了。PostgreSQL 在这方面上的行为类似于许多其它 SQL 数据库系统。
SQL标准也区分全局和局部临时表,局部临时表对于每个会话中的每个SQL模块都有一个单独的内容设置, 虽然它的定义仍然在会话中共享。因为PostgreSQL 不支持SQL模块,所以这个差别在PostgreSQL不相关。
出于兼容考虑,PostgreSQL将接受临时表声明中的 `GLOBAL`和`LOCAL`关键字,但是他们没有任何作用。 不建议使用这些关键字,因为PostgreSQL 的未来版本可能采取更加标准兼容的它们的含义。
临时表的`ON COMMIT`子句也类似于 SQL 标准,但是有些区别。 如果忽略了`ON COMMIT`子句,SQL 标准声明缺省的行为是 `ON COMMIT DELETE ROWS`。但是PostgreSQL 里的缺省行为是`ON COMMIT PRESERVE ROWS`。 在 SQL 标准里不存在`ON COMMIT DROP`选项。
### 非延迟的唯一性约束
当`UNIQUE`或`PRIMARY KEY`约束是不可延迟的时, 当插入或修改一个行时,PostgreSQL 立即检查唯一性。SQL标准说唯一约束应该只在语句的结尾强制执行; 这使得它和PostgreSQL不同,例如, 一个命令更新多个键值。要获得标准兼容的行为,声明该约束为 `DEFERRABLE`但是不能延迟(也就是说,`INITIALLY IMMEDIATE`)。 要知道,这会比立即检查唯一性要慢的多。
### 列检查约束
SQL 标准说`CHECK`列约束只能引用他们作用的字段; 只有`CHECK`表约束才能引用多个字段。PostgreSQL 并不强制这个限制;它把字段和表约束看作相同的东西。
### `EXCLUDE` 约束
`EXCLUDE`约束类型是一个PostgreSQL扩展。
### `NULL` "约束"
`NULL` "约束"(实际上不是约束)是 PostgreSQL对 SQL 标准的扩展, 包括它是为了和其它一些数据库系统兼容以及为了和`NOT NULL` 约束对称。因为它是任何字段的缺省,所以它的出现是没有意义的。
### 继承
通过`INHERITS`子句的多重继承是PostgreSQL 语言的扩展。SQL:1999 及以后的标准使用不同的语法和语义定义了单继承。 SQL:1999风格的继承还没有在PostgreSQL中实现。
### 零字段表
PostgreSQL允许创建没有字段的表(比如 `CREATE TABLE foo();`)。这是对 SQL 标准的扩展, 标准不允许存在零字段表。零字段表本身没什么用, 但是禁止他们会给`ALTER TABLE DROP COLUMN`带来很奇怪的情况, 所以,这个时候忽视标准的限制概念非常清楚。
### `WITH` 子句
`WITH`子句是PostgreSQL的扩展,同样, 存储参数和 OID 也是扩展。
### 表空间
PostgreSQL的表空间概念不是标准的东西。 因此`TABLESPACE`和`USING INDEX TABLESPACE`都是扩展。
### 类型化的表
类型化的表实现了SQL标准的一个子集。根据标准, 类型化的表有对应于底层复合类型和一个其他的"自我参考字段"。 PostgreSQL没有明确支持这些自我参考字段,但是相同的效果可以使用OID特性达到。
## 又见
[ALTER TABLE](#calibre_link-88), [DROP TABLE](#calibre_link-98), [CREATE TABLE AS](#calibre_link-76), [CREATE TABLESPACE](#calibre_link-99), [CREATE TYPE](#calibre_link-100)
- 前言
- 何为PostgreSQL?
- PostgreSQL简史
- 格式约定
- 更多信息
- 臭虫汇报指导
- I. 教程
- Chapter 1. 从头开始
- 1.1. 安装
- 1.2. 体系基本概念
- 1.3. 创建一个数据库
- 1.4. 访问数据库
- Chapter 2. SQL语言
- 2.1. 介绍
- 2.2. 概念
- 2.3. 创建新表
- 2.4. 向表中添加行
- 2.5. 查询一个表
- 2.6. 在表间连接
- 2.7. 聚集函数
- 2.8. 更新
- 2.9. 删除
- Chapter 3. 高级特性
- 3.1. 介绍
- 3.2. 视图
- 3.3. 外键
- 3.4. 事务
- 3.5. 窗口函数
- 3.6. 继承
- 3.7. 结论
- II. SQL 语言
- Chapter 4. SQL语法
- 4.1. 词法结构
- 4.2. 值表达式
- 4.3. 调用函数
- Chapter 5. 数据定义
- 5.1. 表的基本概念
- 5.2. 缺省值
- 5.3. 约束
- 5.4. 系统字段
- 5.5. 修改表
- 5.6. 权限
- 5.7. 模式
- 5.8. 继承
- 5.9. 分区
- 5.10. 外部数据
- 5.11. 其它数据库对象
- 5.12. 依赖性跟踪
- Chapter 6. 数据操作
- 6.1. 插入数据
- 6.2. 更新数据
- 6.3. 删除数据
- Chapter 7. 查询
- 7.1. 概述
- 7.2. 表表达式
- 7.3. 选择列表
- 7.4. 组合查询
- 7.5. 行排序
- 7.6. LIMIT和OFFSET
- 7.7. VALUES列表
- 7.8. WITH 查询 (通用表表达式)
- Chapter 8. 数据类型
- 8.1. 数值类型
- 8.2. 货币类型
- 8.3. 字符类型
- 8.4. 二进制数据类型
- 8.5. 日期/时间类型
- 8.6. 布尔类型
- 8.7. 枚举类型
- 8.8. 几何类型
- 8.9. 网络地址类型
- 8.10. 位串类型
- 8.11. 文本搜索类型
- 8.12. UUID 类型
- 8.13. XML 类型
- 8.14. JSON 类型
- 8.15. Arrays
- 8.16. 复合类型
- 8.17. 范围类型
- 8.18. 对象标识符类型
- 8.19. 伪类型
- Chapter 9. 函数和操作符
- 9.1. 逻辑操作符
- 9.2. 比较操作符
- 9.3. 数学函数和操作符
- 9.4. 字符串函数和操作符
- 9.5. 二进制字符串函数和操作符
- 9.6. 位串函数和操作符
- 9.7. 模式匹配
- 9.8. 数据类型格式化函数
- 9.9. 时间/日期函数和操作符
- 9.10. 支持枚举函数
- 9.11. 几何函数和操作符
- 9.12. 网络地址函数和操作符
- 9.13. 文本检索函数和操作符
- 9.14. XML 函数
- 9.15. JSON 函数和操作符
- 9.16. 序列操作函数
- 9.17. 条件表达式
- 9.18. 数组函数和操作符
- 9.19. 范围函数和操作符
- 9.20. 聚集函数
- 9.21. 窗口函数
- 9.22. 子查询表达式
- 9.23. 行和数组比较
- 9.24. 返回集合的函数
- 9.25. 系统信息函数
- 9.26. 系统管理函数
- 9.27. 触发器函数
- 9.28. 事件触发函数
- Chapter 10. 类型转换
- 10.1. 概述
- 10.2. 操作符
- 10.3. 函数
- 10.4. 值存储
- 10.5. UNION, CASE 和相关构造
- Chapter 11. 索引
- 11.1. 介绍
- 11.2. 索引类型
- 11.3. 多字段索引
- 11.4. 索引和ORDER BY
- 11.5. 组合多个索引
- 11.6. 唯一索引
- 11.7. 表达式上的索引
- 11.8. 部分索引
- 11.9. 操作符类和操作符族
- 11.10. 索引和排序
- 11.11. 检查索引的使用
- Chapter 12. 全文检索
- 12.1. 介绍
- 12.2. 表和索引
- 12.3. 控制文本搜索
- 12.4. 附加功能
- 12.5. 解析器
- 12.6. 词典
- 12.7. 配置实例
- 12.8. 测试和调试文本搜索
- 12.9. GiST和GIN索引类型
- 12.10. psql支持
- 12.11. 限制
- 12.12. 来自8.3之前文本搜索的迁移
- Chapter 13. 并发控制
- 13.1. 介绍
- 13.2. 事务隔离
- 13.3. 明确锁定
- 13.4. 应用层数据完整性检查
- 13.5. 锁和索引
- Chapter 14. 性能提升技巧
- 14.1. 使用EXPLAIN
- 14.2. 规划器使用的统计信息
- 14.3. 用明确的JOIN控制规划器
- 14.4. 向数据库中添加记录
- 14.5. 非持久性设置
- III. 服务器管理
- Chapter 15. 源码安装
- 15.1. 简版
- 15.2. 要求
- 15.3. 获取源码
- 15.4. 安装过程
- 15.5. 安装后设置
- 15.6. 支持平台
- 15.7. 特定平台注意事项
- Chapter 16. Windows下用源代码安装
- 16.1. 用Visual C++或Microsoft Windows SDK编译
- 16.2. 用Visual C++或 Borland C++编译 libpq
- Chapter 17. 服务器设置和操作
- 17.1. PostgreSQL用户账户
- 17.2. 创建数据库集群
- 17.3. 启动数据库服务器
- 17.4. 管理内核资源
- 17.5. 关闭服务器
- 17.6. 升级一个 PostgreSQL 集群
- 17.7. 防止服务器欺骗
- 17.8. 加密选项
- 17.9. 用 SSL 进行安全的 TCP/IP 连接
- 17.10. 用SSH隧道进行安全 TCP/IP 连接
- 17.11. 在Windows上注册事件日志
- Chapter 18. 服务器配置
- 18.1. 设置参数
- 18.2. 文件位置
- 18.3. 连接和认证
- 18.4. 资源消耗
- 18.5. 预写式日志
- 18.6. 复制
- 18.7. 查询规划
- 18.8. 错误报告和日志
- 18.9. 运行时统计
- 18.10. 自动清理
- 18.11. 客户端连接缺省
- 18.12. 锁管理
- 18.13. 版本和平台兼容性
- 18.14. Error Handling
- 18.15. 预置选项
- 18.16. 自定义选项
- 18.17. 开发人员选项
- 18.18. 短选项
- Chapter 19. 用户认证
- 19.1. pg_hba.conf文件
- 19.2. 用户名映射
- 19.3. 认证方法
- 19.4. 用户认证
- Chapter 20. 数据库角色
- 20.1. 数据库角色
- 20.2. 角色属性
- 20.3. 角色成员
- 20.4. 函数和触发器安全
- Chapter 21. 管理数据库
- 21.1. 概述
- 21.2. 创建一个数据库
- 21.3. 模板数据库
- 21.4. 数据库配置
- 21.5. 删除数据库
- 21.6. 表空间
- Chapter 22. 区域
- 22.1. 区域支持
- 22.2. 排序规则支持
- 22.3. 字符集支持
- Chapter 23. 日常数据库维护工作
- 23.1. 日常清理
- 23.2. 经常重建索引
- 23.3. 日志文件维护
- Chapter 24. 备份与恢复
- 24.1. SQL转储
- 24.2. 文件系统级别备份
- 24.3. 在线备份以及即时恢复(PITR)
- Chapter 25. 高可用性与负载均衡,复制
- 25.1. 不同解决方案的比较
- 25.2. 日志传送备份服务器
- 25.3. 失效切换
- 25.4. 日志传送的替代方法
- 25.5. 热备
- Chapter 26. 恢复配置
- 26.1. 归档恢复设置
- 26.2. 恢复目标设置
- 26.3. 备用服务器设置
- Chapter 27. 监控数据库的活动
- 27.1. 标准Unix工具
- 27.2. 统计收集器
- 27.3. 查看锁
- 27.4. 动态跟踪
- Chapter 28. 监控磁盘使用情况
- 28.1. 判断磁盘的使用量
- 28.2. 磁盘满导致的失效
- Chapter 29. 可靠性和预写式日志
- 29.1. 可靠性
- 29.2. 预写式日志(WAL)
- 29.3. 异步提交
- 29.4. WAL 配置
- 29.5. WAL 内部
- Chapter 30. 回归测试
- 30.1. 运行测试
- 30.2. 测试评估
- 30.3. 平台相关的比较文件
- 30.4. 测试覆盖率检查
- IV. 客户端接口
- Chapter 31. libpq - C 库
- 31.1. 数据库连接控制函数
- 31.2. 连接状态函数
- 31.3. 命令执行函数
- 31.4. 异步命令处理
- 31.5. 逐行检索查询结果
- 31.6. 取消正在处理的查询
- 31.7. 捷径接口
- 31.8. 异步通知
- 31.9. 与COPY命令相关的函数
- 31.10. 控制函数
- 31.11. 各种函数
- 31.12. 注意信息处理
- 31.13. 事件系统
- 31.14. 环境变量
- 31.15. 口令文件
- 31.16. 连接服务的文件
- 31.17. LDAP查找连接参数
- 31.18. SSL 支持
- 31.19. 在多线程程序里的行为
- 31.20. 制作libpq程序
- 31.21. 例子程序
- Chapter 32. 大对象
- 32.1. 介绍
- 32.2. 实现特点
- 32.3. 客户端接口
- 32.4. 服务器端函数
- 32.5. 例子程序
- Chapter 33. ECPG - 在C中嵌入SQL
- 33.1. 概念
- 33.2. 管理数据库连接
- 33.3. 运行SQL命令
- 33.4. 使用宿主变量
- 33.5. 动态SQL
- 33.6. pgtypes 库
- 33.7. 使用描述符范围
- 33.8. 错误处理
- 33.9. 预处理器指令
- 33.10. 处理嵌入的SQL程序
- 33.11. 库函数
- 33.12. 大对象
- 33.13. C++应用程序
- 33.14. 嵌入的SQL命令
- ALLOCATE DESCRIPTOR
- CONNECT
- DEALLOCATE DESCRIPTOR
- DECLARE
- DESCRIBE
- DISCONNECT
- EXECUTE IMMEDIATE
- GET DESCRIPTOR
- OPEN
- PREPARE
- SET AUTOCOMMIT
- SET CONNECTION
- SET DESCRIPTOR
- TYPE
- VAR
- WHENEVER
- 33.15. Informix兼容模式
- 33.16. 内部
- Chapter 34. 信息模式
- 34.1. 关于这个模式
- 34.2. 数据类型
- 34.3. information_schema_catalog_name
- 34.4. administrable_role_authorizations
- 34.5. applicable_roles
- 34.6. attributes
- 34.7. character_sets
- 34.8. check_constraint_routine_usage
- 34.9. check_constraints
- 34.10. collations
- 34.11. collation_character_set_applicability
- 34.12. column_domain_usage
- 34.13. column_options
- 34.14. column_privileges
- 34.15. column_udt_usage
- 34.16. columns
- 34.17. constraint_column_usage
- 34.18. constraint_table_usage
- 34.19. data_type_privileges
- 34.20. domain_constraints
- 34.21. domain_udt_usage
- 34.22. domains
- 34.23. element_types
- 34.24. enabled_roles
- 34.25. foreign_data_wrapper_options
- 34.26. foreign_data_wrappers
- 34.27. foreign_server_options
- 34.28. foreign_servers
- 34.29. foreign_table_options
- 34.30. foreign_tables
- 34.31. key_column_usage
- 34.32. parameters
- 34.33. referential_constraints
- 34.34. role_column_grants
- 34.35. role_routine_grants
- 34.36. role_table_grants
- 34.37. role_udt_grants
- 34.38. role_usage_grants
- 34.39. routine_privileges
- 34.40. routines
- 34.41. schemata
- 34.42. sequences
- 34.43. sql_features
- 34.44. sql_implementation_info
- 34.45. sql_languages
- 34.46. sql_packages
- 34.47. sql_parts
- 34.48. sql_sizing
- 34.49. sql_sizing_profiles
- 34.50. table_constraints
- 34.51. table_privileges
- 34.52. tables
- 34.53. triggered_update_columns
- 34.54. triggers
- 34.55. udt_privileges
- 34.56. usage_privileges
- 34.57. user_defined_types
- 34.58. user_mapping_options
- 34.59. user_mappings
- 34.60. view_column_usage
- 34.61. view_routine_usage
- 34.62. view_table_usage
- 34.63. views
- V. 服务器端编程
- Chapter 35. 扩展SQL
- 35.1. 扩展性是如何实现的
- 35.2. PostgreSQL类型系统
- 35.3. 用户定义的函数
- 35.4. 查询语言(SQL)函数
- 35.5. 函数重载
- 35.6. 函数易失性范畴
- 35.7. 过程语言函数
- 35.8. 内部函数
- 35.9. C-语言函数
- 35.10. 用户定义聚集
- 35.11. 用户定义类型
- 35.12. 用户定义操作符
- 35.13. 操作符优化信息
- 35.14. 扩展索引接口
- 35.15. 包装相关对象到一个扩展
- 35.16. 扩展基础设施建设
- Chapter 36. 触发器
- 36.1. 触发器行为概述
- 36.2. 数据改变的可视性
- 36.3. 用C写触发器
- 36.4. 一个完整的触发器例子
- Chapter 37. 事件触发器
- 37.1. 事件触发器行为的概述
- 37.2. 事件触发器触发矩阵
- 37.3. 用C编写事件触发器函数
- 37.4. 一个完整的事件触发器的例子
- Chapter 38. 规则系统
- 38.1. 查询树
- 38.2. 视图和规则系统
- 38.3. 物化视图
- 38.4. 在 INSERT, UPDATE, 和 DELETE上的规则
- 38.5. 规则和权限
- 38.6. 规则和命令状态
- 38.7. 规则与触发器的比较
- Chapter 39. 过程语言
- 39.1. 安装过程语言
- Chapter 40. PL/pgSQL - SQL过程语言
- 40.1. 概述
- 40.2. PL/pgSQL的结构
- 40.3. 声明
- 40.4. 表达式
- 40.5. 基本语句
- 40.6. 控制结构
- 40.7. 游标
- 40.8. 错误和消息
- 40.9. 触发器过程
- 40.10. 在后台下的PL/pgSQL
- 40.11. 开发PL/pgSQL的一些提示
- 40.12. 从Oracle PL/SQL进行移植
- Chapter 41. PL/Tcl - Tcl 过程语言
- 41.1. 概述
- 41.2. PL/Tcl 函数和参数
- 41.3. PL/Tcl里的数据值
- 41.4. PL/Tcl里的全局量
- 41.5. 在PL/Tcl里访问数据库
- 41.6. PL/Tcl里的触发器过程
- 41.7. 模块和unknown的命令
- 41.8. Tcl 过程名字
- Chapter 42. PL/Perl - Perl 过程语言
- 42.1. PL/Perl 函数和参数
- 42.2. PL/Perl里的数据值
- 42.3. 内置函数
- 42.4. PL/Perl里的全局变量
- 42.5. 可信的和不可信的 PL/Perl
- 42.6. PL/Perl 触发器
- 42.7. 后台PL/Perl
- Chapter 43. PL/Python - Python 过程语言
- 43.1. Python 2 vs. Python 3
- 43.2. PL/Python Functions
- 43.3. Data Values
- 43.4. Sharing Data
- 43.5. Anonymous Code Blocks
- 43.6. Trigger Functions
- 43.7. Database Access
- 43.8. Explicit Subtransactions
- 43.9. Utility Functions
- 43.10. Environment Variables
- Chapter 44. 服务器编程接口
- 44.1. 接口函数
- SPI_connect
- SPI_finish
- SPI_push
- SPI_pop
- SPI_execute
- SPI_exec
- SPI_execute_with_args
- SPI_prepare
- SPI_prepare_cursor
- SPI_prepare_params
- SPI_getargcount
- SPI_getargtypeid
- SPI_is_cursor_plan
- SPI_execute_plan
- SPI_execute_plan_with_paramlist
- SPI_execp
- SPI_cursor_open
- SPI_cursor_open_with_args
- SPI_cursor_open_with_paramlist
- SPI_cursor_find
- SPI_cursor_fetch
- SPI_cursor_move
- SPI_scroll_cursor_fetch
- SPI_scroll_cursor_move
- SPI_cursor_close
- SPI_keepplan
- SPI_saveplan
- 44.2. 接口支持函数
- SPI_fname
- SPI_fnumber
- SPI_getvalue
- SPI_getbinval
- SPI_gettype
- SPI_gettypeid
- SPI_getrelname
- SPI_getnspname
- 44.3. 内存管理
- SPI_palloc
- SPI_repalloc
- SPI_pfree
- SPI_copytuple
- SPI_returntuple
- SPI_modifytuple
- SPI_freetuple
- SPI_freetuptable
- SPI_freeplan
- 44.4. 数据改变的可视性
- 44.5. 例子
- Chapter 45. 后台工作进程
- VI. 参考手册
- I. SQL 命令
- ABORT
- ALTER AGGREGATE
- ALTER COLLATION
- ALTER CONVERSION
- ALTER DATABASE
- ALTER DEFAULT PRIVILEGES
- ALTER DOMAIN
- ALTER EXTENSION
- ALTER EVENT TRIGGER
- ALTER FOREIGN DATA WRAPPER
- ALTER FOREIGN TABLE
- ALTER FUNCTION
- ALTER GROUP
- ALTER INDEX
- ALTER LANGUAGE
- ALTER LARGE OBJECT
- ALTER MATERIALIZED VIEW
- ALTER OPERATOR
- ALTER OPERATOR CLASS
- ALTER OPERATOR FAMILY
- ALTER ROLE
- ALTER RULE
- ALTER SCHEMA
- ALTER SEQUENCE
- ALTER SERVER
- ALTER TABLE
- ALTER TABLESPACE
- ALTER TEXT SEARCH CONFIGURATION
- ALTER TEXT SEARCH DICTIONARY
- ALTER TEXT SEARCH PARSER
- ALTER TEXT SEARCH TEMPLATE
- ALTER TRIGGER
- ALTER TYPE
- ALTER USER
- ALTER USER MAPPING
- ALTER VIEW
- ANALYZE
- BEGIN
- CHECKPOINT
- CLOSE
- CLUSTER
- COMMENT
- COMMIT
- COMMIT PREPARED
- COPY
- CREATE AGGREGATE
- CREATE CAST
- CREATE COLLATION
- CREATE CONVERSION
- CREATE DATABASE
- CREATE DOMAIN
- CREATE EXTENSION
- CREATE EVENT TRIGGER
- CREATE FOREIGN DATA WRAPPER
- CREATE FOREIGN TABLE
- CREATE FUNCTION
- CREATE GROUP
- CREATE INDEX
- CREATE LANGUAGE
- CREATE MATERIALIZED VIEW
- CREATE OPERATOR
- CREATE OPERATOR CLASS
- CREATE OPERATOR FAMILY
- CREATE ROLE
- CREATE RULE
- CREATE SCHEMA
- CREATE SEQUENCE
- CREATE SERVER
- CREATE TABLE
- CREATE TABLE AS
- CREATE TABLESPACE
- CREATE TEXT SEARCH CONFIGURATION
- CREATE TEXT SEARCH DICTIONARY
- CREATE TEXT SEARCH PARSER
- CREATE TEXT SEARCH TEMPLATE
- CREATE TRIGGER
- CREATE TYPE
- CREATE USER
- CREATE USER MAPPING
- CREATE VIEW
- DEALLOCATE
- DECLARE
- DELETE
- DISCARD
- DO
- DROP AGGREGATE
- DROP CAST
- DROP COLLATION
- DROP CONVERSION
- DROP DATABASE
- DROP DOMAIN
- DROP EXTENSION
- DROP EVENT TRIGGER
- DROP FOREIGN DATA WRAPPER
- DROP FOREIGN TABLE
- DROP FUNCTION
- DROP GROUP
- DROP INDEX
- DROP LANGUAGE
- DROP MATERIALIZED VIEW
- DROP OPERATOR
- DROP OPERATOR CLASS
- DROP OPERATOR FAMILY
- DROP OWNED
- DROP ROLE
- DROP RULE
- DROP SCHEMA
- DROP SEQUENCE
- DROP SERVER
- DROP TABLE
- DROP TABLESPACE
- DROP TEXT SEARCH CONFIGURATION
- DROP TEXT SEARCH DICTIONARY
- DROP TEXT SEARCH PARSER
- DROP TEXT SEARCH TEMPLATE
- DROP TRIGGER
- DROP TYPE
- DROP USER
- DROP USER MAPPING
- DROP VIEW
- END
- EXECUTE
- EXPLAIN
- FETCH
- GRANT
- INSERT
- LISTEN
- LOAD
- LOCK
- MOVE
- NOTIFY
- PREPARE
- PREPARE TRANSACTION
- REASSIGN OWNED
- REFRESH MATERIALIZED VIEW
- REINDEX
- RELEASE SAVEPOINT
- RESET
- REVOKE
- ROLLBACK
- ROLLBACK PREPARED
- ROLLBACK TO SAVEPOINT
- SAVEPOINT
- SECURITY LABEL
- SELECT
- SELECT INTO
- SET
- SET CONSTRAINTS
- SET ROLE
- SET SESSION AUTHORIZATION
- SET TRANSACTION
- SHOW
- START TRANSACTION
- TRUNCATE
- UNLISTEN
- UPDATE
- VACUUM
- VALUES
- II. PostgreSQL 客户端应用程序
- clusterdb
- createdb
- createlang
- createuser
- dropdb
- droplang
- dropuser
- ecpg
- pg_basebackup
- pg_config
- pg_dump
- pg_dumpall
- pg_isready
- pg_receivexlog
- pg_restore
- psql
- reindexdb
- vacuumdb
- III. PostgreSQL 服务器应用程序
- initdb
- pg_controldata
- pg_ctl
- pg_resetxlog
- postgres
- postmaster
- VII. 内部
- Chapter 46. PostgreSQL内部概述
- 46.1. 查询经过的路径
- 46.2. 连接是如何建立起来的
- 46.3. 分析器阶段
- 46.4. PostgreSQL规则系统
- 46.5. 规划器/优化器
- 46.6. 执行器
- Chapter 47. 系统表
- 47.1. 概述
- 47.2. pg_aggregate
- 47.3. pg_am
- 47.4. pg_amop
- 47.5. pg_amproc
- 47.6. pg_attrdef
- 47.7. pg_attribute
- 47.8. pg_authid
- 47.9. pg_auth_members
- 47.10. pg_cast
- 47.11. pg_class
- 47.12. pg_event_trigger
- 47.13. pg_constraint
- 47.14. pg_collation
- 47.15. pg_conversion
- 47.16. pg_database
- 47.17. pg_db_role_setting
- 47.18. pg_default_acl
- 47.19. pg_depend
- 47.20. pg_description
- 47.21. pg_enum
- 47.22. pg_extension
- 47.23. pg_foreign_data_wrapper
- 47.24. pg_foreign_server
- 47.25. pg_foreign_table
- 47.26. pg_index
- 47.27. pg_inherits
- 47.28. pg_language
- 47.29. pg_largeobject
- 47.30. pg_largeobject_metadata
- 47.31. pg_namespace
- 47.32. pg_opclass
- 47.33. pg_operator
- 47.34. pg_opfamily
- 47.35. pg_pltemplate
- 47.36. pg_proc
- 47.37. pg_range
- 47.38. pg_rewrite
- 47.39. pg_seclabel
- 47.40. pg_shdepend
- 47.41. pg_shdescription
- 47.42. pg_shseclabel
- 47.43. pg_statistic
- 47.44. pg_tablespace
- 47.45. pg_trigger
- 47.46. pg_ts_config
- 47.47. pg_ts_config_map
- 47.48. pg_ts_dict
- 47.49. pg_ts_parser
- 47.50. pg_ts_template
- 47.51. pg_type
- 47.52. pg_user_mapping
- 47.53. 系统视图
- 47.54. pg_available_extensions
- 47.55. pg_available_extension_versions
- 47.56. pg_cursors
- 47.57. pg_group
- 47.58. pg_indexes
- 47.59. pg_locks
- 47.60. pg_matviews
- 47.61. pg_prepared_statements
- 47.62. pg_prepared_xacts
- 47.63. pg_roles
- 47.64. pg_rules
- 47.65. pg_seclabels
- 47.66. pg_settings
- 47.67. pg_shadow
- 47.68. pg_stats
- 47.69. pg_tables
- 47.70. pg_timezone_abbrevs
- 47.71. pg_timezone_names
- 47.72. pg_user
- 47.73. pg_user_mappings
- 47.74. pg_views
- Chapter 48. 前/后端协议
- 48.1. 概要
- 48.2. 消息流
- 48.3. 流复制协议
- 48.4. 消息数据类型
- 48.5. 消息格式
- 48.6. 错误和通知消息字段
- 48.7. 自协议 2.0 以来的变化的概述
- Chapter 49. PostgreSQL 编码约定
- 49.1. 格式
- 49.2. 报告服务器里的错误
- 49.3. 错误消息风格指导
- Chapter 50. 本地语言支持
- 50.1. 寄语翻译家
- 50.2. 寄语程序员
- Chapter 51. 书写一个过程语言处理器
- Chapter 52. 写一个外数据包
- 52.1. 外数据封装函数
- 52.2. 外数据封装回调程序
- 52.3. 外数据封装辅助函数
- 52.4. 外数据封装查询规划
- Chapter 53. 基因查询优化器
- 53.1. 作为复杂优化问题的查询处理
- 53.2. 基因算法
- 53.3. PostgreSQL 里的基因查询优化(GEQO)
- 53.4. 进一步阅读
- Chapter 54. 索引访问方法接口定义
- 54.1. 索引的系统表记录
- 54.2. 索引访问方法函数
- 54.3. 索引扫描
- 54.4. 索引锁的考量
- 54.5. 索引唯一性检查
- 54.6. 索引开销估计函数
- Chapter 55. GiST索引
- 55.1. 介绍
- 55.2. 扩展性
- 55.3. 实现
- 55.4. 例
- Chapter 56. SP-GiST索引
- 56.1. 介绍
- 56.2. 扩展性
- 56.3. 实现
- 56.4. 例
- Chapter 57. GIN索引
- 57.1. 介绍
- 57.2. 扩展性
- 57.3. 实现
- 57.4. GIN提示与技巧
- 57.5. 限制
- 57.6. 例子
- Chapter 58. 数据库物理存储
- 58.1. 数据库文件布局
- 58.2. TOAST
- 58.3. 自由空间映射
- 58.4. 可见映射
- 58.5. 初始化分支
- 58.6. 数据库分页文件
- Chapter 59. BKI后端接口
- 59.1. BKI 文件格式
- 59.2. BKI 命令
- 59.3. 系统初始化的BKI文件的结构
- 59.4. 例子
- Chapter 60. 规划器如何使用统计信息
- 60.1. 行预期的例子
- VIII. 附录
- Appendix A. PostgreSQL 错误代码
- Appendix B. 日期/时间支持
- B.1. 日期/时间输入解析
- B.2. 日期/时间关键字
- B.3. 日期/时间配置文件
- B.4. 单位历史
- Appendix C. SQL关键字
- Appendix D. SQL兼容性
- D.1. 支持的特性
- D.2. 不支持的特性
- Appendix E. 版本说明
- E.1. 版本 9.3.1
- E.2. 版本 9.3
- E.3. 版本9.2.5
- E.4. 版本9.2.4
- E.5. 版本9.2.3
- E.6. 版本9.2.2
- E.7. 版本9.2.1
- E.8. 版本9.2
- E.9. 发布9.1.10
- E.10. 发布9.1.9
- E.11. 发布9.1.8
- E.12. 发布9.1.7
- E.13. 发布9.1.6
- E.14. 发布9.1.5
- E.15. 发布9.1.4
- E.16. 发布9.1.3
- E.17. 发布9.1.2
- E.18. 发布9.1.1
- E.19. 发布9.1
- E.20. 版本 9.0.14
- E.21. 版本 9.0.13
- E.22. 版本 9.0.12
- E.23. 版本 9.0.11
- E.24. 版本 9.0.10
- E.25. 版本 9.0.9
- E.26. 版本 9.0.8
- E.27. 版本 9.0.7
- E.28. 版本 9.0.6
- E.29. 版本 9.0.5
- E.30. 版本 9.0.4
- E.31. 版本 9.0.3
- E.32. 版本 9.0.2
- E.33. 版本 9.0.1
- E.34. 版本 9.0
- E.35. 发布8.4.18
- E.36. 发布8.4.17
- E.37. 发布8.4.16
- E.38. 发布8.4.15
- E.39. 发布8.4.14
- E.40. 发布8.4.13
- E.41. 发布8.4.12
- E.42. 发布8.4.11
- E.43. 发布8.4.10
- E.44. 发布8.4.9
- E.45. 发布8.4.8
- E.46. 发布8.4.7
- E.47. 发布8.4.6
- E.48. 发布8.4.5
- E.49. 发布8.4.4
- E.50. 发布8.4.3
- E.51. 发布8.4.2
- E.52. 发布8.4.1
- E.53. 发布8.4
- E.54. 发布8.3.23
- E.55. 发布8.3.22
- E.56. 发布8.3.21
- E.57. 发布8.3.20
- E.58. 发布8.3.19
- E.59. 发布8.3.18
- E.60. 发布8.3.17
- E.61. 发布8.3.16
- E.62. 发布8.3.15
- E.63. 发布8.3.14
- E.64. 发布8.3.13
- E.65. 发布8.3.12
- E.66. 发布8.3.11
- E.67. 发布8.3.10
- E.68. 发布8.3.9
- E.69. 发布8.3.8
- E.70. 发布8.3.7
- E.71. 发布8.3.6
- E.72. 发布8.3.5
- E.73. 发布8.3.4
- E.74. 发布8.3.3
- E.75. 发布8.3.2
- E.76. 发布8.3.1
- E.77. 发布8.3
- E.78. 版本 8.2.23
- E.79. 版本 8.2.22
- E.80. 版本 8.2.21
- E.81. 版本 8.2.20
- E.82. 版本 8.2.19
- E.83. 版本 8.2.18
- E.84. 版本 8.2.17
- E.85. 版本 8.2.16
- E.86. 版本 8.2.15
- E.87. 版本 8.2.14
- E.88. 版本 8.2.13
- E.89. 版本 8.2.12
- E.90. 版本 8.2.11
- E.91. 版本 8.2.10
- E.92. 版本 8.2.9
- E.93. 版本 8.2.8
- E.94. 版本 8.2.7
- E.95. 版本 8.2.6
- E.96. 版本 8.2.5
- E.97. 版本 8.2.4
- E.98. 版本 8.2.3
- E.99. 版本 8.2.2
- E.100. 版本 8.2.1
- E.101. 版本 8.2
- E.102. 版本 8.1.23
- E.103. 版本 8.1.22
- E.104. 版本 8.1.21
- E.105. 版本 8.1.20
- E.106. 版本 8.1.19
- E.107. 版本 8.1.18
- E.108. 版本 8.1.17
- E.109. 版本 8.1.16
- E.110. 版本 8.1.5
- E.111. 版本 8.1.14
- E.112. 版本 8.1.13
- E.113. 版本 8.1.12
- E.114. 版本 8.1.11
- E.115. 版本 8.1.10
- E.116. 版本 8.1.9
- E.117. 版本 8.1.8
- E.118. 版本 8.1.7
- E.119. 版本 8.1.6
- E.120. 版本 8.1.5
- E.121. 版本 8.1.4
- E.122. 版本 8.1.3
- E.123. 版本 8.1.2
- E.124. 版本 8.1.1
- E.125. 版本 8.1
- E.126. 版本 8.0.26
- E.127. 版本 8.0.25
- E.128. 版本 8.0.24
- E.129. 版本 8.0.23
- E.130. 版本 8.0.22
- E.131. 版本 8.0.21
- E.132. 版本 8.0.20
- E.133. 版本 8.0.19
- E.134. 版本 8.0.18
- E.135. 版本 8.0.17
- E.136. 版本 8.0.16
- E.137. 版本 8.0.15
- E.138. 版本 8.0.14
- E.139. 版本 8.0.13
- E.140. 版本 8.0.12
- E.141. 版本 8.0.11
- E.142. 版本 8.0.10
- E.143. 版本 8.0.9
- E.144. 版本 8.0.8
- E.145. 版本 8.0.7
- E.146. 版本 8.0.6
- E.147. 版本 8.0.5
- E.148. 版本 8.0.4
- E.149. 版本 8.0.3
- E.150. 版本 8.0.2
- E.151. 版本 8.0.1
- E.152. 版本 8.0.0
- E.153. 版本 7.4.30
- E.154. 版本 7.4.29
- E.155. 版本 7.4.28
- E.156. 版本 7.4.27
- E.157. 版本 7.4.26
- E.158. 版本 7.4.25
- E.159. 版本 7.4.24
- E.160. 版本 7.4.23
- E.161. 版本 7.4.22
- E.162. 版本 7.4.21
- E.163. 版本 7.4.20
- E.164. 版本 7.4.19
- E.165. 版本 7.4.18
- E.166. 版本 7.4.17
- E.167. 版本 7.4.16
- E.168. 版本 7.4.15
- E.169. 版本 7.4.14
- E.170. 版本 7.4.13
- E.171. 版本 7.4.12
- E.172. 版本 7.4.11
- E.173. 版本 7.4.10
- E.174. 版本 7.4.9
- E.175. 版本 7.4.8
- E.176. 版本 7.4.7
- E.177. 版本 7.4.6
- E.178. 版本 7.4.3
- E.179. 版本 7.4.4
- E.180. 版本 7.4.3
- E.181. 版本 7.4.2
- E.182. 版本 7.4.1
- E.183. 版本 7.4
- E.184. 版本 7.3.21
- E.185. 版本 7.3.20
- E.186. 版本 7.3.19
- E.187. 版本 7.3.18
- E.188. 版本 7.3.17
- E.189. 版本 7.3.16
- E.190. 版本 7.3.15
- E.191. 版本 7.3.14
- E.192. 版本 7.3.13
- E.193. 版本 7.3.12
- E.194. 版本 7.3.11
- E.195. 版本 7.3.10
- E.196. 版本 7.3.9
- E.197. 版本 7.3.8
- E.198. 版本 7.3.7
- E.199. 版本 7.3.6
- E.200. 版本 7.3.5
- E.201. 版本 7.3.4
- E.202. 版本 7.3.3
- E.203. 版本 7.3.2
- E.204. 版本 7.3.1
- E.205. 版本 7.3
- E.206. 版本 7.2.8
- E.207. 版本 7.2.7
- E.208. 版本 7.2.6
- E.209. 版本 7.2.5
- E.210. 版本 7.2.4
- E.211. 版本 7.2.3
- E.212. 版本 7.2.2
- E.213. 版本 7.2.1
- E.214. 版本 7.2
- E.215. 版本 7.1.3
- E.216. 版本 7.1.2
- E.217. 版本 7.1.1
- E.218. 版本 7.1
- E.219. 版本 7.0.3
- E.220. 版本 7.0.2
- E.221. 版本 7.0.1
- E.222. 版本 7.0
- E.223. 版本 6.5.3
- E.224. 版本 6.5.2
- E.225. 版本 6.5.1
- E.226. 版本 6.5
- E.227. 版本 6.4.2
- E.228. 版本 6.4.1
- E.229. 版本 6.4
- E.230. 版本 6.3.2
- E.231. 版本 6.3.1
- E.232. 版本 6.3
- E.233. 版本 6.2.1
- E.234. 版本 6.2
- E.235. 版本 6.1.1
- E.236. 版本 6.1
- E.237. 版本 6.0
- E.238. 版本 1.09
- E.239. 版本 1.02
- E.240. 版本 1.01
- E.241. 版本 1.0
- E.242. Postgres95 版本 0.03
- E.243. Postgres95 版本 0.02
- E.244. Postgres95 版本 0.01
- Appendix F. 额外提供的模块
- F.1. adminpack
- F.2. auth_delay
- F.3. auto_explain
- F.4. btree_gin
- F.5. btree_gist
- F.6. chkpass
- F.7. citext
- F.8. cube
- F.9. dblink
- dblink_connect
- dblink_connect_u
- dblink_disconnect
- dblink
- dblink_exec
- dblink_open
- dblink_fetch
- dblink_close
- dblink_get_connections
- dblink_error_message
- dblink_send_query
- dblink_is_busy
- dblink_get_notify
- dblink_get_result
- dblink_cancel_query
- dblink_get_pkey
- dblink_build_sql_insert
- dblink_build_sql_delete
- dblink_build_sql_update
- F.10. dict_int
- F.11. dict_xsyn
- F.12. dummy_seclabel
- F.13. earthdistance
- F.14. file_fdw
- F.15. fuzzystrmatch
- F.16. hstore
- F.17. intagg
- F.18. intarray
- F.19. isn
- F.20. lo
- F.21. ltree
- F.22. pageinspect
- F.23. passwordcheck
- F.24. pg_buffercache
- F.25. pgcrypto
- F.26. pg_freespacemap
- F.27. pgrowlocks
- F.28. pg_stat_statements
- F.29. pgstattuple
- F.30. pg_trgm
- F.31. postgres_fdw
- F.32. seg
- F.33. sepgsql
- F.34. spi
- F.35. sslinfo
- F.36. tablefunc
- F.37. tcn
- F.38. test_parser
- F.39. tsearch2
- F.40. unaccent
- F.41. uuid-ossp
- F.42. xml2
- Appendix G. 额外提供的程序
- G.1. 客户端应用程序
- oid2name
- pgbench
- vacuumlo
- G.2. 服务器端应用程序
- pg_archivecleanup
- pg_standby
- pg_test_fsync
- pg_test_timing
- pg_upgrade
- pg_xlogdump
- Appendix H. 外部项目
- H.1. 客户端接口
- H.2. 管理工具
- H.3. 过程语言
- H.4. 扩展
- Appendix I. 源代码库
- I.1. 获得源代码通过Git
- Appendix J. 文档
- J.1. DocBook
- J.2. 工具集
- J.3. 制作文档
- J.4. 文档写作
- J.5. 风格指导
- Appendix K. 首字母缩略词
- 参考书目
- Index