ALTER-CATALOG

ALTER-CATALOG

Name

提示

该功能自 Apache Doris 1.2 版本起支持

ALTER CATALOG

Description

该语句用于设置指定数据目录的属性。（仅管理员使用）

1) 重命名数据目录

ALTER CATALOG catalog_name RENAME new_catalog_name;

注意：

• internal 是内置数据目录，不允许重命名
• 对 catalog_name 拥有 Alter 权限才允许对其重命名
• 重命名数据目录后，如需要，请使用 REVOKE 和 GRANT 命令修改相应的用户权限。

2) 设置数据目录属性

ALTER CATALOG catalog_name SET PROPERTIES ('key1' = 'value1' [, 'key' = 'value2']); 

更新指定属性的值为指定的 value。如果 SET PROPERTIES 从句中的 key 在指定 catalog 属性中不存在，则新增此 key。

注意：

• 不可更改数据目录类型，即 type 属性
• 不可更改内置数据目录 internal 的属性

3) 修改数据目录注释

ALTER CATALOG catalog_name MODIFY COMMENT "new catalog comment";

注意：

• internal 是内置数据目录，不允许修改注释

Example

1. 将数据目录 ctlg_hive 重命名为 hive

ALTER CATALOG ctlg_hive RENAME hive;

3. 更新名为 hive 数据目录的属性 hive.metastore.uris

ALTER CATALOG hive SET PROPERTIES ('hive.metastore.uris'='thrift://172.21.0.1:9083');

4. 更改名为 hive 数据目录的注释

ALTER CATALOG hive MODIFY COMMENT "new catalog comment";

Keywords

ALTER,CATALOG,RENAME,PROPERTY

Best Practice