Skip to Content
参考手册SQL命令参考ALTER EXTERNAL TABLE

ALTER EXTERNAL TABLE

更改外部表定义。

语法

ALTER EXTERNAL TABLE <name> <action> [, ... ]
  其中 <action> 可以是：
  ADD [COLUMN] <new_column> <type>
  DROP [COLUMN] <column> [RESTRICT | CASCADE]
  ALTER [COLUMN] <column> TYPE <type>
  OWNER TO <new_owner>

描述

要更改外部表的 Schema，你必须是外部表的所有者并且拥有新 Schema 的 CREATE 权限。

要更改外部表的所有者，你必须是外部表的当前所有者，并且在新的所有者角色的直接或间接成员。新的所有者角色必须拥有外部表所在的 Schema 的 CREATE 权限。

执行以下操作时，需要使用 ALTER TABLE 而不是 ALTER EXTERNAL TABLE：

  • 为外部表设置或更改 Schema。

  • 重命名外部表或表中的列。

  • 为可写的外部表设置或更改分布策略。

ALTER EXTERNAL TABLE 或 ALTER TABLE 对外部数据没有影响。如果你想更改外部表的类型（读、写、网页）、FORMAT 信息，或外部数据的位置，你需要先删除当前的外部表并重新创建。

参数

  • <name>

    外部表的名称，支持使用 Schema 名称进行限定。

  • <action>

    在外部表上执行的操作。支持的操作包括：

    • ADD [COLUMN]：添加列。

      要执行此操作，你必须指定 <new_column> 和 <type>，其中 <new_column> 为新增列的名称，而 <type> 为列的数据类型。

    • DROP [COLUMN]：删除列。

      要执行此操作，必须制定要删除的列的名称 <column>。如果该列有任何数据库对象依赖于该列，例如引用该列的视图，则需要 CASCADE 关键字来删除该列。

    • ALTER [COLUMN] ... TYPE：更改列的数据类型。

      要执行此操作，你必须指定 <column> 和 <type>，其中 <column> 表示你要修改的列的名称，而 <type> 表示列的新数据类型。

    • OWNER TO：更改表的所有者。

      要执行此操作，你必须指定外部表的新所有者 <new_owner>。

  • [CASCADE | RESTRICT]

    与 DROP COLUMN 操作一起使用，用于指定当列存在依赖的数据库对象时是否继续删除列。CASCADE 会删除该列及其所有依赖对象，RESTRICT 会拒绝整个删除操作。默认值为 RESTRICT。

示例

从外部表 students 中删除列 age：

ALTER EXTERNAL TABLE students DROP COLUMN age;

将外部表 students 的所有者更改为 mary@example.com：

ALTER EXTERNAL TABLE students OWNER TO "mary@example.com";

SQL 标准兼容性

标准 SQL 或常规的 PostgreSQL 不支持 ALTER EXTERNAL TABLE。它是 MAXIR 扩展。

ABORTALTER FUNCTION