CHANGE_QUERY_PRIORITY - Amazon Redshift
構文引数戻り型例

Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

CHANGE_QUERY_PRIORITY

CHANGE_QUERY_PRIORITY を使用すると、スーパーユーザーは、ワークロード管理 (WLM) で実行中または待機中のクエリの優先度を変更できます。

この機能により、スーパーユーザーはシステム内のクエリの優先度をすぐに変更することができます。優先度 CRITICAL で実行できるクエリ、ユーザー、またはセッションは 1 つのみです。

構文

CHANGE_QUERY_PRIORITY(query_id, priority)

引数

query_id

優先度が変更されたクエリのクエリ識別子。INTEGER 値は必須です。

優先度

クエリに割り当てる新しい優先度。引数は、値 CRITICAL、HIGHEST、HIGH、NORMAL、LOW、または LOWEST を含む文字列である必要があります。

戻り型

なし

例

STV_WLM_QUERY_STATE システムテーブルの query_priority 列を示すには、次の例を使用します。

SELECT query, service_class, query_priority, state 
FROM stv_wlm_query_state WHERE service_class = 101;

+-------+---------------+----------------+---------+
| query | service_class | query_priority |  state  |
+-------+---------------+----------------+---------+
|  1076 |           101 | Lowest         | Running |
|  1075 |           101 | Lowest         | Running |
+-------+---------------+----------------+---------+

スーパーユーザーが change_query_priority 関数を実行して優先度を CRITICAL に変更した結果を示すには、次の例を使用します。

SELECT CHANGE_QUERY_PRIORITY(1076, 'Critical');
            
+-------------------------------------------------------------------------------+
|                             change_query_priority                             |
+-------------------------------------------------------------------------------+
| Succeeded to change query priority. Priority changed from Lowest to Critical. |
+-------------------------------------------------------------------------------+