Amazon Redshift 参数组 - Amazon Redshift
概览关于参数组默认参数值使用 Amazon CLI 配置参数值
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon Redshift 参数组

概览

在 Amazon Redshift 中，您可以将参数组与创建的每个集群相关联。参数组是一组适用于您在集群中创建的所有数据库的参数。这些参数可用于配置数据库设置，例如查询超时和日期样式。

关于参数组

每个参数组都拥有几个可用于配置数据库设置的参数。可用参数列表取决于参数组所属的参数组系列。参数组系列是参数组中的参数所适用的 Amazon Redshift 引擎版本。参数组系列名称的格式为 redshift-version，其中 version 是引擎版本。例如，最新的引擎版本为 redshift-1.0。

Amazon Redshift 为每个参数组系列提供一个默认的参数组。默认参数组中的每个参数都有预设值，并且无法修改。默认参数组名称的格式为 default.parameter_group_family，其中 parameter_group_family 是参数组所属引擎的版本。例如，redshift-1.0 版本的默认参数组的名称为 default.redshift-1.0。

注意

目前，redshift-1.0 是 Amazon Redshift 引擎的唯一版本。因此，default.redshift-1.0 是唯一的默认参数组。

如果您想要使用与默认参数组不同的参数值，则必须创建自定义参数组，然后将其与您的集群相关联。最初，自定义参数组中的参数值与默认参数组中的参数值相同。由于值由 Amazon Redshift 预先设置，因此所有参数的初始 source 均为 engine-default。在您更改参数值之后，source 将变为 user，表明默认值被修改为现在的值。

注意

Amazon Redshift 控制台不会显示每个参数的 source。您必须使用Amazon Redshift API、Amazon CLI、或其中一个 Amazon 开发工具包才能查看 source。

对于您创建的参数组，您可以随时修改参数值，也可以将所有参数值重置为默认值。您还可以将其他参数组与某个集群相关联。在某些情况下，您可以修改与集群关联的参数组中的参数值，或者将其他参数组与集群关联。在这些情况下，您可能需要重新启动集群以使更新后的参数值生效。如果该集群发生故障并由 Amazon Redshift 重新启动，那么系统将在此时应用您所做的更改。如果集群在维护期间重启，则无法应用更改。有关更多信息，请参阅WLM 动态和静态属性。

默认参数值

您可以通过下面的表一目了然地了解默认的参数值，并借助提供的相应链接详细了解每个参数。下面显示的是 redshift-1.0 参数组系列的默认值。

参数名称 值 更多信息

auto_analyze

真实

 Amazon Redshift 数据库开发人员指南中的 auto_analyze

auto_mv

真实

 《Amazon Redshift 数据库开发人员指南》中的自动实体化视图

datestyle

ISO、MDY

Amazon Redshift 数据库开发人员指南中的 datestyle

enable_case_sensitive_identifier

false

Amazon Redshift 数据库开发人员指南中的 enable_case_sensitive_identifier

enable_user_activity_logging

false

本指南中的数据库审计日志记录

extra_float_digits

0

 Amazon Redshift 数据库开发人员指南中的 extra_float_digits

max_concurrency_scaling_clusters

1

 Amazon Redshift 数据库开发人员指南中的 max_concurrency_scaling_clusters

query_group

默认值

Amazon Redshift 数据库开发人员指南中的 query_group

require_ssl

false

 本指南中的配置连接的安全选项

search_path

$user、public

Amazon Redshift 数据库开发人员指南中的 search_path

statement_timeout

0

 Amazon Redshift 数据库开发人员指南中的 statement_timeout

wlm_json_configuration

[{"auto_wlm":true}]

本指南中的配置工作负载管理

use_fips_ssl

false

仅在您的系统需要与 FIPS 兼容时才启用与 FIPS 兼容的 SSL 模式。
注意

max_cursor_result_set_size 参数已弃用。有关游标结果集大小的更多信息，请参阅 Amazon Redshift 数据库开发人员指南中的游标约束。

您可以使用数据库中的 SET 命令临时覆盖参数。SET 命令仅覆盖当前会话持续时间内的参数。除了上表中列出的参数之外，您还可以通过在数据库中设置 wlm_query_slot_count 来临时调整槽位计数。wlm_query_slot_count 参数不适用于参数组中的配置。有关调整槽数的更多信息，请参阅 Amazon Redshift 数据库开发人员指南中的 wlm_query_slot_count。有关临时覆盖其他参数的更多信息，请参阅 Amazon Redshift 数据库开发人员指南中的修改服务器配置。

使用 Amazon CLI 配置参数值

要使用 Amazon CLI 配置 Amazon Redshift 参数，您可以对特定的参数组使用 modify-cluster-parameter-group 命令。您可以在 parameter-group-name 中指定要修改的参数组。您可以使用 parameters 参数（针对 modify-cluster-parameter-group 命令）指定希望在参数组中修改的每个参数的名称/值对。

注意

这些是使用 Amazon CLI 配置 wlm_json_configuration 参数时需要考虑的一些特殊注意事项。此部分中的示例适用于除 wlm_json_configuration 之外的所有参数。有关使用 Amazon CLI 配置 wlm_json_configuration 的更多信息，请参阅配置工作负载管理。

修改参数值之后，您必须重新启动与修改后的参数组相关联的所有集群。当系统正在应用值时，集群状态将针对 ParameterApplyStatus 显示 applying；当应用了这些值之后，该状态则变为 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

示例

下面的示例显示了如何配置 myclusterparametergroup 参数组的 statement_timeout 和 enable_user_activity_logging 参数。

注意

为了便于阅读，该示例分为多行显示出来；但在实际的 Amazon CLI 中，该示例显示为一行。

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

您可以使用控制台管理参数组。有关更多信息，请参阅使用控制台管理参数组。