REFRESH EXTERNAL TABLE

説明

StarRocks にキャッシュされた Hive と Hudi のメタデータを更新します。このステートメントは、次のいずれかのシナリオで使用されます。

• 外部テーブル: Apache Hive™ または Apache Hudi のデータをクエリするために Hive 外部テーブルまたは Hudi 外部テーブルを使用する場合、StarRocks にキャッシュされた Hive テーブルまたは Hudi テーブルのメタデータを更新するためにこのステートメントを実行できます。
• 外部カタログ: Hive または Hudi のデータをクエリするために Hive catalog または Hudi catalog を使用する場合、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 catalog または Hudi catalog の名前。
  db_name	No	Hive テーブルまたは Hudi テーブルが存在するデータベースの名前。
  table_name	Yes	Hive テーブルまたは Hudi テーブルの名前。
  partition_name	No	Hive テーブルまたは Hudi テーブルのパーティションの名前。このパラメータを指定すると、StarRocks にキャッシュされた Hive テーブルおよび Hudi テーブルのパーティションのメタデータが更新されます。

使用上の注意

ALTER_PRIV 権限を持つユーザーのみが、このステートメントを実行して StarRocks にキャッシュされた Hive テーブルおよび Hudi テーブルのメタデータを更新できます。

例

異なるケースでの使用例は次のとおりです。

外部テーブル

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

REFRESH EXTERNAL TABLE hive1;

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

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');