

 O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Modificar um parameter group
<a name="parameter-group-modify"></a>

Você pode visualizar qualquer um dos grupos de parâmetros para ver um resumo dos valores dos parâmetros e do gerenciamento do workload (WLM - workload management). Você pode modificar parâmetros para alterar as configurações de parâmetro e as propriedades de configuração de WLM. 

**nota**  
Você não pode modificar o grupo de parâmetro padrão.

------
#### [ Console de gerenciamento da AWS ]

No console, os parâmetros de grupo são exibidos na guia **Parâmetros**, e a opção **Filas de workloads** é exibida na guia **Gerenciamento de workloads**. 

**Para modificar um grupo de parâmetros**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon Redshift em [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/).

1. No menu de navegação, escolha **Configurations** (Configurações) e **Workload management** (Gerenciamento de workload) para exibir a página **Workload management** (Gerenciamento de workload). 

1. Escolha o grupo de parâmetros que você deseja modificar para exibição na página de detalhes, com as guias **Parameters (Parâmetros)** e **Workload management (Gerenciamento do workload)**. 

1. Use a guia **Parameters (Parâmetros)** para visualizar as configurações atuais dos parâmetros. 

1. Escolha **Edit parameters (Editar parâmetros)** para habilitar a alteração das configurações destes parâmetros: 
   + `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`

   Para mais informações sobre esses parâmetros, consulte [Grupos de parâmetros do Amazon Redshift](working-with-parameter-groups.md). 

1. Insira suas alterações e escolha **Save (Salvar)** para atualizar o grupo de parâmetros. 

**Para modificar a configuração do WLM de um grupo de parâmetros**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon Redshift em [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/).

1. No menu de navegação, escolha **Configurations** (Configurações) e **Workload management** (Gerenciamento de workload) para exibir a página **Workload management** (Gerenciamento de workload). 

1. Escolha o grupo de parâmetros que você deseja modificar para exibição na página de detalhes, com as guias **Parameters (Parâmetros)** e **Workload management (Gerenciamento do workload)**. 

1. Escolha a guia **Workload management (Gerenciamento do workload)** para visualizar a configuração do WLM. 

1. Escolha **Editar filas de workloads** para editar a configuração do WLM. 

1. (Opcional) Selecione **Enable short query acceleration (Habilitar aceleração de consultas breves)** para habilitar a aceleração de consultas breves (SQA).

   Ao habilitar a SQA, ** Tempo máximo de execução de consultas breves (1 a 20 segundos)** é definido para **Dinâmico** por padrão. Para definir o tempo de execução máximo para um valor fixo, escolha um valor de 1–20.

1. Complete uma ou mais das seguintes opções para modificar a configuração da fila: 
   + Escolha **Switch WLM mode (Alternar modo de WLM)** para selecionar entre **Automatic WLM (WLM automático)** e **Manual WLM (WLM manual)**.

     Com **Automatic WLM (WLM automático)**, os valores de **Memory (Memória)** e **Concurrency on main (Simultaneidade no principal)** são definidos como **auto (automático)**.
   + Para criar uma fila, escolha **Edit workload queues (Editar filas de workload)** e escolha **Add Queue (Adicionar fila)**.
   + Para modificar uma fila, altere valores de propriedades na tabela. Dependendo do tipo da fila, as propriedades podem incluir o seguinte:
     + **Queue name (Nome da fila)** pode ser alterado. 
     + **Memory" (Memória (%)**
     + **Concurrency on main (Simultaneidade no principal)** cluster
     + **Concurrency Scaling mode (Modo de escalabilidade da simultaneidade)** pode estar **off (desligado)** ou **auto (automático)**.
     + **Timeout (Tempo limite) (ms)**
     + **User groups (Grupos de usuários**
     + **Grupos de consultas**
     + **Perfis de usuário**

     Para obter mais informações sobre essas propriedades, consulte [Propriedades referentes ao parâmetro de configuração do WLM](workload-mgmt-config.md#wlm-json-config-properties).
**Importante**  
Se você alterar um nome de fila, o valor da dimensão `QueueName` de métricas de fila do WLM (como WLMQueueLength, WLMQueueWaitTime, WLMQueriesCompletedPerSecond, WLMQueryDuration, WLMRunningQueries e assim por diante) também mudará. Portanto, se você alterar o nome de uma fila, pode ser necessário alterar os alarmes do CloudWatch que você configurou. 
   + Para alterar a ordem das filas, escolha os botões de seta para **cima** e para **baixo**. 
   + Para excluir uma fila, selecione **Excluir** na linha da fila na tabela.

1. (Opcional) Selecione **Defer dynamic changes until reboot (Adiar mudanças dinâmicas até a reinicialização)** para que as alterações sejam aplicadas aos clusters associados após a próxima reinicialização.
**nota**  
Algumas mudanças exigem uma reinicialização do cluster independentemente desta configuração. Para obter mais informações, consulte [Propriedades dinâmicas e estáticas do WLM](workload-mgmt-config.md#wlm-dynamic-and-static-properties).

1. Escolha **Salvar**.

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

 Para configurar parâmetros do Amazon Redshift usando a AWS CLI, você usa o comando [modify-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/redshift/modify-cluster-parameter-group.html) para um grupo de parâmetros específico. Você especifica o parameter group a ser modificado em `parameter-group-name`. Você usa o parâmetro `parameters` (do comando `modify-cluster-parameter-group`) a fim de especificar pares de nome/valor para cada parâmetro que deseja modificar no parameter group. 

**nota**  
Existem considerações especiais durante a configuração do parâmetro `wlm_json_configuration` usando a AWS CLI. Os exemplos nesta seção se aplicam a todos os parâmetros, exceto `wlm_json_configuration`. Para obter mais informações sobre como configurar o `wlm_json_configuration` usando a AWS CLI, consulte [Gerenciamento do workload](workload-mgmt-config.md). 

Depois de modificar valores de parâmetro, você deverá reinicializar todos os clusters que estejam associados ao parameter group modificado. O status do cluster exibe `applying` para `ParameterApplyStatus` enquanto os valores são aplicados e `pending-reboot` depois que os valores tiverem sido aplicados. Depois de reinicializar, os bancos de dados no cluster começarão a usar os novos valores de parâmetro. Para obter mais informações sobre como reiniciar clusters, consulte [Reinicialização de um cluster](reboot-cluster.md). 

**nota**  
O parâmetro `wlm_json_configuration` contém algumas propriedades dinâmicas e não exigem que você reinicie clusters associados para que as alterações sejam aplicadas. Para obter mais informações sobre propriedades dinâmicas e estáticas, consulte [Propriedades dinâmicas e estáticas do WLM](workload-mgmt-config.md#wlm-dynamic-and-static-properties). 

 A sintaxe a seguir mostra como usar o comando `modify-cluster-parameter-group` para configurar um parâmetro. Você especifica *parameter\$1group\$1name* e substitui *parameter\$1name* e *parameter\$1value* por um parâmetro real a ser modificado e um valor para esse parâmetro. Se você quiser modificar mais de um parâmetro simultaneamente, separe cada conjunto de parâmetros e valores do seguinte com um espaço. 

```
aws redshift modify-cluster-parameter-group --parameter-group-name parameter_group_name --parameters ParameterName=parameter_name,ParameterValue=parameter_value
```

 O exemplo a seguir mostra como configurar os parâmetros `statement_timeout` e `enable_user_activity_logging` do parameter group `myclusterparametergroup`. 

**nota**  
 Para fins de legibilidade, o exemplo é exibido em várias linhas, mas, na AWS CLI real, tem uma linha. 

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

------