# ALTER FOREIGN DATA WRAPPER
#### 功能描述
修改外部数据封装的属性。
#### 注意事项
- 只有初始用户和系统管理员用户能够修改外部数据封装。
- 只有在support_extended_features=on时才能够成功执行ALTER语句。
 
#### 语法格式
设置外部数据封装属性
```
ALTER FOREIGN DATA WRAPPER name
[ HANDLER handler_function | NO HANDLER ]
[ VALIDATOR validator_function | NO VALIDATOR ]
[ OPTIONS ( { [ ADD | SET | DROP ] option ['value'] } [, ... ]) ];
```
#### 参数说明
- **name**
  已有外部数据封装的名称。
  

- **HANDLER handler_function**
  为外部数据封装指定一个新的处理函数。
  

- **NO HANDLER**
  用于指定外部数据封装不再拥有处理函数。
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  使用外部数据封装但没有handler的外表不能访问。
  

- **VALIDATOR validator_function**
  为外部数据封装指定一个新的验证函数。
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  根据新的验证器，外部数据封装器或依赖的服务器、用户映射或外部表的已经存在的选项是有可能是无效的。用户在使用外部数据封装之前需要保证这些选项是正确的。不过，ALTER FOREIGN DATA WRAPPER命令中指定的任何选项都将使用新的验证函数检查。
  

- **NO VALIDATOR**
  用于指定外部数据封装不再拥有验证函数。
  

- **OPTIONS ( \[ ADD \| SET \| DROP \] option \['value'\] \[, ... \] )**
  修改外部数据封装的选项，选项名需满足唯一约束。ADD、SET和DROP为指定执行的操作，如果未指定，默认为ADD。使用外部数据封装验证函数时，名称和取值也会被验证。
  
 
#### 示例
```
--创建一个外部数据封装dbi。
gaussdb=# CREATE FOREIGN DATA WRAPPER dbi OPTIONS (bar 'true');
--修改一个外部数据封装dbi，增加选项foo，删除bar。
gaussdb=# ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP 'bar');
--修改外部数据封装dbi验证器为file_fdw_validator。
gaussdb=# ALTER FOREIGN DATA WRAPPER dbi VALIDATOR file_fdw_validator;
--修改外部数据封装dbi处理函数为file_fdw_handler。
gaussdb=# ALTER FOREIGN DATA WRAPPER dbi HANDLER file_fdw_handler;
--删除外部数据封装dbi。（前置条件：需确认GUC参数support_extended_features=on）
gaussdb=# DROP FOREIGN DATA WRAPPER dbi;
```
#### 相关链接
[CREATE FOREIGN DATA WRAPPER](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0252.html)，[DROP FOREIGN DATA WRAPPER](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0309.html)
