# ALTER TEXT SEARCH DICTIONARY
#### 功能描述
修改全文检索词典的相关定义，包括参数、名称、所有者以及模式等。
#### 注意事项
- 预定义词典不支持ALTER操作。
- 只有词典的所有者可以执行ALTER操作，系统管理员默认拥有此权限。
- 创建或修改词典之后，任何对于filepath路径下用户自定义的词典定义文件的修改，将不会影响到数据库中的词典。如果需要在数据库中使用这些修改，需使用ALTER TEXT SEARCH DICTIONARY语句更新对应词典的定义文件。
 
#### 语法格式
- 修改词典定义。
  ```
  ALTER TEXT SEARCH DICTIONARY name ( option = value | option [, ...] );
  ```
  

- 重命名词典。
  ```
  ALTER TEXT SEARCH DICTIONARY name RENAME TO new_name;
  ```
  
- 设置词典的所属模式。
  ```
  ALTER TEXT SEARCH DICTIONARY name SET SCHEMA new_schema;
  ```
  
- 修改词典的所属者。
  ```
  ALTER TEXT SEARCH DICTIONARY name OWNER TO new_owner;
  ```
  
 
#### 参数说明
表1ALTER TEXT SEARCH DICTIONARY参数说明 
| 参数         | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 取值范围                                                                                                                                                                                         |
|:---|:---|:---|
| name       | 需要修改的全文检索词典的名称，可以用模式修饰。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 有效的全文检索词典名。                                                                                                                                                                                  |
| option     | 要修改的全文检索词典特定选项的参数名称。与template对应，不同的词典类型具有不同的参数列表，且与指定顺序无关。 - 不支持修改词典的TEMPLATE参数值。  - 不支持仅修改FILEPATH参数而不修改对应的词典定义文件参数。  - 词典定义文件的文件名仅支持小写字母、数字、下划线混合。   | 详细参数说明请见[参数说明](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0183.html#ZH-CN_TOPIC_0000002343193909__zh-cn_topic_0000001811634845_s49eade590b0f4b098e648dd1dc5e3e60)中option参数。 |
| value      | 要修改的参数值。如果省略等号（=）和value，则表示删除该option的先前设置，使用默认值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 对应option定义。                                                                                                                                                                                  |
| new_name   | 全文检索词典的新名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 字符串，需符合[标识符命名规范](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0007.html#ZH-CN_TOPIC_0000002202094021__section1475018612353)。                                                  |
| new_owner  | 全文检索词典的新所有者。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 有效的用户名。                                                                                                                                                                                      |
| new_schema | 全文检索词典的新模式。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 有效的模式名。                                                                                                                                                                                      |
   
#### 示例
创建全文检索词典my_dict。
```
CREATE TEXT SEARCH DICTIONARY my_dict (
    TEMPLATE = snowball,
    Language = english,
    StopWords = english 
);
```
修改全文检索词典my_dict的Language参数，并删除停用词定义。
```
ALTER TEXT SEARCH DICTIONARY my_dict (Language = dutch,StopWords);
```
更新全文检索词典my_dict定义，实际不更改任何内容。
```
ALTER TEXT SEARCH DICTIONARY my_dict (dummy);
```
#### 相关链接
[CREATE TEXT SEARCH DICTIONARY](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0183.html)，[DROP TEXT SEARCH DICTIONARY](https://support.huaweicloud.com/sqlreference-911-dws/dws_06_0211.html)