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>

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

アクセス制御要件

権限	オブジェクト	備考
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";