輸出

status

ERROR: ExecAppend: Fail to add null value in not null attribute "column".

當試圖向一個有 NOT NULL 約束的列插入一個空值時返回此運行時錯誤．

描述

用法

在表 distributors 上定義兩個（非空）NOT NULL 列約束，其中一個是命名約束：

CREATE TABLE distributors (
    did      DECIMAL(3) CONSTRAINT no_null NOT NULL,
    name     VARCHAR(40) NOT NULL
);
     

輸入

constraint_name

賦予一個約束子句的任意名字．

Outputs

status

ERROR: Cannot insert a duplicate key into a unique index.

如果試圖向列/字段中插入一個重復數值，返回此運行時錯誤．

描述

UNIQUE 約束表明一個這樣的規則： 表中一組由一個或多個獨立列組成的集合中只能包含一個唯一的數值．

一個列/字段定義包含了 UNIQUE 約束，不一定要包含 NOT NULL 約束． 在一個沒有NOT NULL 約束的列/字段列如果有多個空值并不違反 UNIQUE 約束． （這與 SQL92 定義不一致，但卻是更有意義的習慣． 請參閱兼容性部分獲取更多細節．）

每個 UNIQUE 列約束必須賦予一個該表中沒有被其他 UNIQUE 或 PRIMARY KEY 約束定義過的列/字段上．

用法

為表 name 字段 定義一個 UNIQUE 約束：

CREATE TABLE distributors (
    did      DECIMAL(3),
    name     VARCHAR(40) UNIQUE
);
  

CREATE TABLE distributors (
    did      DECIMAL(3),
    name     VARCHAR(40),
    UNIQUE(name)
);
     

輸入

constraint_name

賦予約束的任意名稱．

condition

任何產生一個布爾值的有效的條件表達式．

輸出

status

ERROR: ExecAppend: rejected due to CHECK constraint "constraint_name".

此錯誤發生在運行時， 如果試圖向列/字段中插入一個違反 CHECK 約束的非法數值．

描述

CHECK 約束聲明一個列中允許的數據的限制． CHECK 約束也可以做表約束．

CHECK 聲明一個涉及到一個表中一個或多個字段的一般的布爾表達失． 如果給某行的這些字段提供的數值經這個表達式計算出 FALSE，那么 該新行將被拒絕．

目前，CHECK 表達式不能包含子查詢，也不能引用除了當前行里的字段之外的 其它變量．

SQL92 CHECK 列約束只能對表中的一列/字段進行定義或使用． Postgres 沒有這個限制． 它把列約束和表約束一視同仁．

輸入

constraint_name

約束的任意名稱．

輸出

ERROR: Cannot insert a duplicate key into a unique index.

當你試圖向一個有 PRIMARY KEY 約束的列插入一個重復的數值時， 將返回這個運行時信息．

描述

PRIMARY KEY 列約束表明表中的一個列/字段只能包含唯一的（不重復）， 非空的數值．在該列/字段的PRIMARY KEY 約束定義中不需要顯式的包括NOT NULL 約束．

一個表只能聲明一個 PRIMARY KEY，不管是作為列約束還是表約束．

注意

Postgres 自動創建一個唯一索引以 保證數據的完整性．（參閱 CREATE INDEX 語句）

在同一個表中 PRIMARY KEY 約束定義的列應該應該和其他定義了 UNIQUE 約束的列不同名（不是同一列）． 因為這會導致等價索引的重復和增加不必要的處理．然而， Postgres 并沒有明文禁止這些．

輸入

constraint_name

約束的任意名稱．

reftable

包含對比檢查數據的表的名稱．

refcolumn

reftable 里要做對比檢查的字段名稱．如果沒有聲明，使用表 reftable 的 PRIMARY KEY．

MATCH matchtype

有三種匹配類型：MATCH FULL，MATCH PARTIAL 和一種缺省的匹配類型 （如果什么都沒有聲明的話）． 除非所有的外鍵字段都是 NULL， 否則 MATCH FULL 將不允許一個多列/字段外鍵的某個列為 NULL．缺省的 MATCH 類型是允許某些外鍵字段是 NULL 而其他部分的外鍵字段不是 NULL． MATCH PARTIAL 目前不支持．

ON DELETE action

當一個被參考表里的被參考行要刪除時，要處理的動作．有下列動作．

NO ACTION

如果違反外鍵則產生錯誤．這是缺省．

RESTRICT

與 NO ACTION 相同．

CASCADE

刪除任何引用參考行的行．

SET NULL

把參考列的值設為 NULL．

SET DEFAULT

把參考列的值設置為它們的缺省值．

ON UPDATE action

當一個參考表里的參考列要被更新時，要處理的動作． 如果行被更新而參考列沒有改變，不發生任何動作．有下面動作．

NO ACTION

如果違反外鍵則產生錯誤．這是缺省．

RESTRICT

與 NO ACTION 相同．

CASCADE

把參考列的值更新為被參考列的新值．

