ALTER CATALOG

説明

このステートメントは、指定されたカタログのプロパティを設定するために使用されます。

構文

1. カタログの名前を変更する

   ALTER CATALOG <catalog_name> RENAME <new_catalog_name>;

2. カタログのプロパティを変更 / 追加する

   ALTER CATALOG <catalog_name> SET PROPERTIES ('<key>' = '<value>' [, ... ]);  

3. カタログのコメントを変更する

   ALTER CATALOG <catalog_name> MODIFY COMMENT "<new catalog comment>";

必須パラメータ

1. <catalog_name>

変更されるべきカタログの名前

2. <new_catalog_name>

変更後の新しいカタログ名

3. '<key>' = '<value>'

変更/追加が必要なカタログプロパティのキーと値

4. <new catalog comment>

変更されたカタログコメント

アクセス制御要件

Privilege	Object	注釈
ALTER_PRIV	カタログ	カタログのALTER_PRIVが必要

使用上の注意

1. カタログの名前変更

• 組み込みカタログinternalは名前変更できません
• 最低でもAlter権限を持つユーザーのみがカタログの名前を変更できます
• カタログの名前変更後、REVOKEとGRANTコマンドを使用して適切なユーザー権限を変更してください

2. カタログのプロパティの変更/追加

• プロパティtypeは変更できません。
• 組み込みカタログinternalのプロパティは変更できません。
• 指定されたキーの値を更新します。キーがカタログプロパティに存在しない場合は、追加されます。

3. カタログのコメントの変更

• 組み込みカタログinternalは変更できません

例

1. カタログctlg_hiveをhiveに名前変更

   ALTER CATALOG ctlg_hive RENAME hive;

2. catalog hive の hive.metastore.uris プロパティを変更する

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

3. catalog hiveのコメントを変更する

   ALTER CATALOG hive MODIFY COMMENT "new catalog comment";