Modificar um parameter group - Amazon Redshift

O Amazon Redshift não permitirá mais a criação de funções definidas pelo usuário (UDFs) do Python a partir de 1.º de novembro de 2025. Se quiser usar UDFs do Python, você deve criá-las antes dessa data. As UDFs do Python existentes continuarão a funcionar normalmente. Para ter mais informações, consulte a publicação de blog .

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)

      • Query groups (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 ter 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