メインコンテンツまでスキップ
に最終更新

WARM UP

説明​

WARM UP COMPUTE GROUP ステートメントは、クエリ パフォーマンスを向上させるために、コンピュートグループ内のデータをウォームアップするために使用されます。ウォームアップ操作では、別のコンピュートグループからリソースを取得するか、ウォームアップ対象として特定のテーブルやパーティションを指定できます。ウォームアップ操作はジョブ ID を返します。この ID を使用してウォームアップジョブのステータスを追跡できます。

Catalog クエリシナリオでキャッシュをウォームアップする方法については、Data Cache ドキュメントを参照してください。

構文​

WARM UP COMPUTE GROUP <destination_compute_group_name> WITH COMPUTE GROUP <source_compute_group_name> FORCE;
WARM UP COMPUTE GROUP <destination_compute_group_name> WITH <warm_up_list>;
warm_up_list ::= warm_up_item [AND warm_up_item...];
warm_up_item ::= TABLE <table_name> [PARTITION <partition_name>];

パラメータ​

パラメータ名説明
destination_compute_group_nameウォームアップする対象コンピュートグループの名前。
source_compute_group_nameリソースを取得するソースコンピュートグループの名前。
warm_up_listウォームアップする特定の項目のリスト。テーブルとパーティションを含めることができます。
table_nameウォームアップに使用するテーブルの名前。
partition_nameウォームアップに使用するパーティションの名前。

戻り値​

  • JobId: ウォームアップジョブの ID。

アクセス制御要件​

4.1.5 以降、ウォームアップには宛先 Compute Group に対する USAGE 権限が必要で、ソース Compute Group を指定する場合はソース Compute Group に対する USAGE 権限も必要です。WITH TABLE で明示的に指定した各内部テーブルには SELECT 権限が必要です。ON TABLES ルールを使用するイベント駆動のウォームアップには、グローバル ADMIN 権限も必要です。必要な権限が不足している場合、操作は拒否されます。

例​

  1. source_group_name という名前のコンピュートグループを使用して、destination_group_name という名前のコンピュートグループをウォームアップします。
   WARM UP COMPUTE GROUP destination_group_name WITH COMPUTE GROUP source_group_name;
  1. destination_group という名前のコンピュートグループを使用して、テーブル sales_data と customer_info、およびテーブル orders のパーティション q1_2024 をウォームアップします。
    WARM UP COMPUTE GROUP destination_group WITH
TABLE sales_data
AND TABLE customer_info
AND TABLE orders PARTITION q1_2024;