パラメータグループを変更する - Amazon Redshift

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

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

注記

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

AWS Management Console

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

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

  1. AWS Management Console にサインインして、 https://console.aws.amazon.com/redshiftv2/で Amazon Redshift コンソールを開きます。

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

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

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

  5. [パラメータの編集] を選択して、次のパラメータの設定変更を有効化します。

    • 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 パラメータグループを作成します。を参照してください。

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

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

  1. AWS Management Console にサインインして、 https://console.aws.amazon.com/redshiftv2/で Amazon Redshift コンソールを開きます。

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

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

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

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

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

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

  7. キュー設定を変更するには、次の 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 設定パラメータのプロパティ」を参照してください。

      重要

      キュー名を変更すると、WLM キューメトリクスの QueueName ディメンションの値 (WLMQueueLength、WLMQueueWaitTime、WLMQueriesCompletedPerSecond、WLMQueryDuration、WLMRunningQueries など) も変更されます。そのため、キュー名を変更する場合は、設定した CloudWatch のアラームを変更する必要がある場合があります。

    • キューの順序を変更するには、上 および下の矢印ボタンを選択します。

    • キューを削除するには、テーブル内にあるキューの行の [削除] ボタンを選択します。

  8. (オプション) [再起動するまで動的な変更を延期する] を選択して、次の再起動後に関連付けられたクラスターに変更を適用します。

    注記

    一部の変更では、この設定に関係なくクラスターの再起動が必要となります。詳細については、WLM の動的プロパティと静的プロパティ を参照してください。

  9. [Save] を選択します。

AWS CLI

AWS CLI を使用して Amazon Redshift パラメータを設定するには、特定のパラメータグループに対して modify-cluster-parameter-group コマンドを使用します。parameter-group-name で、変更するパラメータグループを指定します。parameters パラメータ (modify-cluster-parameter-group コマンドのパラメータ) を使用して、パラメータグループで変更する各パラメータの名前と値のペアを指定します。

注記

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

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

注記

wlm_json_configuration パラメータに含まれる一部のプロパティは動的プロパティであり、関連付けられたクラスターを再起動しなくても変更が適用されます。動的プロパティと静的プロパティの詳細については、「WLM の動的プロパティと静的プロパティ」を参照してください。

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

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