ALTER FOREIGN TABLE
功能描述
对外表进行修改。
语法格式
1. GDS:
ALTER FOREIGN TABLE [ IF EXISTS ]
table_name
OPTIONS ( {[ ADD | SET | DROP ] option ['value']} [, ... ]);
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
OWNER TO new_owner;
2. HDFS:
ALTER FOREIGN TABLE [ IF EXISTS ]
table_name
OPTIONS ( {[ ADD | SET | DROP ] option ['value']} [, ... ]);
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
OWNER TO new_owner;
ALTER FOREIGN TABLE [ IF EXISTS ] table_name
MODIFY ( { column_name data_type | column_name [ CONSTRAINT
constraint_name ] NOT NULL [ ENABLE ] | column_name [ CONSTRAI
NT constraint_name ] NULL } [, ...] );
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
ADD [CONSTRAINT constraint_name]
{PRIMARY KEY | UNIQUE} (column_name)
[NOT ENFORCED [ENABLE QUERY OPTIMIZATION | DISABLE QUERY
OPTIMIZATION] | ENFORCED];
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
DROP CONSTRAINT constraint_name ;
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
699
action [, ... ];
where action can be:
ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type
|
ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL
|
ALTER [ COLUMN ] column_name SET STATISTICS
integer
|
ALTER [ COLUMN ] column_name OPTIONS ( {[ ADD | SET | DROP ] option
['value'] } [, ... ])
|
MODIFY column_name data_type
|
MODIFY column_name [ CONSTRAINT constraint_name ] NOT NULL [ ENABLE ]
|
MODIFY column_name [ CONSTRAINT constraint_name ] NULL
3. OBS:
ALTER FOREIGN TABLE [ IF EXISTS ]
table_name
OPTIONS ( {[ ADD | SET | DROP ] option ['value']} [, ... ]);
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
OWNER TO new_owner;
ALTER FOREIGN TABLE [ IF EXISTS ] table_name
MODIFY ( { column_name data_type | column_name [ CONSTRAINT
constraint_name ] NOT NULL [ ENABLE ] | column_name [ CONSTRAI
NT constraint_name ] NULL } [, ...] );
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
ADD [CONSTRAINT constraint_name]
{PRIMARY KEY | UNIQUE} (column_name)
[NOT ENFORCED [ENABLE QUERY OPTIMIZATION | DISABLE QUERY
OPTIMIZATION] | ENFORCED];
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
DROP CONSTRAINT constraint_name ;
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
700
action [, ... ];
where action can be:
ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type
|
ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL
|
ALTER [ COLUMN ] column_name SET STATISTICS
integer
|
ALTER [ COLUMN ] column_name OPTIONS ( {[ ADD | SET | DROP ] option
['value'] } [, ... ])
|
MODIFY column_name data_type
|
MODIFY column_name [ CONSTRAINT constraint_name ] NOT NULL [ ENABLE ]
|
MODIFY column_name [ CONSTRAINT constraint_name ] NULL
4. GC:
ALTER FOREIGN TABLE [ IF EXISTS ]
tablename
OPTIONS ( {[ SET ] option ['value']} [, ... ]);
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
OWNER TO new_owner;
ALTER FOREIGN TABLE [ IF EXISTS ] table_name
MODIFY ( { column_name data_type [, ...] );
ALTER FOREIGN TABLE [ IF EXISTS ] tablename
action [, ... ];
where action can be:
ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type
|
MODIFY column_name data_type
参数说明
table_name
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
701
需要修改的外表名称。
取值范围：已存在的外表名。
option
改变外表或者外表字段的选项。ADD、SET 和DROP 指定执行的操作。如果没有显式
设置，那么默认为ADD。选项的名字不允许重复（尽管表选项和表字段选项可以有相同的
名字）
。选项的名称和值也会通过外部数据封装器的类库进行校验。
oracle_fdw 支持的options 包括：
table
oracle server 侧的表名。需要同oracle 系统表中记录的表名完全一致，通常是由大
写字符组成。
schema
表所对应的schema（或owner）
。需要与oracle 系统表中记录的表名完全一致，通
常是由大写字符组成。
mysql_fdw 支持的options 包括：
dbname
MySQL 的database 名称。
table_name
MySQL 侧的表名。
postgres_fdw 支持的options 包括：
schema_name
远端server 的schema 名称。
如果不指定的话，
将使用外表自身的schema 名称作为
远端的schema 名称。
table_name
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
702
远端server 的表名。如果不指定的话，将使用外表自身的表名作为远端的表名。
column_name
远端server 的表的列名。
如果不指定的话，
将使用外表自身的列名作为远端的的表
的列名。
file_fdw 支持的options 包括：
filename
指定要读取的文件，必需的参数，且必须是一个绝对路径名。
format
远端server 的文件格式，支持text/csv/binary/fixed 四种格式，和COPY 语句的
FORMAT 选项相同。
header
指定的文件是否有标题行，与COPY 语句的HEADER 选项相同。
delimiter
指定文件的分隔符，与COPY 的DELIMITER 选项相同。
quote
指定文件的引用字符，与COPY 的QUOTE 选项相同。
escape
指定文件的转义字符，与COPY 的ESCAPE 选项相同。
null
指定文件的null 字符串，与COPY 的NULL 选项相同。
encoding
指定文件的编码，与COPY 的ENCODING 选项相同。
force_not_null
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
703
这是一个布尔选项。如果为真，则声明字段的值不应该匹配空字符串（也就是，文
件级别null 选项）
。与COPY 的FORCE_NOT_NULL 选项里的字段相同。
说明：file_fdw 更多使用请参见file_fdw。
value
option 的新值。
相关命令
CREATE FOREIGN TABLE，DROP FOREIGN TABLE