Amazon Redshift パラメータグループ

Overview

でAmazon Redshift、パラメータグループを、作成した各クラスターに関連付けます。パラメータグループは、クラスター内に作成するすべてのデータベースに適用されるパラメータのグループです。これらのパラメータは、クエリのタイムアウトや日付スタイルなどのデータベース設定を構成します。

パラメータグループについて

各パラメータグループには、データベースの設定を定義する複数のパラメータがあります。使用できるパラメータのリストは、パラメータグループが属しているパラメータグループファミリーによって異なります。パラメータグループファミリーは、パラメータグループのパラメータが適用されるAmazon Redshiftエンジンのバージョンです。パラメータグループファミリー名の形式は です。 redshift-versionversion はエンジンバージョンです。たとえば、エンジンの現在のバージョンは です。redshift-1.0.

Amazon Redshift は、パラメータグループファミリーごとに 1 つのデフォルトパラメータグループを提供しています。デフォルトパラメータグループにはパラメータごとのプリセット値があり、これを変更することはできません。デフォルトのパラメータグループ名の形式は です。ここでdefault.parameter_group_family、parameter_group_family は、パラメータグループが属するエンジンのバージョンです。たとえば、redshift-1.0 バージョンのデフォルトパラメータグループの名前は default.redshift-1.0. です。

注記

現時点では、redshift-1.0 が Amazon Redshift エンジンの唯一のバージョンです。したがって、default.redshift-1.0 が唯一のデフォルトパラメータグループです。

デフォルトパラメータグループとは異なるパラメータ値を使用するには、カスタムパラメータグループを作成してクラスターを関連付ける必要があります。カスタムパラメータグループ内のパラメータ値は、最初はデフォルトパラメータグループ内のものと同じです。これらの値は source によってプリセットされているため、すべてのパラメータの最初の engine-default は Amazon Redshift. です。パラメータ値を変更した後、source は user に変わり、値がデフォルト値から変更されたことを示します。

注記

Amazon Redshift console には各パラメータの source は表示されません。Amazon Redshift AWS CLI を表示するには、 AWS SDKsAPI、、または のいずれかを使用する必要がありますsource。

ユーザーが作成したパラメータグループについては、パラメータ値はいつでも変更できます。またはすべてのパラメータ値をデフォルトにリセットすることもできます。また、異なるパラメータグループをクラスターに関連付けることもできます。場合によっては、クラスターに既に関連付けられているパラメータグループのパラメータ値を変更したり、別のパラメータグループをクラスターに関連付けたりすることもできます。このような場合、更新したパラメータ値を有効にするためにクラスターの再起動が必要になることがあります。クラスターに障害が発生し、Amazon Redshift により再起動された場合、変更内容はそのときに適用されます。メンテナンス中にクラスターが再起動された場合、変更は適用されません。詳細については、「 」を参照してください。WLM の動的プロパティと静的プロパティ.

デフォルトパラメータ値

次の表はデフォルトパラメータ値の一覧とともに、各パラメータの詳細な情報へのリンクを示しています。これらは redshift-1.0 パラメータグループファミリーのデフォルト値です。

パラメータ名	値	詳細情報
auto_analyze	true	の auto_analyze Amazon Redshift Database Developer Guide
datestyle	ISO, MDY	の「datestyle」 Amazon Redshift Database Developer Guide
enable_user_activity_logging	false	データベース監査ログ作成このガイドの「
extra_float_digits	0	の「extra_float_digits」 Amazon Redshift Database Developer Guide
max_concurrency_scaling_clusters	1	の「max_concurrency_scaling_clusters」 Amazon Redshift Database Developer Guide
query_group	デフォルト	の query_group Amazon Redshift Database Developer Guide
require_ssl	false	接続のセキュリティオプションを設定するこのガイドの「
search_path	$user, public	の search_path Amazon Redshift Database Developer Guide
statement_timeout	0	の statement_timeout Amazon Redshift Database Developer Guide
wlm_json_configuration	[{"auto_wlm":true}]	ワークロード管理の設定このガイドの「
use_fips_ssl	false	システムが FIPS に準拠する必要がある場合のみ、FIPS 準拠の SSL モードを有効にします。

注記

max_cursor_result_set_size パラメータは廃止されました。カーソル結果セットのサイズの詳細については、の「カーソルの制約」を参照してくださいAmazon Redshift Database Developer Guide。

データベースで SET コマンドを使用して一時的にパラメータを上書きすることもできます。SET コマンドは、現在のセッションの期間だけパラメータを上書きします。前の表で示されたパラメータに加えて、データベースで wlm_query_slot_count を設定することで、一時的にスロットカウントを調整することもできます。wlm_query_slot_count パラメータは、パラメータグループでの設定に使用することはできません。スロット数の調整の詳細については、の「wlm_query_slot_count」を参照してくださいAmazon Redshift Database Developer Guide。他のパラメータを一時的に上書きする方法の詳細については、『』の「サーバー設定https://docs.aws.amazon.com/redshift/latest/dg/t_Modifying_the_default_settings.htmlの変更」を参照してくださいAmazon Redshift Database Developer Guide。

によるパラメータ値を設定するAWS CLI

Amazon Redshift を使用して AWS CLI パラメータを設定するには、特定のパラメータグループの 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 コマンドを使用してパラメータを設定する方法を示しています。You specify (ユーザーが指定) 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

コンソールを使用してパラメータグループを管理できます。詳細については、「 」を参照してください。コンソールを使用したパラメータグループの管理.