NAME

       ALTER TABLE - 修改表的定義

SYNOPSIS

       ALTER TABLE [ ONLY ] name [ * ]
           ADD [ COLUMN ] column type [ column_constraint [ ... ] ]
       ALTER TABLE [ ONLY ] name [ * ]
           DROP [ COLUMN ] column [ RESTRICT | CASCADE ]
       ALTER TABLE [ ONLY ] name [ * ]
           ALTER [ COLUMN ] column { SET DEFAULT expression | DROP DEFAULT }
       ALTER TABLE [ ONLY ] name [ * ]
           ALTER [ COLUMN ] column { SET | DROP } NOT NULL
       ALTER TABLE [ ONLY ] name [ * ]
           ALTER [ COLUMN ] column SET STATISTICS integer
       ALTER TABLE [ ONLY ] name [ * ]
           ALTER [ COLUMN ] column SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
       ALTER TABLE [ ONLY ] name [ * ]
           SET WITHOUT OIDS
       ALTER TABLE [ ONLY ] name [ * ]
           RENAME [ COLUMN ] column TO new_column
       ALTER TABLE name
           RENAME TO new_name
       ALTER TABLE [ ONLY ] name [ * ]
           ADD table_constraint
       ALTER TABLE [ ONLY ] name [ * ]
           DROP CONSTRAINT constraint_name [ RESTRICT | CASCADE ]
       ALTER TABLE name
           OWNER TO new_owner
       ALTER TABLE name
           CLUSTER ON index_name

DESCRIPTION 描述

       ALTER TABLE 變更一個現存表的定義。它有好幾種子形式：

       ADD COLUMN
               這種形式用和 CREATE TABLE [create_table(7)]  裏一樣的語法向表中增加一個新的字段。

       DROP COLUMN
               這種形式從表中刪除一個字段。請注意，和這個字段相關的索引和表約束也會被自動刪除。
              如果任何表之外的對象依賴於這個字段， 你必須說 CASCADE，比如，外鍵參考，視圖等等。

       SET/DROP DEFAULT
               這種形式爲一個字段設置或者刪除缺省值。請注意缺省值只應用於隨後的   INSERT   命令；
              它們不會導致已經在表中的行的數值的修改。我們也可以爲視圖創建缺省，
              這個時候它們是在視圖的 ON INSERT 規則應用之前插入 INSERT 語句中去的。

       SET/DROP NOT NULL
               這些形式修改一個字段是否標記爲允許      NULL      值或者是拒絕      NULL      值。
              如果表在字段中包含非空值，那麼你只可以 SET NOT NULL。

       SET STATISTICS
              This form
               這個形式爲隨後的      ANALYZE      [analyze(7)]     操作設置每字段的統計收集目標。
              目標的範圍可以在      0      到      1000       之內設置；另外，把他設置爲       -1
              則表示重新恢復到使用系統缺省的統計目標。

       SET STORAGE
               這種形式爲一個字段設置存儲模式。這個設置控制這個字段是內聯保存還是保存在一個附屬的表裏，以及數據是否要壓縮。
              PLAIN     必需用於定長的數值，比如      integer，並且是內聯的，不壓縮的。      MAIN
              用於內聯，可壓縮的數據。    EXTERNAL   用於外部保存，不壓縮的數據，   而   EXTENDED
              用於外部的壓縮數據。 EXTENDED 是所有支持它的數據的缺省。 使用 EXTERNAL 將令在  text
              字段上的子字串操作更快， 付出的代價是增加了存儲空間。

       SET WITHOUT OIDS
               從表中刪除    oid    字段。從表中刪除（設置爲沒有）oid    同樣不會立即發生。   OID
              使用的空間將在元組被更新的時候回收。不更新元組的時候，                          OID
              的空間和數值的維護都是不確定的。這個過程語義上類似 DROP COLUMN  過程。

       RENAME RENAME
              形式改變一個表的名字（或者是一個索引，一個序列，或者一個視圖）或者是表中一個獨立字段的名字。
              它對存儲的數據沒有任何影響。

       ADD table_constraint
               這個形式給表增加一個新的約束，用的語法和 CREATE TABLE [create_table(7)] 一樣。

       DROP CONSTRAINT
               這個形式刪除一個表上的約束。
              目前，在表上的約束不要求有唯一的名字，因此可能有多個約束匹配聲明的名字。
              所有這樣的約束都將被刪除。

       OWNER
               這個形式改變表，索引，序列或者視圖的所有者爲指定所有者。

       CLUSTER
               這種形式爲將來對錶進行的 CLUSTER [cluster(7)] 操作做標記。

        要使用 ALTER TABLE，你必需擁有該表； 除了 ALTER TABLE OWNER 之外，它只能由超級用戶執行。

