修改表
========


如果你创建了一个表后发现自己犯了一个错误，或者是应用的需求发生了变化，那么你可以删除这个表然后重新创建它。但是如果这个表已经填充了许多数据，或者该表已经被其它数据库对象引用，那这可不是一个方便的方法。因此 OushuDB 提供了一组命令用于修改现有表。请注意它在概念上和修改一个表中包含的数据是不一样的：这里我们感兴趣的是修改一个表的定义，或者说结构。

你可以：

* 增加列

* 删除列

* 增加约束

* 删除约束

* 修改缺省值

* 修改列数据类型

* 重命名列

* 重命名表

所有这些动作都是用ALTER TABLE命令执行的。


增加列
-------


要增加一个列，使用下面这样的命令：


::

  ALTER TABLE products ADD COLUMN description text DEFAULT null;
  -- ALTER TABLE products ADD COLUMN description text DEFAULT value;
  ALTER TABLE products ADD COLUMN description text DEFAULT 'default description';

新增的列对于表中已经存在的行而言最初将先填充所给出的缺省值.

你也可以同时在该列上定义约束，使用通常的语法：


::

  -- ALTER TABLE products ADD COLUMN description text DEFAULT value CHECK (description <> '');
  ALTER TABLE products ADD COLUMN description text DEFAULT 'default description' CHECK (description <> '');


实际上，所有在CREATE TABLE里描述的可以应用于列的选项都可以在这里使用。
不过，我们要注意的是缺省值必须满足给出的约束，否则ADD将会失败。
另外，你可以在正确填充了新列的数值之后再增加约束。

.. note:: MAGMA表和HORC表均支持添加/删除列，且MAGMA支持带主键的表加列。


删除列
-------


要删除一列，使用下面这样的命令：


::

  ALTER TABLE products DROP COLUMN description;

列中的任何数据都会消失。涉及该列的表约束也会被删除。
然而，如果该列被另一个表的外键约束引用，则不会默默地删除该约束。
您可以通过添加级联来授权删除依赖于该列的所有内容：

::

  ALTER TABLE products DROP COLUMN description CASCADE;


增加约束
----------


要增加一个约束，必须使用表约束语法。比如：


::

  ALTER TABLE products ADD CHECK (name <> '');

要增加一个不能写成表约束的非空约束，使用下面的语法：


::

  ALTER TABLE products ALTER COLUMN price SET NOT NULL;

这个约束将立即进行检查，所以表在添加约束之前必须符合约束条件。



删除约束
----------


要删除一个约束，你需要知道它的名字。如果你曾经给了它取了名字，那么事情就很简单。否则你就需要找出系统自动分配的名字。psql 的命令\\d tablename可以帮这个忙；其它接口可能也提供了检查表的细节的方法。这条命令是：


::

  ALTER TABLE products DROP CONSTRAINT some_name;

如果你在处理一个生成的约束名，比如$2，别忘了你需要给它添加双引号，让它成为一个有效的标识符。

和删除列一样，如果你想删除被依赖的约束，你需要用CASCADE。 

除了非空约束外，所有约束类型都这么用。要删除非空约束，可以这样：


::

  ALTER TABLE products ALTER COLUMN price DROP NOT NULL;

要记得非空约束没有名字。

.. note:: MAGMA表和HORC表均支持删除约束。


改变列的缺省值
-----------------


为了给某个列设置缺省值，使用下面的语句：


::

  ALTER TABLE products ALTER COLUMN price SET DEFAULT 7.77;

注意该操作不会影响表中的现存行，它只是改变insert操作插入的未来值。

要移除任何缺省值，使用：


::

  ALTER TABLE products ALTER COLUMN price DROP DEFAULT;

该操作与将该列缺省值设为空等价，因此对没有定义缺省值的列进行此操作不会出错，因为缺省值隐式地被认为是null。


.. note:: MAGMA表和HORC表均改变列的缺省值。


改变列的数据类型
-----------------------


把一个列转换成另外一种数据类型，使用下面的命令：


::
   
  ALTER TABLE products ALTER COLUMN price TYPE numeric(10,2);

只有在列里现有的每个项都可以隐含的转换成新类型时才可能成功。如果需要更复杂的转换，你可以增加一个USING子句，它声明如何从旧值里计算新值。

OushuDB 将试图把列的缺省值(如果存在)转换成新的类型，还有涉及该列的任何约束。但是这些转换可能失败，或者可能生成奇怪的结果。在修改某列类型之前，你最好删除那些约束，然后再把合适的约束添加上去。


.. note:: MAGMA表和HORC表均可以改变列的数据类型。


重命名列
----------


重命名一个列：


::

  ALTER TABLE products RENAME COLUMN product_no TO product_number;


.. note:: MAGMA表和HORC表均支持列的重命名操作。


重命名表
----------


重命名一个表：


::

  ALTER TABLE products RENAME TO items;

.. note:: MAGMA表和HORC表均支持表的重命名操作。