View a markdown version of this page

Modificar um parameter group - Amazon Redshift

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

Modificar um parameter group

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.

AWS Management Console

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 AWS Management Console e abra o console do Amazon Redshift em https://console.aws.amazon.com/redshiftv2/.

  2. 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).

  3. 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).

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

  5. 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.

  6. 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 AWS Management Console e abra o console do Amazon Redshift em https://console.aws.amazon.com/redshiftv2/.

  2. 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).

  3. 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).

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

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

  6. (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.

  7. 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.

      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.

  8. (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.

  9. Escolha Salvar.

AWS CLI

Para configurar parâmetros do Amazon Redshift usando a AWS CLI, você usa o comando modify-cluster-parameter-group 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.

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.

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.

A sintaxe a seguir mostra como usar o comando modify-cluster-parameter-group para configurar um parâmetro. Você especifica parameter_group_name e substitui parameter_name e parameter_value 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