REFRESH EXTERNAL TABLE

外部テーブルのリフレッシュ

説明

StarRocksにキャッシュされているHiveとHudiのメタデータを更新します。この文は以下のシナリオで使用されます：

• 外部テーブル：Hive外部テーブルまたはHudi外部テーブルを使用してApache Hive™またはApache Hudiでデータをクエリする場合、この文を実行してStarRocksにキャッシュされたHiveテーブルまたはHudiテーブルのメタデータを更新できます。
• 外部カタログ：HiveカタログまたはHudiカタログを使用してHiveまたはHudiでデータをクエリする場合、この文を実行してStarRocksにキャッシュされたHiveテーブルまたはHudiテーブルのメタデータを更新できます。

基本的な概念

• Hive外部テーブル：StarRocksに作成されて保存されるテーブルであり、Hiveデータをクエリするために使用できます。
• Hudi外部テーブル：StarRocksに作成されて保存されるテーブルであり、Hudiデータをクエリするために使用できます。
• Hiveテーブル：Hiveに作成されて保存されるテーブルです。
• Hudiテーブル：Hudiに作成されて保存されるテーブルです。

構文とパラメータ

以下では、異なる場合に基づいて構文とパラメータを説明します：

• 外部テーブル

  REFRESH EXTERNAL TABLE table_name 
  [PARTITION ('partition_name', ...)]

  パラメータ	必須	説明
  table_name	Yes	Hive外部テーブルまたはHudi外部テーブルの名前。
  partition_name	No	HiveテーブルまたはHudiテーブルのパーティションの名前。このパラメータを指定すると、StarRocksにキャッシュされたHiveテーブルおよびHudiテーブルのパーティションのメタデータが更新されます。

• 外部カタログ

  REFRESH EXTERNAL TABLE [external_catalog.][db_name.]table_name
  [PARTITION ('partition_name', ...)]

  パラメータ	必須	説明
  external_catalog	No	HiveカタログまたはHudiカタログの名前。
  db_name	No	HiveテーブルまたはHudiテーブルが存在するデータベースの名前。
  table_name	Yes	HiveテーブルまたはHudiテーブルの名前。
  partition_name	No	HiveテーブルまたはHudiテーブルのパーティションの名前。このパラメータを指定すると、StarRocksにキャッシュされたHiveテーブルおよびHudiテーブルのパーティションのメタデータが更新されます。

使用上の注意事項

HiveテーブルとHudiテーブルのメタデータをStarRocksにキャッシュされているメタデータを更新するには、ALTER_PRIV権限を持つユーザーのみがこの文を実行できます。

例

さまざまなケースでの使用例は次のとおりです：

外部テーブル

例1：外部テーブル hive1 を指定してStarRocksにキャッシュされた対応するHiveテーブルのメタデータを更新します。

REFRESH EXTERNAL TABLE hive1;

例2：外部テーブル hudi1 と対応するHudiテーブルのパーティションを指定して、StarRocksにキャッシュされたパーティションのメタデータを更新します。

REFRESH EXTERNAL TABLE hudi1
PARTITION ('date=2022-12-20', 'date=2022-12-21');

外部カタログ

例1：StarRocksのhive_table のキャッシュされたメタデータを更新します。

REFRESH EXTERNAL TABLE hive_catalog.hive_db.hive_table;

または

USE hive_catalog.hive_db;
REFRESH EXTERNAL TABLE hive_table;

例2：StarRocksのhudi_table のパーティションのキャッシュされたメタデータを更新します。

REFRESH EXTERNAL TABLE hudi_catalog.hudi_db.hudi_table
PARTITION ('date=2022-12-20', 'date=2022-12-21');