# ALTER FOREIGN TABLE (GDS导入导出)
#### 功能描述
对GDS外表进行修改。
#### 注意事项
无。
#### 语法格式
- 设置外表属性。
  ```
  ALTER FOREIGN TABLE [ IF EXISTS ]  table_name
      OPTIONS ( {[ ADD | SET | DROP ] option ['value']}[, ... ]);
  ```
  
- 设置外表新的所有者。
  ```
  ALTER FOREIGN TABLE [ IF EXISTS ] tablename
      OWNER TO new_owner;
  ```
  
 
- 设置外表行级访问控制开关（9.1.0及以上集群版本支持）。
  ```
  ALTER FOREIGN TABLE [ IF EXISTS ] tablename
          ENABLE | DISABLE | FORCE | NO FORCE ROW LEVEL SECURITY
  ```
  
#### 参数说明
表1ALTER FOREIGN TABLE (GDS导入导出)参数说明 
| 参数            | 描述                           | 取值范围                                                                                                                                                               |
|:---|:---|:---|
| IF EXISTS   | 如果指定的索引不存在时返回一个提示而不是错误。     | -                                                                                                                                                                  |
| table_name | 需要修改的外表名称。                   | 已存在的外表名。                                                                                                                                                           |
| option       | 需要修改的option名称。               | 请参见CREATE FOREIGN TABLE的[参数说明](https://support.huaweicloud.com/sqlreference-dws/dws_06_0159.html#ZH-CN_TOPIC_0000001811634553__s949bbfb7d67e4891ac3744b6ecf3bb2a)。 |
| value       | option的新值。                    | -                                                                                                                                                                  |
| new_owner      | 外表的新所有者。 | 字符串，有效的用户名。                                                                                                                                                         |
   
#### 示例
创建外表customer_ft，用来以TEXT格式导入GDS服务器10.10.123.234上的数据：
```
DROP FOREIGN TABLE IF EXISTS customer_ft;
CREATE FOREIGN TABLE customer_ft
(
    c_customer_sk             integer               ,
    c_customer_id             char(16)              ,
    c_current_cdemo_sk        integer               ,
    c_current_hdemo_sk        integer               ,
    c_current_addr_sk         integer               ,
    c_first_shipto_date_sk    integer               ,
    c_first_sales_date_sk     integer               ,
    c_salutation              char(10)              ,
    c_first_name              char(20)              ,
    c_last_name               char(30)              ,
    c_preferred_cust_flag     char(1)               ,
    c_birth_day               integer               ,
    c_birth_month             integer               ,
    c_birth_year              integer                       ,
    c_birth_country           varchar(20)                   ,
    c_login                   char(13)                      ,
    c_email_address           char(50)                      ,
    c_last_review_date        char(10)
)
    SERVER gsmpp_server
    OPTIONS
(
    location 'gsfs://10.10.123.234:5000/customer1*.dat',
    FORMAT 'TEXT' ,
    DELIMITER '|',
    encoding 'utf8',
    mode 'Normal')READ ONLY;
```
修改外表customer_ft属性，删除mode选项：
```
ALTER FOREIGN TABLE customer_ft options(drop mode);
```
#### 相关链接
[CREATE FOREIGN TABLE (GDS导入导出)](https://support.huaweicloud.com/sqlreference-dws/dws_06_0159.html)，[DROP FOREIGN TABLE](https://support.huaweicloud.com/sqlreference-dws/dws_06_0192.html)