Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。

# パラメータグループを変更する
<a name="parameter-group-modify"></a>

任意のパラメータグループを表示して、パラメータおよびワークロード管理 (WLM) の設定の値の概要を確認することができます。パラメータを変更してパラメータ設定や WLM 設定プロパティを変更できます。

**注記**  
デフォルトのパラメータグループを変更することはできません。

------
#### [ AWS マネジメントコンソール ]

コンソールでは、グループパラメータは **[パラメータ]** タブに表示され、**[ワークロードキュー]** は **[ワークロード管理]** タブに表示されます。

**パラメータグループを変更するには**

1. AWS マネジメントコンソール にサインインして、[https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/) で Amazon Redshift コンソールを開きます。

1. ナビゲーションメニューで、**[Configurations]** (設定) を選択し、次に **[Workload management]** (ワークロード管理) を選択して **[Workload management]** (ワークロード管理) ページを表示します。

1. 変更するパラメータグループを選択して、[**パラメータ**] と [**ワークロード管理**] タブのある詳細ページを表示します。

1. [**パラメータ**] タブを選択して、現在のパラメータ設定を表示します。

1. [**パラメータの編集**] を選択して、次のパラメータの設定変更を有効化します。
   + `auto_analyze`
   + `auto_mv`
   + `datestyle`
   + `enable_case_sensitive_identifier`
   + `enable_user_activity_logging`
   + `extra_float_digits`
   + `max_concurrency_scaling_clusters`
   + `max_cursor_result_set_size`
   + `query_group`
   + `require_ssl`
   + `search_path`
   + `statement_timeout`
   + `use_fips_ssl`

   これらのパラメータの詳細については、[Amazon Redshift パラメータグループを作成します。](working-with-parameter-groups.md)を参照してください。

1. 変更を入力して [**保存**] を選択し、パラメータグループを更新します。

**パラメータグループの WLM 設定を変更するには**

1. AWS マネジメントコンソール にサインインして、[https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/) で Amazon Redshift コンソールを開きます。

1. ナビゲーションメニューで、**[Configurations]** (設定) を選択し、次に **[Workload management]** (ワークロード管理) を選択して **[Workload management]** (ワークロード管理) ページを表示します。

1. 変更するパラメータグループを選択して、[**パラメータ**] と [**ワークロード管理**] タブのある詳細ページを表示します。

1. [**ワークロード管理**] タブを選択して現行の WLM 設定を表示します。

1. **[ワークロードキューの編集]** を選択して、WLM 設定を編集します。

1. (オプション) [**Enable short query acceleration (ショートクエリアクセラレーションの有効化)**] を選択して、ショートクエリアクセラレーション (SQA) を有効にします。

   SQA を有効にした場合、[**ショートクエリの最大実行時間 (1～20 秒)**] は、デフォルトで [**動的**] に設定されます。最大実行時間を固定値に設定するには、値 1 20 を選択します。

