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/). # Grupos de parâmetros do Amazon Redshift No Amazon Redshift, você associa um grupo de parâmetros a cada cluster que você cria. Um *grupo de parâmetros* é um grupo de parâmetros que se aplicam a todos os bancos de dados que você cria no cluster. Esses parâmetros definem as configurações do banco de dados, como tempo limite de consulta e estilo de data. Quando você executa um cluster, você deve associá-lo a um parameter group. Se você quiser alterar o parameter group mais tarde, você pode modificar o cluster e escolher um parameter group diferente. Cada parameter group tem vários parâmetros para definir configurações do banco de dados. A lista de parâmetros disponíveis depende da família do parameter group à qual o parameter group pertence. A família de grupos de parâmetros padrão é `redshift-2.0`. O Amazon Redshift fornece um grupo de parâmetros padrão para cada família de grupo de parâmetros. O parameter group padrão tem valores predefinidos para cada um dos parâmetros e não pode ser modificado. O formato do nome do grupo de parâmetros padrão é `default.parameter_group_family`. Por exemplo, o grupo de parâmetros padrão para a família de grupos de parâmetros `redshift-2.0` é `default.redshift-2.0`. Se quiser usar valores de parâmetro diferentes do parameter group padrão, você deverá criar um parameter group personalizado e associar o cluster a ele. Inicialmente, os valores de parâmetro em um parameter group personalizado são os mesmos do parameter group padrão. A `source` inicial para todos os parâmetros é `engine-default` porque os valores são predefinidos pelo Amazon Redshift. Depois que você alterar um valor de parâmetro, o `source` mudará para `user` a fim de indicar que o valor foi modificado em relação ao valor padrão. **nota** O console do Amazon Redshift não exibe a `source` de cada parâmetro. É necessário usar a API do Amazon Redshift, a AWS CLI ou uma das AWS SDKs para visualizar a `source`. Para grupos de parâmetros criados, você pode modificar um valor de parâmetro a qualquer momento, ou pode restaurar os padrões de todos os valores de parâmetro. Você também pode associar um grupo de parâmetros diferente a um cluster. Em alguns casos, poderá modificar valores de parâmetro em um grupo de parâmetros que já está associado a um cluster ou associar um grupo de parâmetros diferente a um cluster. Nesses casos, poderá ser necessário reiniciar o cluster para que os valores de parâmetro atualizados entrem em vigor. Se o cluster falhar e for reiniciado pelo Amazon Redshift, suas alterações serão aplicadas naquele momento. As alterações não serão aplicadas se o cluster for reiniciado durante a manutenção. Para obter mais informações, consulte [Propriedades dinâmicas e estáticas do WLM](workload-mgmt-config.md#wlm-dynamic-and-static-properties). ## Valores de parâmetro padrão **nota** A partir de 10 de janeiro de 2025, o valor padrão do parâmetro `require_ssl` é “true” (verdadeiro). Se não quiser que o cluster exija SSL, você poderá usar um grupo de parâmetros personalizado ao criar ou modificar o cluster para associá-lo a um grupo de parâmetros personalizado depois da criação com o padrão. A tabela a seguir mostra resumidamente os valores de parâmetro padrão com links para informações mais aprofundadas sobre cada parâmetro. Esses são os valores padrão da família de grupos de parâmetros `redshift-2.0`. | Nome do parâmetro | Valor | Mais informações | | --- | --- | --- | | auto\$1analyze | true | [auto\$1analyze](https://docs.aws.amazon.com/redshift/latest/dg/t_Analyzing_tables.html#t_Analyzing_tables-auto-analyze) no Guia do desenvolvedor de banco de dados do Amazon Redshift | | auto\$1mv | true | [Visualizações materializadas automatizadas](https://docs.aws.amazon.com/redshift/latest/dg/materialized-view-auto-mv.html) no Guia do desenvolvedor do banco de dados do Amazon Redshift | | datestyle | ISO, MDY | [datestyle](https://docs.aws.amazon.com/redshift/latest/dg/r_datestyle.html) no Guia do desenvolvedor de banco de dados do Amazon Redshift | | enable\$1case\$1sensitive\$1identifier | false | [enable\$1case\$1sensitive\$1identifier](https://docs.aws.amazon.com/redshift/latest/dg/r_enable_case_sensitive_identifier.html) no Guia do desenvolvedor de banco de dados do Amazon Redshift | | enable\$1user\$1activity\$1logging | false | [Registro em log da auditoria de banco de dados](db-auditing.md) neste guia | | extra\$1float\$1digits | 0 | [extra\$1float\$1digits](https://docs.aws.amazon.com/redshift/latest/dg/r_extra_float_digits.html) no Guia do desenvolvedor de banco de dados do Amazon Redshift | | max\$1concurrency\$1scaling\$1clusters | 1 | [max\$1concurrency\$1scaling\$1clusters](https://docs.aws.amazon.com/redshift/latest/dg/r_max_concurrency_scaling_clusters.html) no Guia do desenvolvedor de banco de dados do Amazon Redshift | | query\$1group | default | [query\$1group](https://docs.aws.amazon.com/redshift/latest/dg/r_query_group.html) no Guia do desenvolvedor de banco de dados do Amazon Redshift | | require\$1ssl | true | [Configurar as opções de segurança para conexões](connecting-ssl-support.md) neste guia | | search\$1path | \$1user, public | [search\$1path](https://docs.aws.amazon.com/redshift/latest/dg/r_search_path.html) no Guia do desenvolvedor de banco de dados do Amazon Redshift | | statement\$1timeout | 0 | [statement\$1timeout](https://docs.aws.amazon.com/redshift/latest/dg/r_statement_timeout.html) no Guia do desenvolvedor de banco de dados do Amazon Redshift | | wlm\$1json\$1configuration | [\$1"auto\$1wlm":true\$1] | [Gerenciamento do workload](workload-mgmt-config.md) neste guia | | use\$1fips\$1ssl | false | Habilite o modo SSL compatível com FIPS somente se o sistema precisar ser compatível com FIPS. | **nota** O parâmetro `max_cursor_result_set_size` está obsoleto. Para obter mais informações sobre o tamanho do conjunto de resultados do cursor, consulte [Restrições de cursor](https://docs.aws.amazon.com/redshift/latest/dg/declare.html#declare-constraints) no *Guia do desenvolvedor de banco de dados do Amazon Redshift*. Você pode substituir temporariamente um parâmetro usando o comando `SET` no banco de dados. O comando `SET` substitui somente o parâmetro da duração da sessão atual. Além dos parâmetros listados na tabela anterior, você também pode ajustar temporariamente a contagem de slots definindo `wlm_query_slot_count` no banco de dados. O parâmetro `wlm_query_slot_count` não está disponível para configuração em grupos de parâmetros. Para obter mais informações sobre como ajustar a contagem de slots, consulte [wlm\$1query\$1slot\$1count](https://docs.aws.amazon.com/redshift/latest/dg/r_wlm_query_slot_count.html) no *Guia do desenvolvedor de banco de dados do Amazon Redshift*. Para obter mais informações sobre como substituir temporariamente outros parâmetros, consulte [Modificar a configuração do servidor](https://docs.aws.amazon.com/redshift/latest/dg/t_Modifying_the_default_settings.html) no *Guia do desenvolvedor de banco de dados do Amazon Redshift*. # Gerenciamento do workload No Amazon Redshift, você usa o gerenciamento de workload (WLM) para definir o número de filas de consulta que estão disponíveis e como as consultas são roteadas para essas filas para processamento. O WLM faz parte da configuração do parameter group. Um cluster usar a configuração do WLM especificada no parameter group associado. Quando você cria um parameter group, a configuração do WLM padrão contém uma fila capaz de executar até cinco consultas simultaneamente. Você poderá adicionar filas e configurar propriedades do WLM em cada uma delas, se quiser mais controle sobre o processamento de consultas. Cada fila adicionada terá a mesma configuração do WLM padrão até você configurar as propriedades. Quando você adiciona filas, a última fila na configuração é a *fila padrão*. A menos que seja roteada para outra fila com base em critérios na configuração do WLM, uma consulta é processada pela fila padrão. É possível especificar o modo e o nível de simultaneidade (slots de consulta) da fila padrão, mas não é possível especificar grupos de usuários ou de consultas para a fila padrão. Assim como acontece com outros parâmetros, você não pode modificar a configuração do WLM no parameter group padrão. Os clusters associados ao parameter group padrão sempre usam a configuração do WLM padrão. Para modificar a configuração do WLM, crie um novo grupo de parâmetros e associe esse grupo de parâmetros a todos os clusters que exigirem a configuração do WLM personalizada. ## Propriedades dinâmicas e estáticas do WLM As propriedades de configuração do WLM são dinâmicas ou estáticas. É possível aplicar propriedades dinâmicas ao banco de dados sem uma reinicialização do cluster, mas as propriedades estáticas exigem uma reinicialização do cluster para que as alterações entrem em vigor. Para obter mais informações sobre propriedades dinâmicas e estáticas, consulte [Propriedades de configuração dinâmicas e estáticas do WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-dynamic-properties.html). ## Propriedades referentes ao parâmetro de configuração do WLM É possível configurar o WLM usando o console do Amazon Redshift, a AWS CLI, a API do Amazon Redshift ou uma das AWS SDKs. A configuração do WLM usa várias propriedades para definir o comportamento da fila, como alocação da memória entre as filas, o número de consultas que podem ser executadas simultaneamente em uma fila etc. **nota** As propriedades a seguir aparecem com seus nomes de console do Amazon Redshift, com os nomes de propriedade JSON correspondentes nas descrições. A tabela a seguir resume se uma propriedade se aplica ao WLM automático ou WLM manual. **** | Propriedade do WLM | WLM automático | WLM manual | | --- | --- | --- | | Auto WLM (WLM automático) | Sim | Sim | | Habilitar a aceleração de consultas breves | Sim | Sim | | Tempo máximo de execução para consultas breves | Sim | Sim | | Prioridade | Sim | Não | | Tipo de fila | Sim | Sim | | Nome da fila | Sim | Sim | | Modo de escalabilidade da simultaneidade | Sim | Sim | | Simultaneidade | Não | Sim | | User groups (Grupos de usuários) | Sim | Sim | | Curinga do grupo de usuários | Sim | Sim | | Grupos de consultas | Sim | Sim | | Curinga do grupo de consultas | Sim | Sim | | Funções de usuário | Sim | Sim | | Caractere curinga de perfil de usuário | Sim | Sim | | Tempo limite | Não | Suspenso | | Memória | Não | Sim | | Regras de monitoramento de consulta | Sim | Sim | A lista a seguir descreve as propriedades do WLM que você pode configurar. **Auto WLM (WLM automático** **Auto WLM (WLM automático)** definido como `true` habilita o WLM automático. O WLM automático define os valores de **Simultaneidade no principal** e **Memória (%)** como `Auto`. O Amazon Redshift gerencia a simultaneidade de consultas e a alocação de memória. O padrão é `true`. Propriedade JSON: `auto_wlm` **Habilitar a aceleração de consultas breves** A aceleração de consultas breves (SQA) prioriza as consultas de curta execução sobre as consultas de execução demorada. A SQA executa consultas breves em um espaço dedicado, de maneira que as consultas SQA não sejam forçadas a esperar em filas atrás de consultas mais demoradas. Com a SQA, consultas breves são iniciadas com mais rapidez e os usuários veem os resultados mais cedo. Quando você habilita a SQA, também pode especificar o tempo máximo de execução para consultas breves. Para habilitar a SQA, especifique `true`. O padrão é `false`. Essa configuração é aplicada para cada grupo de parâmetros em vez de para cada fila. Propriedade JSON: `short_query_queue` ****Tempo máximo de execução para consultas breves**** Quando você habilita a SQA, pode especificar 0 para permitir que WLM defina, de forma dinâmica, o tempo máximo de execução para consultas breves. Como alternativa, você pode especificar um valor de 1 a 20 segundos, em milissegundos. O valor padrão é `0`. Propriedade JSON: `max_execution_time` **Prioridade** Priority (Prioridade) define a prioridade das consultas executadas em uma fila. Para definir a prioridade, o **WLM mode (Modo do WLM)** deve ser definido como **Auto WLM (WLM automático)**, ou seja, `auto_wlm` deve ser `true`. Os valores de prioridade podem ser `highest`, `high`, `normal`, `low` e `lowest`. O padrão é `normal`. Propriedade JSON: `priority` **Tipo de fila** O tipo de fila designa uma fila como usada por **Auto WLM (WLM automático)** ou **Manual WLM (WLM manual)**. Defina `queue_type` como `auto` ou `manual`. Se não especificado, o padrão será `manual`. Propriedade JSON: `queue_type` **Nome da fila** O nome da fila. Você pode definir o nome da fila com base nas necessidades da sua empresa. Os nomes de fila devem ser exclusivos dentro de uma configuração do WLM, ter até 64 caracteres alfanuméricos, sublinhados ou espaços, e não podem conter aspas. Por exemplo, se você tiver uma fila para as consultas de ETL, poderá chamá-la de `ETL queue`. Este nome é usado em métricas, valores de tabela do sistema e no console do Amazon Redshift para identificar a fila. Consultas e relatórios que usam o nome dessas fontes precisam ser capazes de lidar com alterações no nome. Anteriormente, os nomes das filas eram gerados pelo Amazon Redshift. Os nomes padrão das filas são `Queue 1`, `Queue 2`, até a última fila nomeada `Default queue`. 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. Propriedade JSON: `name` **Modo de escalabilidade da simultaneidade** Para habilitar a escalabilidade da simultaneidade em uma fila, defina o **Concurrency Scaling mode (Modo de escalabilidade da simultaneidade)** como `auto`. Quando o número de consultas roteadas para uma fila excede a simultaneidade configurada da fila, as consultas qualificadas são enviadas para o cluster de escalabilidade. Quando os slots forem disponibilizados, as consultas serão executadas no cluster principal. O padrão é `off`. Propriedade JSON: `concurrency_scaling` **Simultaneidade** O número de consultas que podem ser executadas simultaneamente em uma fila do WLM. Esta propriedade só se aplica ao WLM manual. Se a escalabilidade de simultaneidade estiver habilitada, as consultas qualificadas serão enviadas a um cluster de escalabilidade quando uma fila atingir o nível de simultaneidade (slots de consulta). Se a escalabilidade da simultaneidade estiver desabilitada, as consultas aguardarão na fila até que um slot seja disponibilizado. O intervalo é entre 1 e 50. Propriedade JSON: `query_concurrency` **User Groups (Grupos de usuários** Uma lista separada por vírgulas de nomes de grupos de usuários. Quando membros do grupo de usuários executam consultas no banco de dados, as consultas são roteadas para a fila associada ao grupo de usuários. Propriedade JSON: `user_group` **User Group Wildcard** Um valor Booliano que indica se é necessário permitir curingas para grupos de usuários. Se for 0, os curingas estarão desativados; se for 1, os curingas estarão ativados. Quando curingas são permitidos, você pode usar "\$1" ou "?" para especificar vários grupos de usuários ao executar consultas. Para obter mais informações, consulte [Curingas](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards). Propriedade JSON: `user_group_wild_card` **Query Groups (Grupos de consultas** Uma lista separada por vírgulas de grupos de consultas. Quando membros do grupo de consultas executam consultas no banco de dados, as consultas são roteadas para a fila associada ao grupo de consultas. Propriedade JSON: `query_group` **Query Group Wildcard** Um valor Booliano que indica se é necessário permitir curingas para grupos de consultas. Se for 0, os curingas estarão desativados; se for 1, os curingas estarão ativados. Quando curingas são permitidos, você pode usar "\$1" ou "?" para especificar vários grupos de consultas ao executar consultas. Para obter mais informações, consulte [Curingas](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards). Propriedade JSON: `query_group_wild_card` **Perfis de usuário** Uma lista de perfis de usuário separados por vírgulas. Quando membros com esse perfil de usuário executam consultas no banco de dados, as consultas são roteadas para a fila associada ao respectivo perfil de usuário. Para obter mais informações sobre perfis de usuário, consulte [Controle de acesso com base em função (RBAC)](https://docs.aws.amazon.com/redshift/latest/dg/t_Roles.html). Propriedade JSON: `user_role` **Caractere curinga de perfis de usuário** Um valor Booliano que indica se é necessário permitir curingas para grupos de consultas. Se for 0, os curingas estarão desativados; se for 1, os curingas estarão ativados. Quando curingas são permitidos, você pode usar "\$1" ou "?" para especificar vários grupos de consultas ao executar consultas. Para obter mais informações, consulte [Curingas](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards). Propriedade JSON: `user_role_wild_card` **Timeout (Tempo limite) (ms)** O tempo limite do WLM (`max_execution_time`) está obsoleto. Não está disponível ao usar o WLM automático. Em vez disso, crie uma regra de monitoramento de consulta (QMR) usando `query_execution_time` para limitar o tempo de execução decorrido para uma consulta. Para obter mais informações, consulte [Regras de monitoramento de consultas do WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html). O tempo máximo, em milissegundos, durante o qual as consultas poderão ser executadas até serem canceladas. Em alguns casos, uma consulta somente leitura, como uma declaração SELECT, poderá ser cancelada devido a um tempo limite do WLM Nesses casos, o WLM tenta rotear a consulta para a próxima fila correspondente com base nas regras de atribuição de filas do WLM. Se não corresponder a nenhuma outra definição de fila, a consulta será cancelada; ela não será atribuída à fila padrão. Para obter mais informações, consulte [Salto na fila de consultas do WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-queue-hopping). O tempo limite do WLM não se aplica a uma consulta que tenha atingido o estado `returning`. Para exibir o estado de uma consulta, consulte a tabela de sistema [STV\$1WLM\$1QUERY\$1STATE](https://docs.aws.amazon.com/redshift/latest/dg/r_STV_WLM_QUERY_STATE.html). Propriedade JSON: `max_execution_time` **Memory" (Memória (%)** A porcentagem de memória a ser alocada à fila. Se especificar uma porcentagem de memória para pelo menos uma das filas, será necessário especificar uma porcentagem para todas as outras filas até um total de 100%. Se a sua alocação de memória for inferior a 100% entre todas as filas, a memória não alocada será gerenciada pelo serviço. O serviço pode conceder temporariamente essa memória não alocada a uma fila que solicita memória adicional para processamento. Propriedade JSON: `memory_percent_to_use` **Regras de monitoramento de consulta** Você pode usar as regras de monitoramento da consulta do WLM para monitorar continuamente as filas do WLM para consultas com base em critérios, ou predicados, especificados. Por exemplo, convém monitorar consultas com a tendência de consumir recursos de sistema excessivos e iniciar uma ação especificada quando uma consulta exceder os limites de performance especificados. Se você optar por criar regras programaticamente, será altamente recomendável usar o console para gerar o JSON incluído por você na definição do parameter group. Você associa uma regra de monitoramento de consulta a uma fila de consultas específica. Pode haver até 25 regras por fila e o limite total para todas as filas é de 25 regras. Propriedade JSON: `rules` Hierarquia de propriedades JSON: ``` rules rule_name predicate metric_name operator value action value ``` Para cada regra, especifique as seguintes propriedades: + `rule_name` – Os nomes de regra devem ser exclusivos na configuração do WLM. Os nomes de regra podem ter até 32 caracteres alfanuméricos ou sublinhados e não podem conter espaços ou aspas. + `predicate` – Você pode ter até três predicados por regra. Para cada predicado, especifique as propriedades a seguir. + `metric_name` – Para obter uma lista de métricas, consulte [Métricas de monitoramento da consulta](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html#cm-c-wlm-query-monitoring-metrics) no *Guia do desenvolvedor de banco de dados do Amazon Redshift*. + `operator` – Operações são `=`, `<` e `>`. + `value` – O valor limite para a métrica especificada que aciona uma ação. + `action` – Cada regra está associada a uma única ação. As ações válidas são: + `log` + `hop` (disponível somente com o WLM manual) + `abort` + `change_query_priority` (disponível somente com o WLM automático) O exemplo a seguir mostra o JSON de uma regra de monitoramento de consulta do WLM chamado `rule_1`, com dois predicados e a ação `hop`. ``` "rules": [ { "rule_name": "rule_1", "predicate": [ { "metric_name": "query_execution_time", "operator": ">", "value": 100000 }, { "metric_name": "query_blocks_read", "operator": ">", "value": 1000 } ], "action": "hop" } ] ``` Para obter mais informações sobre cada uma dessas propriedades e estratégias para configurar filas de consulta, consulte [Implementar gerenciamento de workload](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-implementing-workload-management.html) no *Guia do desenvolvedor de banco de dados do Amazon Redshift*. ## Configurar o parâmetro do WLM usando a AWS CLI Para configurar o WLM, você modifica o parâmetro `wlm_json_configuration`. O tamanho máximo do valor da propriedade `wlm_json_configuration` é de 8.000 caracteres. O valor é formatado em JSON (JavaScript Object Notation). Se você configurar o WLM usando a AWS CLI, a API do Amazon Redshift ou um dos AWS SDKs, use o restante desta seção para saber como construir a estrutura JSON do parâmetro `wlm_json_configuration`. **nota** Se você configurar o WLM usando o console do Amazon Redshift, você não precisa entender a formatação JSON porque o console oferece uma maneira fácil de adicionar filas e configurar suas propriedades. Para obter mais informações sobre como configurar o WLM usando o console, consulte [Modificar um parameter group](parameter-group-modify.md). Exemplo O exemplo a seguir é a configuração do WLM padrão, que define uma fila com WLM automático. ``` { "auto_wlm": true } ``` Exemplo O exemplo a seguir é uma configuração do WLM personalizada que define uma fila do WLM com um nível de simultaneidade (slots de consulta) de cinco. ``` { "query_concurrency":5 } ``` Sintaxe A configuração do WLM padrão é muito simples, somente com uma fila e uma propriedade. Você pode adicionar mais filas e configurar várias propriedades para cada fila na estrutura JSON. A seguinte sintaxe representa a estrutura JSON que você usa para configurar várias filas com várias propriedades: ``` [ { "ParameterName":"wlm_json_configuration", "ParameterValue": "[ { "q1_first_property_name":"q1_first_property_value", "q1_second_property_name":"q1_second_property_value", ... }, { "q2_first_property_name":"q2_first_property_value", "q2_second_property_name":"q2_second_property_value", ... } ... ]" } ] ``` No exemplo anterior, as propriedades representativas que começam com **q1** são objetos em uma matriz da primeira fila. Cada um desses objetos é um par de nome/valor; `name` e `value` definem juntos as propriedades do WLM da primeira fila. As propriedades representativas que começam com **q2** são objetos em uma matriz da segunda fila. Se precisar de mais filas, você adicionará outra matriz para cada fila e definirá as propriedades de cada objeto. Ao modificar a configuração do WLM, você deve incluir na estrutura completa das filas, mesmo se quiser alterar somente uma propriedade dentro de uma fila. Isso porque toda a estrutura JSON é passada como uma string do valor do parâmetro `wlm_json_configuration`. ### Formatar o comando da AWS CLI O parâmetro `wlm_json_configuration` exige um formato específico quando você usa a AWS CLI. O formato usado por você depende do sistema operacional do cliente. Como os sistemas operacionais têm maneiras diferentes de envolver a estrutura JSON, ela é passada corretamente pela linha de comando. Para obter detalhes sobre como construir o comando apropriado nos sistemas operacionais Linux, Mac OS X e Windows, consulte as seções a seguir. Para obter mais informações sobre as diferenças nas estruturas de dados JSON na AWS CLI em geral, consulte [Citando strings](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#quoting-strings) no *Manual do usuário do AWS Command Line Interface*. Exemplos O exemplo de comando a seguir configura o WLM manual para um grupo de parâmetros chamado `example-parameter-group`. A configuração permite a aceleração de consulta breve com um tempo máximo de execução para consultas breves definido como 0, o que instrui o WLM a definir o valor de forma dinâmica. A configuração de `ApplyType` é `dynamic`. Essa configuração significa que todas as alterações feitas em propriedades dinâmicas no parâmetro serão aplicadas automaticamente, a menos que outras alterações estáticas tenham sido feitas na configuração. A configuração define três filas com o seguinte: + A primeira fila permite que os usuários especifiquem `report` como um rótulo (conforme especificado na propriedade `query_group`) nas consultas para ajudar a rotear consultas para essa fila. Como as pesquisas com curinga são permitidas para o rótulo `report*`, este não precisa estar exato para que consultas sejam roteadas para a fila. Por exemplo, `reports` e `reporting` correspondem a esse grupo de consultas. A fila recebe 25 por cento da memória total em todas as filas e pode executar até quatro consultas ao mesmo tempo. As consultas estão limitadas a um tempo máximo de 20.000 milissegundos (ms). O modo está definido como automático, portanto, quando os slots de consulta da fila estão lotados, as consultas qualificadas são enviadas para um cluster de escalabilidade. + A segunda fila permite que usuários membros de grupos `admin` ou `dba` no banco de dados tenham as consultas roteadas para a fila tendo em vista o processamento. Como as pesquisas com curinga estão desabilitadas para grupos de usuários, os usuários devem corresponder exatamente a grupos no banco de dados de maneira que as consultas sejam roteadas para a fila. A fila recebe 40% da memória total em todas as filas e pode executar até cinco consultas ao mesmo tempo. O modo está definido como desativado, portanto, todas as consultas enviadas por membros nos grupos de dba e administrador são executadas no cluster principal. + A última fila na configuração é a padrão. Essa fila recebe 35% da memória total em todas as filas e pode processar até cinco consultas ao mesmo tempo. O modo está definido como automático. **nota** O exemplo é mostrado em várias linhas para fins de demonstração. Os comandos reais não devem ter quebras de linha. ``` aws redshift modify-cluster-parameter-group --parameter-group-name example-parameter-group --parameters '[ { "query_concurrency": 4, "max_execution_time": 20000, "memory_percent_to_use": 25, "query_group": ["report"], "query_group_wild_card": 1, "user_group": [], "user_group_wild_card": 0, "user_role": [], "user_role_wild_card": 0, "concurrency_scaling": "auto", "queue_type": "manual" }, { "query_concurrency": 5, "memory_percent_to_use": 40, "query_group": [], "query_group_wild_card": 0, "user_group": [ "admin", "dba" ], "user_group_wild_card": 0, "user_role": [], "user_role_wild_card": 0, "concurrency_scaling": "off", "queue_type": "manual" }, { "query_concurrency": 5, "query_group": [], "query_group_wild_card": 0, "user_group": [], "user_group_wild_card": 0, "user_role": [], "user_role_wild_card": 0, "concurrency_scaling": "auto", "queue_type": "manual" }, {"short_query_queue": true} ]' ``` Veja a seguir um exemplo de como configurar regras de monitoramento de consultas do WLM para uma configuração de WLM automático. O exemplo cria um parameter group chamado `example-monitoring-rules`. A configuração define as mesmas três filas do exemplo anterior, mas `query_concurrency` e `memory_percent_to_use` não são mais especificadas. A configuração também adiciona as seguintes regras e prioridades de consulta: + A primeira fila define uma regra chamada `rule_1`. A regra tem dois predicados: `query_cpu_time > 10000000` e `query_blocks_read > 1000`. A ação da regra é `log`. A prioridade dessa fila é `Normal`. + A segunda fila define uma regra chamada `rule_2`. A regra tem dois predicados: `query_execution_time > 600000000` e `scan_row_count > 1000000000`. A ação da regra é `abort`. A prioridade dessa fila é `Highest`. + A última fila na configuração é a padrão. A prioridade dessa fila é `Low`. **nota** O exemplo é mostrado em várias linhas para fins de demonstração. Os comandos reais não devem ter quebras de linha. ``` aws redshift modify-cluster-parameter-group --parameter-group-name example-monitoring-rules --parameters '[ { "query_group" : [ "report" ], "query_group_wild_card" : 1, "user_group" : [ ], "user_group_wild_card" : 0, "user_role": [ ], "user_role_wild_card": 0, "concurrency_scaling" : "auto", "rules" : [{ "rule_name": "rule_1", "predicate": [{ "metric_name": "query_cpu_time", "operator": ">", "value": 1000000 }, { "metric_name": "query_blocks_read", "operator": ">", "value": 1000 } ], "action" : "log" } ], "priority": "normal", "queue_type": "auto" }, { "query_group" : [ ], "query_group_wild_card" : 0, "user_group" : [ "admin", "dba" ], "user_group_wild_card" : 0, "user_role": [ ], "user_role_wild_card": 0, "concurrency_scaling" : "off", "rules" : [ { "rule_name": "rule_2", "predicate": [ {"metric_name": "query_execution_time", "operator": ">", "value": 600000000}, {"metric_name": "scan_row_count", "operator": ">", "value": 1000000000}], "action": "abort"}], "priority": "high", "queue_type": "auto" }, { "query_group" : [ ], "query_group_wild_card" : 0, "user_group" : [ ], "user_group_wild_card" : 0, "user_role": [ ], "user_role_wild_card": 0, "concurrency_scaling" : "auto", "priority": "low", "queue_type": "auto", "auto_wlm": true }, { "short_query_queue" : true } ]' ``` #### Configurar o WLM usando a AWS CLI na linha de comando com um arquivo JSON É possível modificar o parâmetro `wlm_json_configuration` usando a AWS CLI e transmitir o valor do argumento `parameters` como um arquivo JSON. ``` aws redshift modify-cluster-parameter-group --parameter-group-name myclusterparaametergroup --parameters file://modify_pg.json ``` Os argumentos para `--parameters` são armazenados no arquivo `modify_pg.json`. A localização do arquivo é especificada no formato do seu sistema operacional. Para obter mais informações, consulte [Carregar parâmetros de um arquivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html#cli-usage-parameters-file). A seguir são exibidos exemplos do conteúdo do arquivo JSON `modify_pg.json`. ``` [ { "ParameterName": "wlm_json_configuration", "ParameterValue": "[{\"user_group\":\"example_user_group1\",\"query_group\": \"example_query_group1\", \"query_concurrency\":7},{\"query_concurrency\":5}]" } ] ``` ``` [ { "ParameterName": "wlm_json_configuration", "ParameterValue": "[{\"query_group\":[\"reports\"],\"query_group_wild_card\":0,\"query_concurrency\":4,\"max_execution_time\":20000,\"memory_percent_to_use\":25},{\"user_group\":[\"admin\",\"dba\"],\"user_group_wild_card\":1,\"query_concurrency\":5,\"memory_percent_to_use\":40},{\"query_concurrency\":5,\"memory_percent_to_use\":35},{\"short_query_queue\": true, \"max_execution_time\": 5000 }]", "ApplyType": "dynamic" } ] ``` #### Regras para configurar o WLM usando a AWS CLI na linha de comando nos sistemas operacionais Linux e macOS X Siga estas regras para executar um comando da AWS CLI com parâmetros em uma linha: + Toda a estrutura JSON deve estar entre aspas simples (‘) e colchetes ([ ]). + Todos os nomes e valores de parâmetro devem estar entre aspas duplas ("). + Dentro do valor `ParameterValue`, você deve colocar toda a estrutura aninhada entre aspas duplas (") e colchetes ([ ]). + Dentro da estrutura aninhada, cada uma das propriedades e dos valores para cada fila deve estar entre chaves (\$1 \$1). + Dentro da estrutura aninhada, você deve usar o caractere de escape de barra invertida (\$1) antes das aspas duplas ("). + Para pares de nome/valor, dois-pontos (:) separa cada propriedade do valor. + Cada par de nome/valor é separado de outros por uma vírgula (,). + Várias filas são separadas por uma vírgula (,) entre o fim da chave (\$1) de uma fila e o início da chave (\$1) da próxima fila. #### Regras para configurar o WLM usando a AWS CLI no Windows PowerShell em sistemas operacionais Microsoft Windows Siga estas regras para executar um comando da AWS CLI com parâmetros em uma linha: + Toda a estrutura JSON deve estar entre aspas simples (‘) e colchetes ([ ]). + Todos os nomes e valores de parâmetro devem estar entre aspas duplas ("). + Dentro do valor `ParameterValue`, você deve colocar toda a estrutura aninhada entre aspas duplas (") e colchetes ([ ]). + Dentro da estrutura aninhada, cada uma das propriedades e dos valores para cada fila deve estar entre chaves (\$1 \$1). + Dentro da estrutura aninhada, você deve usar o caractere de escape de barra invertida (\$1) antes das aspas duplas (") e do caractere de escape de barra invertida (\$1). Esse requisito significa que você usará três barras invertidas e aspas duplas para verificar se as propriedades são passadas corretamente (\$1\$1\$1"). + Para pares de nome/valor, dois-pontos (:) separa cada propriedade do valor. + Cada par de nome/valor é separado de outros por uma vírgula (,). + Várias filas são separadas por uma vírgula (,) entre o fim da chave (\$1) de uma fila e o início da chave (\$1) da próxima fila. #### Regras para configurar o WLM usando o prompt de comando em sistemas operacionais Windows Siga estas regras para executar um comando da AWS CLI com parâmetros em uma linha: + Toda a estrutura JSON deve estar entre aspas duplas (“) e colchetes ([ ]). + Todos os nomes e valores de parâmetro devem estar entre aspas duplas ("). + Dentro do valor `ParameterValue`, você deve colocar toda a estrutura aninhada entre aspas duplas (") e colchetes ([ ]). + Dentro da estrutura aninhada, cada uma das propriedades e dos valores para cada fila deve estar entre chaves (\$1 \$1). + Dentro da estrutura aninhada, você deve usar o caractere de escape de barra invertida (\$1) antes das aspas duplas (") e do caractere de escape de barra invertida (\$1). Esse requisito significa que você usará três barras invertidas e aspas duplas para verificar se as propriedades são passadas corretamente (\$1\$1\$1"). + Para pares de nome/valor, dois-pontos (:) separa cada propriedade do valor. + Cada par de nome/valor é separado de outros por uma vírgula (,). + Várias filas são separadas por uma vírgula (,) entre o fim da chave (\$1) de uma fila e o início da chave (\$1) da próxima fila. # Criar um parameter group Para definir valores de parâmetros diferentes do grupo de parâmetros padrão, você pode criar seu próprio grupo de parâmetros. **Para criar um parameter group** 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 **Create (Criar)** para exibir a janela **Create parameter group (Criar grupo de parâmetros)**. 1. Insira um valor para **Parameter group name (Nome do grupo de parâmetros)** e **Description (Descrição)**. 1. Para criar o grupo de parâmetros, escolha **Create (Criar)**. # 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. ------ #### [ 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 ``` ------ # Criar uma regra de monitoramento de consulta Você pode usar o console do Amazon Redshift para criar e modificar regras de monitoramento de consulta WLM. Regras de monitoramento de consulta fazem parte do parâmetros de configuração do WLM para um parameter group. Se você modificar uma regra de monitoramento de consulta (QMR), a mudança acontecerá automaticamente sem a necessidade de modificar o cluster. Para obter mais informações, consulte [Regras de monitoramento de consultas do WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html). Ao criar uma regra, você define o nome de regra, um ou mais predicados e uma ação. Quando você salva a configuração do WLM incluindo uma regra, você pode visualizar o código JSON para a definição da regra como parte do JSON para o parâmetro de configuração do WLM. **Para criar uma regra de monitoramento de consulta** 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 **Gerenciamento do workload** e selecione **Editar filas de workloads** para editar a configuração do WLM. 1. Adicione uma nova regra usando um modelo predefinido ou criado do zero. Para usam um modelo predefinido, faça o seguinte: 1. Escolha **Add rule from template (Adicionar regra de modelo)** no grupo **Query monitoring rules (Regras de monitoramento de consultas)**. A listra de modelos de regras é exibida. 1. Escolha um ou mais modelos de regra. Quando você escolhe **Save (Salvar)**, o WLM cria uma regra para cada modelo que você escolher. 1. Insira ou confirme valores para a regra incluindo **Rule names (Nomes de regras)**, **Predicates (Predicados)** e **Actions (Ações)**. 1. Escolha **Salvar**. Para adicionar uma nova regra criada do zero, faça o seguinte: 1. Para adicionar mais predicados, escolha **Add predicate (Adicionar predicado)**. Você pode ter até três predicados para cada regra. Se todos os predicados são atendidos, o WLM dispara ação associada. 1. Escolha uma **Ação**. Cada regra tem uma ação. 1. Escolha **Salvar**. O Amazon Redshift gera seu parâmetro de configuração WLM no formato JSON e o exibe na seção **JSON**. # Exclusão de um grupo de parâmetros Você pode excluir um parameter group se você não for precisar mais dele e ele não estiver associado a qualquer cluster. Você pode excluir somente grupos de parâmetros personalizados. **Para excluir um parameter group** 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. Em **Parameter groups**, escolha o parameter group que deseja modificar. **nota** Não é possível excluir o grupo de parâmetros padrão. 1. Escolha **Delete (Excluir)** e confirme que deseja excluir o grupo de parâmetros.