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>

需要刷新的 catalog 的名字

2. [<catalog_name>.]<database_name>

需要刷新的 catalog 里面 database 的名字

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

需要刷新的 catalog 里面 table 的名字

权限控制

权限（Privilege）	对象（Object）	说明（Notes）
ADMIN_PRIV / SELECT_PRIV / LOAD_PRIV / ALTER_PRIV / CREATE_PRIV / SHOW_VIEW_PRIV / DROP_PRIV	Catalog	需要有上述权限中的一种就可以

注意事项

刷新 Catalog 的同时，会强制使对象相关的 Cache 失效。 包括 Partition 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;