SET NULL

把參考列的值設置為 NULL．

SET DEFAULT

把參考列的值設置為缺省值．

[ NOT ] DEFERRABLE

這個選項控制該約束是否可以推遲到事務的結尾． 如果 DEFERRABLE，SET CONSTRAINTS ALL DEFERRED 將導致只是在事務的結束時才檢查外鍵． 缺省是 NOT DEFERRABLE．

INITIALLY checktime

checktime 有兩個可能的值用以聲明檢查約束的缺省時間．

DEFERRED

只在事務結尾檢查約束．

IMMEDIATE

在每條語句（結尾）檢查約束．這是缺省．

輸入

status

ERROR: name referential integrity violation - key referenced from table not found in reftable

如果某人試圖把一個數值插入到一個列中， 而該列在被參考的表中沒有匹配列，則生成這條運行時錯誤．

描述

REFERENCE 列約束指明一個表的某列必須只能包含匹配一個 被參考表的某參考列的數據的數值．

向這個列追加的數值使用給出的匹配類型與被參考表的參考列進行匹配． 另外，當被參考列的數據被修改，則對該列的匹配數據進行操作動作．

注意

目前 Postgres 只支持 MATCH FULL 和一個缺省的匹配類型． 另外，被參考表里的被參考列應該是一個有 UNIQUE 約束 的列，不過 Postgres 并沒有強制這一點．

輸入

constraint_name

賦予約束的任意名稱．

column

某表中的列/字段名．

輸出

status

ERROR: Cannot insert a duplicate key into a unique index

如果試圖向列中插入一個重復的值，將發生此運行時錯誤．

描述

UNIQUE 約束表明這樣一條規則： 表中由一個或若干個獨立的列/字段組成的集合只能包含唯一的數值． 表的 UNIQUE 約束和對應的列/字段約束的行為是一樣的， 區別是表約束可以跨越多個列/字段．

請參考列/字段的 UNIQUE 約束獲取更多細節．

用法

避免表 distributors 中的重復行：

CREATE TABLE distributors (
    did      DECIMAL(3),
    name     VARCHAR(40),
    UNIQUE(did,name)
);
     

輸入

constraint_name

賦予約束的任意名稱．

column [, ... ]

表中的一個或者多個列．

輸出

status

ERROR: Cannot insert a duplicate key into a unique index.

如果試圖向一個有 PRIMARY KEY 約束的表中插入重復值， 返回這個運行時錯誤。

描述

PRIMARY KEY 約束表明某個表的由一個或多個列/字段組成的集合只能包含唯一， （不重復），非空數值．對聲明的列定義的 PRIMARY KEY 約束 不需要包括 NOT NULL 約束．

PRIMARY KEY 表約束與列/字段約束相似，區別是它具有控制多列/字段的能力．

請參考 PRIMARY KEY 列/字段約束部分獲取更多信息．

輸入

constraint_name

約束的任意名稱．

column [, ... ]

表中的一個或者多個列的名稱．

reftable

包含對比檢查數據的表的名稱．

referenced column [, ... ]

reftable 里要做對比檢查的一個或多個字段的名稱． 如果沒有聲明，使用表 reftable 的 PRIMARY KEY．

MATCH matchtype

有三種匹配類型：MATCH FULL，MATCH PARTIAL 和一種缺省的匹配類型 （如果什么都沒有聲明的話）．除 非所有的外鍵字段都是 NULL，否則 MATCH FULL 將不允許一個多列/字段 外鍵的某個列為 NULL．缺省的 MATCH 類型是允許某些外鍵字段是 NULL 而其他部分的外鍵字段不是 NULL．MATCH PARTIAL 目前不支持．

ON DELETE action

當一個被參考表里的被參考行要被刪除時，要處理的動作．有下列動作．

NO ACTION

如果違反外鍵則產生錯誤．這是缺省．

RESTRICT

與 NO ACTION 相同．

CASCADE

刪除任何引用參考行的行．

SET NULL

把參考列的值設為 NULL．

SET DEFAULT

把參考列的值設置為它們的缺省值．

ON UPDATE action

當一個被參考表里的被參考列要更新為新數值時，要處理的動作． 如果行被更新而參考列沒有改變，不發生任何動作．有下面動作．

NO ACTION

如果違反外鍵則產生錯誤．這是缺省．

RESTRICT

不允許被參考的列的更新．

CASCADE

把參考列的值更新為被參考列的新值．

SET NULL

把參考列的值設置為 NULL．

SET DEFAULT

把參考列的值設置為缺省值．

[ NOT ] DEFERRABLE

這個選項控制該約束是否可以推遲到事務的結尾． 如果 DEFERRABLE，SET CONSTRAINTS ALL DEFERRED 將導致只是在事務的結束時才檢查外鍵．缺省是NOT DEFERRABLE．

INITIALLY checktime

checktime 有兩個可能的值用以聲明檢查約束的缺省時間．

