跳到主要内容

ALTER CATALOG

描述

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

  1. 重命名数据目录
ALTER CATALOG catalog_name RENAME new_catalog_name;

注意:

  • internal 是内置数据目录,不允许重命名
  • catalog_name 拥有 Alter 权限才允许对其重命名
  • 重命名数据目录后,如需要,请使用 REVOKE 和 GRANT 命令修改相应的用户权限。
  1. 设置数据目录属性
ALTER CATALOG catalog_name SET PROPERTIES ('key1' = 'value1' [, 'key' = 'value2']); 

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

注意:

  • 不可更改数据目录类型,即 type 属性
  • 不可更改内置数据目录 internal 的属性
  1. 修改数据目录注释
ALTER CATALOG catalog_name MODIFY COMMENT "new catalog comment";

注意:

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

示例

  1. 将数据目录 ctlg_hive 重命名为 hive
ALTER CATALOG ctlg_hive RENAME hive;
  1. 更新名为 hive 数据目录的属性 hive.metastore.uris
ALTER CATALOG hive SET PROPERTIES ('hive.metastore.uris'='thrift://172.21.0.1:9083');
  1. 更改名为 hive 数据目录的注释
ALTER CATALOG hive MODIFY COMMENT "new catalog comment";

关键词

ALTER,CATALOG,RENAME,PROPERTY

最佳实践