Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 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 管理主控台 ，並在 [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)：// 開啟 Amazon Redshift 主控台。

1. 在導覽選單中，選擇**組態**，然後選擇**工作負載管理**以顯示**工作負載管理**頁面。

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 管理主控台 ，並在 [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)：// 開啟 Amazon Redshift 主控台。

1. 在導覽選單中，選擇**組態**，然後選擇**工作負載管理**以顯示**工作負載管理**頁面。

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 模式)**，以選擇 **Auto WLM (自動 WLM)** 或 **Manual WLM (手動 WLM)**。

     使用 **Automatic WLM (自動 WLM)** 時，**Memory (記憶體)** 和 **Concurrency on main (主要叢集的並行)** 值會設為 **auto (自動)**。
   + 若要建立佇列，請選擇 **Edit workload queues (編輯工作負載佇列)**，再選擇 **Add Queue (新增佇列)**。
   + 若要修改佇列，請變更資料表中的屬性值。依據佇列類型而定，屬性可能包括：
     + 可以變更 **Queue name (佇列名稱)**。
     + **Memory (%) (記憶體 (%))**
     + **Concurrency on main (主要叢集的並行)**
     + **Concurrency scaling mode (並行擴展模式)** 可以是 **off (關閉)** 或 **auto (自動)**
     + **Timeout (ms) (逾時 (毫秒))**
     + **User groups (使用者群組)**
     + **Query groups (查詢群組)**
     + **使用者角色**

     如需這些屬性的相關資訊，請參閱[WLM 組態參數的屬性](workload-mgmt-config.md#wlm-json-config-properties)。
**重要**  
如果您變更佇列名稱，WLM 佇列指標的 `QueueName` 維度值 (例如 WLMQueueLength、WLMQueueWaitTime、WLMQueriesCompletedPerSecond、WLMQueryDuration、WLMRunningQueries 等) 也會變更。因此，如果您變更佇列的名稱，則可能需要變更您已設定的 CloudWatch 警報。
   + 若要變更佇列的順序，請選擇 **Up (向上)** 和 **Down (向下)** 箭頭按鈕。
   + 若要刪除佇列，請在資料表中選擇佇列那一列的 **Delete (刪除)**。

1. (選用) 請選取 **Defer dynamic changes until reboot (延遲動態變更直至重開機)**，在下次重新開機之後將變更套用至叢集。
**注意**  
不論此設定如何，某些變更需要將叢集重新開機。如需詳細資訊，請參閱[WLM 動態和靜態屬性](workload-mgmt-config.md#wlm-dynamic-and-static-properties)。

1. 選擇 **Save** (儲存)。

------
#### [ AWS CLI ]

 若要使用 設定 Amazon Redshift 參數 AWS CLI，請針對特定參數群組使用 [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` 命令) 指定參數群組中您想要修改之各參數的名稱/值對。

**注意**  
使用 AWS CLI設定 `wlm_json_configuration` 參數時有特殊考量。本節中的範例適用於除了 `wlm_json_configuration` 之外的所有參數。如需使用 `wlm_json_configuration`設定 的詳細資訊 AWS CLI，請參閱 [工作負載管理](workload-mgmt-config.md)。

修改參數值後，您必須重新啟動與修改過的參數群組相關聯的任何叢集。`applying` 的叢集狀態在套用值時會顯示 `ParameterApplyStatus`，套用結束後則顯示 `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
```

 下列範例說明如何設定 `statement_timeout` 參數群組的 `enable_user_activity_logging` 和 `myclusterparametergroup` 參數。

**注意**  
 基於可讀性目的，此範例會顯示在幾行上，但實際上 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
```

------