IMMEDIATE

在每條語句（結尾）檢查約束．這是缺省．

DEFERRED

只在事務結尾檢查約束．

輸出

status

ERROR: name referential integrity violation - key referenced from table not found in reftable

如果某人試圖把一個數值插入到一個列中， 而該列在被參考的表中沒有匹配列，則生成這條運行時錯誤．

描述

FOREIGN KEY 約束聲明一個規則： 某表的一個或多個獨立列的組與被參考表中的一組獨立列相關．

FOREIGN KEY 表約束與相應的列約束相似，只是多了控制多列/字段的能力．

參考關于 FOREIGN KEY 列約束的內容獲取更多信息．

UNIQUE 子句

SQL92 對 UNIQUE 定義了一些附加的功能．

表約束定義：

[ CONSTRAINT constraint_name ] UNIQUE ( column [, ... ] )
    [ { INITIALLY DEFERRED | INITIALLY IMMEDIATE } ]
    [ [ NOT ] DEFERRABLE ]
     

列/字段約束定義：

[ CONSTRAINT constraint_name ] UNIQUE
      [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
      [ [ NOT ] DEFERRABLE ]
     

NULL 子句

NULL "約束" （實際上不是一個約束）是一個 Postgres 對SQL92的擴展，把它包含進來是為了和 NOT NULL 子句對稱。 因為這是任何列的缺省，它的出現只是添亂。

[ CONSTRAINT constraint_name ] NULL 
     

NOT NULL 子句

SQL92 對 NOT NULL 聲明了一些附加的功能：

[ CONSTRAINT constraint_name ] NOT NULL 
    [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
    [ [ NOT ] DEFERRABLE ]
     

CONSTRAINT 子句

SQL92 對約束聲明了一些附加的功能，并且還定義了斷言和域（domain）約束．

一個斷言是一種特殊類型的完整性約束， 并且和其他約束共享相同的名字空間（namespace）． 不過，一個斷言不象約束那樣必須依賴于某個基本表， 所以 SQL-92 提供了一個 CREATE ASSERTION 語句作為定義約束的一個可選的手段：

CREATE ASSERTION name CHECK ( condition )
    

域約束是用 CREATE DOMAIN 或 ALTER DOMAIN 語句定義的：

域約束：

[ CONSTRAINT constraint_name ] CHECK constraint 
    [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
    [ [ NOT ] DEFERRABLE ]
     

表約束定義：

[ CONSTRAINT constraint_name ] { PRIMARY KEY ( column, ... ) | FOREIGN KEY constraint | UNIQUE constraint | CHECK constraint }
    [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
    [ [ NOT ] DEFERRABLE ]
     

列約束定義：

[ CONSTRAINT constraint_name ] { NOT NULL | PRIMARY KEY | FOREIGN KEY constraint | UNIQUE | CHECK constraint }  
    [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
    [ [ NOT ] DEFERRABLE ]
     

一個 CONSTRAINT （約束）定義可以包含一個 任意順序的延遲屬性的子句和/或一個初始化約束式子句．

NOT DEFERRABLE

意味著每條語句執行后都必須校驗是否違反約束規則． SET CONSTRAINTS ALL DEFERRED 對這類約束沒有影響．

DEFERRABLE

這個選項控制約束是否可以被推遲到事務的結束． 如果使用了 SET CONSTRAINTS ALL DEFERRED 或者約束被 設置成為 INITIALLY DEFERRED，將導致外鍵只在事務結束的時候檢查．

注意: SET CONSTRAINT 只為當前事務改變外鍵約束模式．

INITIALLY IMMEDIATE

在每條語句后檢查約束．這是缺省．

INITIALLY DEFERRED

只在事務結束的時候檢查約束．

CHECK 子句

SQL92 對 CHECK 聲明了一些附加功能，不管是表約束還是列/字段約束．

表約束定義：

[ CONSTRAINT constraint_name ] CHECK ( VALUE condition ) 
      [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
      [ [ NOT ] DEFERRABLE ]
     

列約束定義：

[ CONSTRAINT constraint_name ] CHECK ( VALUE condition ) 
      [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
      [ [ NOT ] DEFERRABLE ]
    

PRIMARY KEY 子句

SQL92 為 PRIMARY KEY 聲明了一些附加的功能：

表約束定義：

[ CONSTRAINT constraint_name ] PRIMARY KEY ( column [, ... ] ) 
    [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
    [ [ NOT ] DEFERRABLE ]
     

列約束定義：

[ CONSTRAINT constraint_name ] PRIMARY KEY 
    [ {INITIALLY DEFERRED | INITIALLY IMMEDIATE} ]
    [ [ NOT ] DEFERRABLE ]
     

繼承

通過 INHERITS 子句進行多重繼承是一個 Postgres 語言擴展．SQL99（但不是 SQL92）使用了一個不同的語法和不同的語義 定義了單繼承．SQL99 風格的繼承還不被 Postgres 支持．