从补丁 198 开始，Amazon Redshift 将不再支持创建新的 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 管理控制台并打开 Amazon Redshift 控制台，网址：[https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)。

1. 在导航菜单上，选择 **Configurations（配置）**，然后选择 **Workload management（工作负载管理）**，以显示 **Workload management（工作负载管理）**页面。

1. 选择要修改的参数组以便显示详细信息页面，该页面带有 **Parameters (参数)** 和 **Workload management (工作负载管理)** 选项卡。

1. 选择 **Parameters (参数)** 选项卡查看当前参数设置。

1. 选择 **Edit parameters (编辑参数)** 以便允许更改以下参数的设置：
   + `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. 输入所做的更改，然后选择 **Save (保存)** 更新参数组。

**修改参数组的 WLM 配置**

1. 登录到 AWS 管理控制台并打开 Amazon Redshift 控制台，网址：[https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)。

1. 在导航菜单上，选择 **Configurations（配置）**，然后选择 **Workload management（工作负载管理）**，以显示 **Workload management（工作负载管理）**页面。

1. 选择要修改的参数组以便显示详细信息页面，该页面带有 **Parameters (参数)** 和 **Workload management (工作负载管理)** 选项卡。

1. 选择 **Workload management (工作负载管理)** 选项卡查看当前 WLM 配置。

1. 选择**编辑工作负载队列**以编辑 WLM 配置。

1. （可选）选择 **Enable short query acceleration (启用短查询加速)** 以便启用短查询加速 (SQA)。

   当您启用 SQA 时，原定设置情况下 **Maximum run time for short queries (1 to 20 seconds) (短查询的最大运行时间 (1 到 20 秒))** 将设置为 **Dynamic (动态)**。要将最大运行时设置为固定值，请选择一个介于 1–20 之间的值。

1. 执行以下一项或多项操作来修改队列配置：
   + 选择 **Switch WLM mode (切换 WLM 模式)** 可在 **Automatic WLM (自动 WLM)** 和 **Manual WLM (手动 WLM)** 之间选择。

     使用 **Automatic WLM (自动 WLM)** 时，**Memory (内存)** 和 **Concurrency on main (主集群上的并发)** 值设置为 **auto (自动)**。
   + 要创建队列，请选择 **Edit workload queues (编辑工作负载队列)**，然后选择 **Add Queue (添加队列)**。
   + 要修改队列，更改表中的属性值。根据队列类型，属性可能包括：
     + 可以更改 **Queue name (队列名称)**。
     + **“Memory”**
     + **主集群上的并发**
     + **并发扩展模式**可以为**关闭**或**自动**
     + **超时 (ms)**
     + **用户组**
     + **查询组**
     + **用户角色**

     有关这些属性的更多信息，请参阅[WLM 配置参数的属性](workload-mgmt-config.md#wlm-json-config-properties)。
**重要**  
如果您更改队列名称，则 WLM 队列指标（例如 WLMQueueLength、WLMQueueWaitTime、WLMQueriesCompletedPerSecond、WLMQueryDuration、WLMRunningQueries 等）的 `QueueName` 维度值也会发生更改。因此，如果您更改队列的名称，则可能需要更改已设置的 CloudWatch 警报。
   + 要更改队列顺序，请选择 **Up (向上)** 和 **Down (向下)** 箭头按钮。
   + 要删除队列，在表中选择改队列所在行中的 **Delete (删除)**。

1. （可选）选择 **Defer dynamic changes until reboot (推迟动态更改，直到重新启动)** 以便在下次重启集群后对其应用更改。
**注意**  
对于某些设置，无论此项设置为何，都要求在集群重启之后才生效。有关更多信息，请参阅 [WLM 动态和静态属性](workload-mgmt-config.md#wlm-dynamic-and-static-properties)。

1. 选择 **Save**。

------
#### [ 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)。

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

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

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

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

------