REFRESH

概要

このステートメントは、指定されたCatalog/Database/Tableのメタデータを更新します。

構文

REFRESH CATALOG <catalog_name>;
REFRESH DATABASE [<catalog_name>.]<database_name>;
REFRESH TABLE [[<catalog_name>.]<database_name>.]<table_name>;

必須パラメータ

1. <catalog_name>

リフレッシュが必要なカタログの名前。

2. [<catalog_name>.]<database_name>

リフレッシュが必要なカタログ内のデータベースの名前。

3. [[<catalog_name>.]<database_name>.]<table_name>

リフレッシュが必要なカタログ内のTableの名前。

アクセス制御要件

権限	オブジェクト	注記
ADMIN_PRIV / SELECT_PRIV / LOAD_PRIV / ALTER_PRIV / CREATE_PRIV / SHOW_VIEW_PRIV / DROP_PRIV	カタログ	上記のいずれかの権限が必要です。

使用上の注意

Catalogがリフレッシュされると、オブジェクト関連のCacheが強制的に無効化されます。パーティション Cache、Schema Cache、File Cacheなどが含まれます。

例

1. hive catalogをリフレッシュ

   REFRESH CATALOG hive;

2. database1を更新する

   REFRESH DATABASE ctl.database1;
   REFRESH DATABASE database1;

3. table1を更新する

   REFRESH TABLE ctl.db.table1;
   REFRESH TABLE db.table1;
   REFRESH TABLE table1;