1. キュー設定を変更するには、次の 1 つ以上の操作を行います: 
   + [**Switch WLM mode (WLM モードの切り替え)**] を選択し、[**Automatic WLM (自動 WLM)**] と [**Manual WLM (手動 WLM)**] の間で切り替えます。

     [**Automatic WLM (自動 WLM)**] では、[**メモリ**] と [**Concurrency on main (メインでの同時実行数)**] の値が [**auto (自動)**] に設定されます。
   + キューを作成するには、[**Edit workload queues (ワークロードキューの編集)**] を選択してから、[**Add Queue (キューの追加)**] を選択します。
   + キューを変更するには、テーブルのプロパティ値を変更します。キューのタイプに応じて、プロパティには以下が含まれます。
     + **キュー名**は変更できます。
     + **メモリ**
     + **メインクラスターでの同時実行数**
     + **Concurrency scaling mode (同時実行スケーリングモード)** (**off** または **auto**)
     + **タイムアウト (ms)**
     + **ユーザーグループ**
     + **クエリグループ**
     + **ユーザーロール**

     これらのプロパティの詳細については、「[WLM 設定パラメータのプロパティ](workload-mgmt-config.md#wlm-json-config-properties)」を参照してください。
**重要**  
キュー名を変更すると、WLM キューメトリクスの `QueueName` ディメンションの値 (WLMQueueLength、WLMQueueWaitTime、WLMQueriesCompletedPerSecond、WLMQueryDuration、WLMRunningQueries など) も変更されます。そのため、キュー名を変更する場合は、設定した CloudWatch のアラームを変更する必要がある場合があります。
   + キューの順序を変更するには、**上** および**下**の矢印ボタンを選択します。
   + キューを削除するには、テーブル内にあるキューの行の [**削除**] ボタンを選択します。

1. (オプション) [**再起動するまで動的な変更を延期する**] を選択して、次の再起動後に関連付けられたクラスターに変更を適用します。
**注記**  
一部の変更では、この設定に関係なくクラスターの再起動が必要となります。詳細については、[WLM の動的プロパティと静的プロパティ](workload-mgmt-config.md#wlm-dynamic-and-static-properties) を参照してください。

1. **[保存]** を選択します。

------
#### [ AWS CLI ]

 AWS CLI を使用して Amazon Redshift パラメータを設定するには、特定のパラメータグループに対して [modify-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/redshift/modify-cluster-parameter-group.html) コマンドを使用します。`parameter-group-name` で、変更するパラメータグループを指定します。`parameters` パラメータ (`modify-cluster-parameter-group` コマンドのパラメータ) を使用して、パラメータグループで変更する各パラメータの名前と値のペアを指定します。

**注記**  
`wlm_json_configuration` を使用して AWS CLI パラメータを設定する際は、特別な考慮事項があります。このセクションの例は、`wlm_json_configuration` を除くすべてのパラメータに適用されます。`wlm_json_configuration` による AWS CLI の設定の詳細については、「[ワークロード管理](workload-mgmt-config.md)」を参照してください。

パラメータ値を変更した後は、変更したパラメータグループに関連付けられているクラスターを再起動する必要があります。値が適用中の間、`applying` のクラスター状態は `ParameterApplyStatus` と表示され、値の適用が完了すると `pending-reboot` になります。再起動後、クラスター内のデータベースは新しいパラメータ値の使用を開始します。クラスターの再起動の詳細については、「[クラスターの再起動](reboot-cluster.md)」を参照してください。

**注記**  
`wlm_json_configuration` パラメータに含まれる一部のプロパティは動的プロパティであり、関連付けられたクラスターを再起動しなくても変更が適用されます。動的プロパティと静的プロパティの詳細については、「[WLM の動的プロパティと静的プロパティ](workload-mgmt-config.md#wlm-dynamic-and-static-properties)」を参照してください。

 次の構文は、`modify-cluster-parameter-group` コマンドを使用してパラメータを設定する方法を示しています。*parameter\$1group\$1name* を指定し、*parameter\$1name* と *parameter\$1value* の両方を実際に設定するパラメータとパラメータ値に置き換えます。複数のパラメータを同時に変更する場合は、パラメータと値の各セットをスペースで区切ります。

```
aws redshift modify-cluster-parameter-group --parameter-group-name parameter_group_name --parameters ParameterName=parameter_name,ParameterValue=parameter_value
```

 次の例は、`statement_timeout` パラメータグループの `enable_user_activity_logging` パラメータと `myclusterparametergroup` パラメータを設定する方法を示しています。

**注記**  
 読みやすくするため、例は複数行で表示されていますが、実際の AWS CLI では 1 行になります。

```
aws redshift modify-cluster-parameter-group 
--parameter-group-name myclusterparametergroup 
--parameters ParameterName=statement_timeout,ParameterValue=20000 ParameterName=enable_user_activity_logging,ParameterValue=true
```

------