修改表

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

你可以:

  • 增加列
  • 删除列
  • 增加约束
  • 删除约束
  • 修改缺省值
  • 修改列数据类型
  • 重命名列
  • 重命名表

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

增加列

要增加一个列,使用下面这样的命令:

ALTER TABLE products ADD COLUMN description text DEFAULT value;

新增的列对于表中已经存在的行而言最初将先填充所给出的缺省值 ( 注意: AO格式的表在添加新列时必须设置缺省值)。

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

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

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

Note

ORC, MAGMA, PARQUET格式的表都不支持增加列。

删除列

要删除一列,使用下面这样的命令:

ALTER TABLE products DROP COLUMN description;

Note

ORC, MAGMA, PARQUET格式的表都不支持删除列。

增加约束

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

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

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

ALTER TABLE products ALTER COLUMN product_no SET NOT NULL;

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

Note

MAGMA格式的表不支持增加约束。

删除约束

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

ALTER TABLE products DROP CONSTRAINT some_name;

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

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

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

ALTER TABLE products ALTER COLUMN product_no DROP NOT NULL;

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

Note

MAGMA格式的表不支持删除约束。

改变列的缺省值

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

ALTER TABLE products ALTER COLUMN price SET DEFAULT 7.77;

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

要移除任何缺省值,使用:

ALTER TABLE products ALTER COLUMN price DROP DEFAULT;

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

Note

AO格式的表可以改变列的缺省值,其他格式的表不支持此类操作。

改变列的数据类型

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

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

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

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

Note

AO格式的表可以改变列的数据类型,其他格式的表不支持此类操作。

重命名列

重命名一个列:

ALTER TABLE products RENAME COLUMN product_no TO product_number;

Note

ORC, MAGMA,PARQUET格式的表不支持列的重命名操作。

重命名表

重命名一个表:

ALTER TABLE products RENAME TO items;

Note

MAGMA格式的表不支持表的重命名操作。