Amazon Redshift parameter groups

Overview

In Amazon Redshift, you associate a parameter group with each cluster that you create. A parameter group is a group of parameters that apply to all of the databases that you create in the cluster. These parameters configure database settings such as query timeout and date style.

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

各パラメータグループには、データベースの設定を定義する複数のパラメータがあります。使用できるパラメータのリストは、パラメータグループが属しているパラメータグループファミリーによって異なります。The parameter group family is the version of the Amazon Redshift engine to which the parameters in the parameter group apply. The format of the parameter group family name is redshift-version where version is the engine version. たとえば、エンジンの現在のバージョンは redshift-1.0 です。

Amazon Redshift provides one default parameter group for each parameter group family. デフォルトパラメータグループにはパラメータごとのプリセット値があり、これを変更することはできません。The format of the default parameter group name is default.parameter_group_family, where parameter_group_family is the version of the engine to which the parameter group belongs. たとえば、redshift-1.0 バージョンのデフォルトパラメータグループの名前は default.redshift-1.0 です。

注記

At this time, redshift-1.0 is the only version of the Amazon Redshift engine. したがって、default.redshift-1.0 が唯一のデフォルトパラメータグループです。

デフォルトパラメータグループとは異なるパラメータ値を使用するには、カスタムパラメータグループを作成してクラスターを関連付ける必要があります。カスタムパラメータグループ内のパラメータ値は、最初はデフォルトパラメータグループ内のものと同じです。The initial source for all of the parameters is engine-default because the values are preset by Amazon Redshift. パラメータ値を変更した後、source は user に変わり、値がデフォルト値から変更されたことを示します。

注記

The Amazon Redshift console does not display the source of each parameter. You must use the Amazon Redshift API, the AWS CLI, or one of the AWS SDKs to view the source.

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

デフォルトパラメータ値

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

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

注記

max_cursor_result_set_size パラメータは廃止されました。For more information about cursor result set size, see Cursor constraints in the Amazon Redshift Database Developer Guide.

データベースで SET コマンドを使用して一時的にパラメータを上書きすることもできます。SET コマンドは、現在のセッションの期間だけパラメータを上書きします。前の表で示されたパラメータに加えて、データベースで wlm_query_slot_count を設定することで、一時的にスロットカウントを調整することもできます。wlm_query_slot_count パラメータは、パラメータグループでの設定に使用することはできません。For more information about adjusting the slot count, see wlm_query_slot_count in the Amazon Redshift Database Developer Guide. For more information about temporarily overriding the other parameters, see Modifying the server configuration in the Amazon Redshift Database Developer Guide.

Configuring parameter values using the AWS CLI

To configure Amazon Redshift parameters by using the AWS CLI, you use the modify-cluster-parameter-group command for a specific parameter group. parameter-group-name で、変更するパラメータグループを指定します。parameters パラメータ (modify-cluster-parameter-group コマンドのパラメータ) を使用して、パラメータグループで変更する各パラメータの名前と値のペアを指定します。

注記

There are special considerations when configuring the wlm_json_configuration parameter by using the AWS CLI. このセクションの例は、wlm_json_configuration を除くすべてのパラメータに適用されます。For more information about configuring wlm_json_configuration by using the AWS CLI, see ワークロード管理の設定.

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

注記

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

構文

次の構文は、modify-cluster-parameter-group コマンドを使用してパラメータを設定する方法を示しています。You specify parameter_group_name and replace both parameter_name および parameter_value with an actual parameter to modify and a value for that parameter. 複数のパラメータを同時に変更する場合は、パラメータと値の各セットをスペースで区切ります。

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 パラメータを設定する方法を示しています。

注記

For readability purposes, the example is displayed on several lines, but in the actual AWS CLI this is one line.

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

You can manage parameter groups using the console. 詳細については、「コンソールを使用したパラメータグループの管理」を参照してください。