PARAMETERS 參數

       name
               試圖更改的現存表（可能有模式修飾）的名稱。     如果聲明瞭     ONLY，則只更改該表。
              如果沒有聲明                         ONLY，則該表及其所有後代表（如果有）都被更新。
              我們可以在表名字後面附加一個                                                      *
              表示後代表都被掃描，但是在目前的版本里，這是缺省行爲。      （在7.1之前的版本，ONLY
              是缺省的行爲。）缺省可以通過改變配置選項 SQL_INHERITANCE 來改變。

       column
               現存或新的字段名稱。

       type
               新字段的類型。

       new_column
               新字段的類型。

       new_name
               表的新名稱。

       table_constraint
               表的新的約束定義。

       constraint_name
               要刪除的現有約束的名字。

       new_owner
               該表的新所有者的用戶名。

       index_name
               要標記爲建簇的表上面的索引名字。

       CASCADE
               自動刪除依賴於被依賴字段或者約束的對象（比如，引用該字段的視圖）。

       RESTRICT
               如果字段或者約束還有任何依賴的對象，則拒絕刪除該字段。 這是缺省行爲。

NOTES 注意

        COLUMN 關鍵字是多餘的，可以省略。

        在目前的     ADD     COLUMN實現裏還不支持新列/字段的缺省（值）和    NOT    NULL    子句。
       新字段開始存在時所有值都是  NULL。   不過你可以隨後用   ALTER   TABLE   的   SET   DEFAULT
       形式設置缺省（值）。（你可能還想用     UPDATE    [update(7)]    把已存在行更新爲缺省值。）
       如果你想標記該字段爲非 null，在你爲該字段的所有行輸入非 null 值之後用 SET NOT NULL。

       DROP      COLUMN       命令並不是物理上把字段刪除，       而只是簡單地把它標記爲       SQL
       操作中不可見的。隨後對該表的插入和更新將在該字段存儲一個                            NULL。
       因此，刪除一個字段是很快的，但是它不會立即縮減你的表在磁盤上的大小，因爲被刪除了的字段佔據的空間還沒有回收。
       這些空間將隨着現有的行的更新而得到回收。要立即回收空間，
       我們可以做一個UPDATE所有行的假動作，然後立即 vacuum， 象這樣：

       UPDATE table SET col = col;
       VACUUM FULL table;

        如果表有任何後代表，那麼如果不在後代表上做同樣的修改的話，
       就不允許在父表上增加或者重命名一個字段，也就是說，               ALTER               TABLE
       ONLY將被拒絕。這樣就保證了後代表總是有和父表匹配的字段。

        一個遞歸DROP                                                                       COLUMN
       操作將只有在後代表並不從任何其它父表中繼承該字段並且從來沒有獨立定義該字段的時候才能刪除一個後代表的字段。
       一個非遞歸的DROP       COLUMN（也就是，ALTER       TABLE       ONLY        ...        DROP
       COLUMN）從來不會刪除任何後代字段， 而是把他們標記爲獨立定義的，而不是繼承的。

        不允許更改系統表結構的任何部分。

        請參考CREATE   TABLE   部分獲取更多有效參數的描述。   Chapter   5   ``Data   Definition''
       裏有更多有關繼承的信息。

EXAMPLES 例子

        向表中增加一個 varchar 列：

       ALTER TABLE distributors ADD COLUMN address varchar(30);

        從表中刪除一個字段：

       ALTER TABLE distributors DROP COLUMN address RESTRICT;

        對現存列改名：

       ALTER TABLE distributors RENAME COLUMN address TO city;

        更改現存表的名字∶

       ALTER TABLE distributors RENAME TO suppliers;

        給一個字段增加一個非空約束：

       ALTER TABLE distributors ALTER COLUMN street SET NOT NULL;

        從一個字段裏刪除一個非空約束：

       ALTER TABLE distributors ALTER COLUMN street DROP NOT NULL;

        給一個表增加一個檢查約束：

       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);

        給一個表增加一個自動命名的主鍵約束，要注意的是一個表只能有一個主鍵：

       ALTER TABLE distributors ADD PRIMARY KEY (dist_id);

COMPATIBILITY 兼容性

       ADD COLUMN 形式是兼容 SQL 標準的， 除了上面說的缺省（值）和 NOT NULL 約束外。 ALTER COLUMN
       形式是完全兼容的。

        重命名錶，列/字段，索引，和序列的名字是 PostgreSQL  對 SQL 的擴展。

       ALTER  TABLE DROP COLUMN 可以用於刪除表中的唯一的一個字段， 留下一個零字段的表。這是對 SQL
       的擴展，它不允許零字段表。

譯者

       Postgresql 中文網站 何偉平 <laser@pgsqldb.org>

跋

       本頁面中文版由中文 man 手冊頁計劃提供。
       中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh