

 Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la [publicación del 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 de Amazon Redshift
<a name="working-with-parameter-groups"></a>

 En Amazon Redshift, puede asociar un grupo de parámetros con cada clúster que cree. Un *grupo de parámetros* es un grupo de parámetros que se aplican a todas las bases de datos que crea en el clúster. Estos parámetros establecen la configuración de la base de datos, como el tiempo de espera de consulta y el estilo de fecha. Cuando lanza un clúster, debe asociarlo a un grupo de parámetros. Si desea cambiar el grupo de parámetros en otro momento, puede modificar el clúster y seleccionar un grupo de parámetros diferente.

Cada grupo de parámetros tiene varios parámetros para la configuración de ajustes de la base de datos. La lista de parámetros disponibles depende de la familia de grupos de parámetros a la que el grupo de parámetros pertenece. La familia de grupos de parámetros predeterminados es `redshift-2.0`. 

Amazon Redshift proporciona un grupo de parámetros predeterminado para cada familia de grupos de parámetros. El grupo de parámetros predeterminado tiene valores preestablecidos para cada uno de sus parámetros y no pueden modificarse. El formato del nombre del grupo de parámetros predeterminados es `default.parameter_group_family`. Por ejemplo, el grupo de parámetros predeterminados para la familia de grupos de parámetros `redshift-2.0` es `default.redshift-2.0`. 

Si desea utilizar valores de parámetros diferentes a los del grupo de parámetros predeterminado, debe crear un grupo de parámetros personalizado y luego asociar el clúster a él. Inicialmente, los valores de los parámetros de un grupo de parámetros personalizado son los mismos que los de un grupo de parámetros predeterminado. El `source` inicial para todos los parámetros es `engine-default`, ya que los valores los establece previamente Amazon Redshift. Luego de cambiar un valor de parámetro, el `source` cambia a `user` para indicar que su valor predeterminado se ha modificado. 

**nota**  
La consola de Amazon Redshift no muestra el `source` de cada parámetro. Debe utilizar la API de Amazon Redshift, la AWS CLI o uno de los AWS SDK para ver el `source`.

Si se trata de grupos de parámetros creados por usted, puede modificar el valor de parámetro en cualquier momento o puede restablecer los valores de parámetros a sus valores predeterminados. También puede asociar un grupo de parámetros diferente a un clúster. En algunos casos, podrá modificar los valores del parámetro en un grupo de parámetros que ya está asociado a un clúster o asociar un grupo de parámetros diferentes a un clúster. En estos casos, quizás tenga que reiciar el clúster para que se aplique los valores de los parámetros actualizados. Si el clúster falla y Amazon Redshift lo reinicia, los cambios se aplican en ese momento. Si el clúster se reinicia durante el mantenimiento, no se aplican los cambios. Para obtener más información, consulte [Propiedades dinámicas y estáticas de WLM](workload-mgmt-config.md#wlm-dynamic-and-static-properties).

## Valores de parámetros predeterminados
<a name="default-param-group-values"></a>

**nota**  
 A partir del 10 de enero de 2025, el valor predeterminado para el parámetro `require_ssl` es true. Si no desea que el clúster requiera SSL, puede utilizar un grupo de parámetros personalizados al crear el clúster o modificar el clúster para asociarlo a un grupo de parámetros personalizados después de crear el clúster con el predeterminado.

En la siguiente tabla se muestran los valores de parámetros predeterminados junto con enlaces a información más exhaustiva acerca de cada parámetro. Estos son los valores predeterminados para la familia de grupos de parámetros `redshift-2.0`. 


| Nombre del parámetro | Valor | Más información | 
| --- | --- | --- | 
|  auto\$1analyze  |  true  |  [auto\$1analyze](https://docs.aws.amazon.com/redshift/latest/dg/t_Analyzing_tables.html#t_Analyzing_tables-auto-analyze) en la Guía para desarrolladores de bases de datos de Amazon Redshift  | 
|  auto\$1mv  |  true  |  [Vistas materializadas automatizadas](https://docs.aws.amazon.com/redshift/latest/dg/materialized-view-auto-mv.html) en la Guía para desarrolladores de bases de datos de Amazon Redshift | 
|  datestyle  |   ISO, MDY   |  [datestyle](https://docs.aws.amazon.com/redshift/latest/dg/r_datestyle.html) en laGuía para desarrolladores de bases de datos de 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) en laGuía para desarrolladores de bases de datos de Amazon Redshift  | 
|  enable\$1user\$1activity\$1logging  |   false   |  [Registro de auditoría de bases de datos](db-auditing.md) en esta guía  | 
|  extra\$1float\$1digits  |  0  |  [extra\$1float\$1digits](https://docs.aws.amazon.com/redshift/latest/dg/r_extra_float_digits.html) en la Guía para desarrolladores de bases de datos de 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) en la Guía para desarrolladores de bases de datos Amazon Redshift  | 
|  query\$1group  |  predeterminado   |  [query\$1group](https://docs.aws.amazon.com/redshift/latest/dg/r_query_group.html) en la Guía para desarrolladores de bases de datos de Amazon Redshift  | 
|  require\$1ssl  |  true  |  [Configuración de las opciones de seguridad para las conexiones](connecting-ssl-support.md) en esta guía  | 
|  search\$1path  |   \$1user, public   |  [search\$1path](https://docs.aws.amazon.com/redshift/latest/dg/r_search_path.html) en la Guía para desarrolladores de bases de datos de Amazon Redshift  | 
|  statement\$1timeout  |  0  |  [statement\$1timeout](https://docs.aws.amazon.com/redshift/latest/dg/r_statement_timeout.html) en la Guía para desarrolladores de bases de datos Amazon Redshift  | 
|  wlm\$1json\$1configuration  |   [\$1"auto\$1wlm":true\$1]   |  [Administración de la carga de trabajo](workload-mgmt-config.md) en esta guía | 
|  use\$1fips\$1ssl  |  false  |  Habilite el modo SSL compatible con FIPS solo si el sistema debe ser compatible con FIPS. | 

**nota**  
El parámetro `max_cursor_result_set_size` no está disponible. Para obtener más información acerca del tamaño de conjuntos de resultados de cursores, consulte [Restricciones del cursor](https://docs.aws.amazon.com/redshift/latest/dg/declare.html#declare-constraints) en la *Guía para desarrolladores de bases de datos Amazon Redshift*.

Puede anular un parámetro temporalmente utilizando el comando `SET` en la base de datos. El comando `SET` anula el parámetro solamente durante el tiempo de la sesión actual. Además de los parámetros mencionados en la tabla anterior, también puede ajustar de manera temporal el número de slots estableciendo `wlm_query_slot_count` en la base de datos. El parámetro `wlm_query_slot_count` no está disponible para su configuración en grupos de parámetros. Para obtener más información acerca del ajuste del número de slots, consulte[wlm\$1query\$1slot\$1count](https://docs.aws.amazon.com/redshift/latest/dg/r_wlm_query_slot_count.html) en la *Guía para desarrolladores de bases de datos de Amazon Redshift*. Para obtener más información acerca de la anulación temporal de otros parámetros, consulte [Modificación de la configuración del servidor](https://docs.aws.amazon.com/redshift/latest/dg/t_Modifying_the_default_settings.html) en la *Guía para desarrolladores de bases de datos de Amazon Redshift*.

# Administración de la carga de trabajo
<a name="workload-mgmt-config"></a>

En Amazon Redshift, se utiliza administración de cargas de trabajo (WLM) para definir el número de colas de consultas que están disponibles y cómo se dirigen las consultas a esas colas para su procesamiento. WLM forma parte de la configuración de grupos de parámetros. Un clúster utiliza la configuración de WLM que se especifica en su grupo de parámetros asociados. 

Cuando crea un grupo de parámetros, la configuración de WLM predeterminada contiene una cola que puede ejecutar hasta cinco consultas simultáneamente. Puede añadir colas adicionales y configurar las propiedades de WLM en cada una de ellas si desea tener más control en el procesamiento de consultas. Cada cola que añade tiene la misma configuración de WLM predeterminada hasta que configure sus propiedades.

Si añade otras colas, la última cola de la configuración será la *cola predeterminada*. A menos que la consulta se direccione a otra cola basada en criterios de la configuración de WLM, la consulta se procesa por la cola predeterminada. Puede especificar el modo y el nivel de simultaneidad (slots de consulta) de la cola predeterminada, pero no puede especificar grupos de usuarios ni grupos de consultas para dicha cola.

 Como sucede con otros parámetros, usted no puede modificar la configuración de WLM en el grupo de parámetros predeterminado. Los clústeres asociados al grupo de parámetros predeterminado siempre utilizan la configuración de WLM predeterminada. Si desea modificar la configuración de WLM, cree un nuevo grupo de parámetros y asócielo a cualquier clúster que requiera su configuración de WLM personalizada. 

## Propiedades dinámicas y estáticas de WLM
<a name="wlm-dynamic-and-static-properties"></a>

Las propiedades de configuración de WLM son dinámicas o estáticas. Puede aplicar propiedades dinámicas a la base de datos sin reiniciar el clúster, pero las propiedades estáticas requieren el reinicio del clúster para que los cambios surtan efecto. Para obtener más información sobre las propiedades estáticas y dinámicas, consulte [Propiedades de configuración dinámicas y estáticas de WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-dynamic-properties.html).

## Propiedades del parámetro de configuración de WLM
<a name="wlm-json-config-properties"></a>

Puede configurar WLM mediante la consola de Amazon Redshift, la AWS CLI, la API de Amazon Redshift o uno de los AWS SDK. La configuración de WLM usa diversas propiedades para definir el comportamiento de la cola, como la asignación de memoria entre colas, el número de consultas que se pueden ejecutar simultáneamente en una cola, etc.

**nota**  
 Las siguientes propiedades aparecen en las descripciones con los nombres de la consola de Amazon Redshift y los nombres de las propiedades JSON correspondientes. 

La tabla siguiente resume si una propiedad es aplicable a WLM automática o WLM manual.


****  

| Propiedad de WLM | WLM automática | WLM manual | 
| --- | --- | --- | 
| Auto WLM (WLM automática) | Sí | Sí | 
| Habilitar aceleración de consultas cortas | Sí | Sí | 
| Tiempo máximo de ejecución de consultas cortas | Sí | Sí | 
| Prioridad | Sí | No | 
| Tipo de cola | Sí | Sí | 
| Nombre de la cola | Sí | Sí | 
| Modo de escalado de simultaneidad | Sí | Sí | 
| Simultaneidad | No | Sí | 
| Grupos de usuarios | Sí | Sí | 
| Comodín de grupo de usuarios | Sí | Sí | 
| Grupos de consultas | Sí | Sí | 
| Comodín de grupo de consultas | Sí | Sí | 
| Funciones de usuario | Sí | Sí | 
| Comodín de rol de usuario | Sí | Sí | 
| Tiempo de espera | No | Obsoleto | 
| Memoria | No | Sí | 
| Reglas de monitorización de consultas | Sí | Sí | 

En la siguiente lista se describen las propiedades de WLM que puede configurar.

**Auto WLM (WLM automática**  
**Auto WLM (WLM automática)** establecida en `true` habilita la WLM automática. La WLM automática establece los valores para **Concurrency on main** (Simultaneidad en el principal) y **Memory (%) (Memoria (%))** de `Auto`. Amazon Redshift administra la simultaneidad de consultas y la asignación de memoria. El valor predeterminado es `true`.  
Propiedad JSON: `auto_wlm`

**Habilitar aceleración de consultas cortas**  
La aceleración de consultas cortas (SQA) da prioridad a una serie de consultas seleccionadas que se ejecutan rápidamente frente a consultas que tardan más en ejecutarse. SQA ejecuta las consultas cortas en un espacio dedicado, de forma que estas consultas no tienen que esperar en las colas detrás de otras consultas más largas. Con SQA, las consultas cortas se ejecutan con mayor rapidez y los usuarios tardan menos en ver los resultados. Si habilita SQA, también puede especificar el tiempo máximo de ejecución de las consultas cortas. Para habilitar SQA, especifique `true`. El valor predeterminado es `false`. Esta configuración se aplica a cada grupo de parámetros en lugar de a cada cola.  
Propiedad JSON: `short_query_queue`

****Tiempo máximo de ejecución de consultas cortas****  
Si habilita SQA, también puede especificar 0 para permitir que WLM establezca de forma dinámica el tiempo máximo de ejecución de las consultas cortas. Si lo desea, también puede especificar un valor entre 1 y 20 segundos, en milisegundos. El valor predeterminado es `0`.  
Propiedad JSON: `max_execution_time`

**Prioridad**  
La prioridad establece la prioridad de las consultas que se ejecutan en una cola. Para establecer la prioridad, **WLM mode (Modo de WLM)** debe estar definido en **Auto WLM (WLM automática)**; es decir, `auto_wlm` debe ser `true`. Los valores de prioridad pueden ser `highest`, `high`, `normal`, `low` y `lowest`. El valor predeterminado es `normal`.  
Propiedad JSON: `priority`

**Tipo de cola**  
El tipo de cola designa una cola tal como la utiliza **Auto WLM (WLM automática)** o **Manual WLM (WLM manual)**. Establezca `queue_type` en `auto` o `manual`. Si no se especifica, el valor predeterminado es `manual`.  
Propiedad JSON: `queue_type`

**Nombre de la cola**  
El nombre de la cola. Puede establecer el nombre de la cola en función de las necesidades de su empresa. Los nombres de cola deben ser únicos dentro de una configuración WLM, tener hasta 64 caracteres alfanuméricos, guiones bajos o espacios y no pueden contener comillas. Por ejemplo, si tiene una cola para sus consultas ETL, podría denominarla `ETL queue`. Este nombre se utiliza en métricas, valores de tabla del sistema y la consola de Amazon Redshift para identificar la cola. Las consultas e informes que utilizan el nombre a partir de estas fuentes tienen que poder controlar los cambios del nombre. Anteriormente, Amazon Redshift generaba los nombres de cola. Los nombres predeterminados de las colas son `Queue 1`, `Queue 2`, hasta la última cola denominada `Default queue`.   
Si cambia el nombre de una cola, también cambia el valor de la dimensión `QueueName` de las métricas de cola WLM (por ejemplo, WLMQueueLength, WLMQueueWaitTime, WLMQueriesCompletedPerSecond, WLMQueryDuration, WLMRunningQueries, etc.). Por lo tanto, si cambia el nombre de una cola, es posible que tenga que cambiar las alarmas de CloudWatch que ha configurado. 
Propiedad JSON: `name`

**Modo de escalado de simultaneidad**  
Para habilitar el escalado de simultaneidad en una cola, establezca **Concurrency Scaling mode (Modo de escalado de simultaneidad)** en `auto`. Cuando el número de consultas enviadas a una cola supera la simultaneidad configurada de la cola, las consultas que cumplen los requisitos se envían al clúster de escalado. Cuando hay slots disponibles, las consultas se ejecutan en el clúster principal. El valor predeterminado es `off`.  
Propiedad JSON: `concurrency_scaling`

**Simultaneidad**  
Número de consultas que pueden ejecutarse simultáneamente en una cola de WLM manual. Esta propiedad solo se aplica al WLM manual. Si el modo de escalado de simultaneidad está habilitado, las consultas que cumplen los requisitos se envían a un clúster de escalado cuando una cola alcanza el nivel de simultaneidad (slots de consulta). Si el escalado de simultaneidad no está habilitado, las consultas esperan en la cola hasta que haya un slot disponible. El rango está entre 1 y 50.  
Propiedad JSON: `query_concurrency`

**User Groups (Grupos de usuarios**  
Una lista de nombres de grupos de usuarios separada por comas. Cuando los miembros del grupo de usuarios ejecutan consultas en la base de datos, estas se direccionan a la cola que está asociada a su grupo de usuarios.  
Propiedad JSON: `user_group`

**Carácter comodín de grupos de usuarios**  
Un valor booleano que indica si se habilitan comodines para los grupos de usuarios. Si el valor es 0, los comodines están desactivados y si el valor es 1, los comodines están habilitados. Si los caracteres comodín están habilitados, puede utilizar "\$1" o "?" para especificar varios grupos de usuarios al ejecutar consultas. Para obtener más información, consulte [Wildcards](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Propiedad JSON: `user_group_wild_card`

**Grupos de consultas**  
Una lista de grupos de consultas separada por comas. Cuando los miembros del grupo de consultas ejecutan consultas en la base de datos, estas se direccionan a la cola que está asociada a su grupo de consultas.  
Propiedad JSON: `query_group`

**Carácter comodín de grupos de consultas**  
Un valor booleano que indica si se habilitan comodines para los grupos de consultas. Si el valor es 0, los comodines están desactivados y si el valor es 1, los comodines están habilitados. Si los caracteres comodín están habilitados, puede utilizar "\$1" o "?" para especificar varios grupos de consultas al ejecutar consultas. Para obtener más información, consulte [Wildcards](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Propiedad JSON: `query_group_wild_card`

**Roles de usuario**  
Una lista separada por comas de roles de usuarios. Cuando los miembros con ese rol de usuario ejecutan consultas en la base de datos, las consultas se dirigen a la cola que está asociada al rol de los usuarios. Para obtener más información sobre los roles de usuario, consulte [Control de acceso basado en roles (RBAC)](https://docs.aws.amazon.com/redshift/latest/dg/t_Roles.html).  
Propiedad JSON: `user_role`

**Comodín de roles de usuarios**  
Un valor booleano que indica si se habilitan comodines para los grupos de consultas. Si el valor es 0, los comodines están desactivados y si el valor es 1, los comodines están habilitados. Si los caracteres comodín están habilitados, puede utilizar "\$1" o "?" para especificar varios grupos de consultas al ejecutar consultas. Para obtener más información, consulte [Wildcards](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Propiedad JSON: `user_role_wild_card`

**Tiempo de espera (ms)**  
El tiempo de espera de WLM (`max_execution_time`) no está disponible. Si no está disponible cuando se utiliza WLM automática. En su lugar, cree una regla de monitorización de consultas (QMR) utilizando `query_execution_time` para limitar el tiempo de ejecución transcurrido de una consulta. Para obtener más información, consulte [Reglas de monitoreo de consultas de WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html).   
El tiempo máximo, en milisegundos, en el que se pueden ejecutar las consultas antes de ser canceladas. En algunos casos, una consulta de solo lectura, como por ejemplo una instrucción SELECT, podría cancelarse debido al tiempo de espera de WLM. En estos casos, WLM intenta direccionarla a la siguiente cola coincidente en función de las reglas de asignación de colas de WLM. Si la consulta no coincide con ninguna otra definición de cola, esta no se asigna a la cola predeterminada, sino que se cancela. Para obtener más información, consulte [Salto de cola de consultas de WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-queue-hopping). El tiempo de espera de WLM no aplica a una consulta que haya alcanzado el estado `returning`. Para ver el estado de una consulta, diríjase a la tabla de sistema [STV\$1WLM\$1QUERY\$1STATE](https://docs.aws.amazon.com/redshift/latest/dg/r_STV_WLM_QUERY_STATE.html).  
Propiedad JSON: `max_execution_time`

**Memoria (%)**  
El porcentaje de memoria para asignar a la cola. Si especifica un porcentaje de memoria para al menos una de las colas, debe especificar un porcentaje para todas las otras colas hasta llegar a un total de 100 por ciento. Si la asignación de memoria es inferior al 100 por cien en todas las colas, el servicio administra la memoria sin asignar. El servicio puede entregar temporalmente esta memoria sin asignar a una cola que solicita memoria adicional para el procesamiento.  
Propiedad JSON: `memory_percent_to_use`

**Reglas de monitorización de consultas**  
Puede utilizar las reglas de monitorización de consultas de WLM para monitorear de forma continua las colas de WLM de consultas basadas en criterios o predicados que usted especificó. Por ejemplo, es posible que monitoree consultas que tiendan a consumir recursos excesivos del sistema y luego inicie una acción especificada cuando la consulta exceda los límites de rendimiento especificados.   
Si decide crear reglas mediante programación, recomendamos encarecidamente utilizar la consola para generar el JSON que incluirá en la definición del grupo de parámetros.
Asocie una regla de monitorización de consultas a una cola de consultas específica. Puede tener hasta 25 reglas por cola y el límite total para todas las colas es 25 reglas.  
Propiedad JSON: `rules`  
Jerarquía de propiedades JSON:   

```
rules
    rule_name
    predicate
        metric_name
        operator
        value
    action
        value
```
Especifique las siguientes propiedades para cada regla:  
+ `rule_name`: los nombres de reglas deben ser únicos en la configuración de WLM. Los nombres de reglas pueden tener un máximo de 32 caracteres alfanuméricos o guiones bajos y no pueden contener espacios ni comillas.
  + `predicate`: puede tener hasta tres predicados por regla. Especifique las siguientes propiedades para cada predicado:
    + `metric_name`: para obtener una lista de métricas, consulte [Métricas de monitoreo de consultas](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html#cm-c-wlm-query-monitoring-metrics) en la *Guía para desarrolladores de bases de datos de Amazon Redshift*.
    + `operator`: las operaciones son `=`, `<` y `>`. 
    + `value`: el valor de límite de la métrica especificada que desencadena una acción. 
+ `action`: cada regla está asociada a una acción. Las acciones válidas son:
  + `log`
  + `hop` (solo disponible con WLM manual)
  + `abort`
  + `change_query_priority` (solo disponible con WLM automática)
En el siguiente ejemplo se muestra el JSON para una regla de monitorización de consultas de WLM denominada `rule_1`, con dos predicados y la acción `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 obtener más información acerca de cada una de estas propiedades y estrategias para la configuración de colas de consultas, consulte [Implementación de administración de cargas de trabajo](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-implementing-workload-management.html) en la *Guía para desarrolladores de bases de datos de Amazon Redshift*. 

## Configuración del parámetro de WLM mediante AWS CLI
<a name="Configuring-the-wlm-json-configuration-Parameter"></a>

 Para configurar WLM, modifique el parámetro `wlm_json_configuration`. El tamaño máximo del valor de la propiedad `wlm_json_configuration` es de 8000 caracteres. El valor tiene el formato de JavaScript Object Notation (JSON). Si configura WLM a través de la AWS CLI, la API de Amazon Redshift o uno de los AWS SDK, utilice el resto de esta sección para aprender a crear la estructura JSON del parámetro `wlm_json_configuration`. 

**nota**  
 Si configura WLM mediante la consola de Amazon Redshift, no necesitará comprender el formato JSON, ya que la consola proporciona una forma sencilla de agregar colas y configurar sus propiedades. Para obtener más información acerca de la configuración de WLM mediante la consola, consulte [Modificación de un grupo de parámetros](parameter-group-modify.md). 

Ejemplo

En el siguiente ejemplo se muestra la configuración de WLM predeterminada, que define una cola con la WLM automática. 

```
{
   "auto_wlm": true
}
```

Ejemplo

En el siguiente ejemplo, se muestra una configuración de WLM personalizada que define una cola de WLM manual con un nivel de simultaneidad (slots de consulta) de cinco. 

```
{
   "query_concurrency":5
}
```

Sintaxis

La configuración de WLM predeterminada es muy sencilla, tiene cola única y una propiedad. Puede añadir más colas y configurar varias propiedades para cada cola en la estructura JSON. La siguiente sintaxis representa la estructura JSON que se utiliza para configurar varias colas con varias propiedades: 

```
[
   {
      "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", 
                ...
             }
             ...

         ]"
   }
]
```

En el ejemplo anterior, las propiedades representativas que comienzan con **q1** son objetos de una matriz de la primera cola. Cada uno de estos objetos es un par de nombre/valor. `name` y `value` establecen juntos las propiedades de WLM para la primera cola. Las propiedades representativas que comienzan con **q2** son objetos de una matriz de la segunda cola. Si necesita más colas, añada otra matriz para cada cola adicional y establezca las propiedades de cada objeto.

 Cuando modifica la configuración de WLM, debe incluir toda la estructura para las colas, aunque solo desee cambiar una propiedad dentro de una cola. Esto se debe a que toda la estructura JSON se transfiere en forma de cadena como el valor para el parámetro `wlm_json_configuration`. 

### Formateo del comando de AWS CLI
<a name="construct-json-param-value"></a>

El parámetro `wlm_json_configuration` requiere un formato específico cuando utiliza la AWS CLI. El formato que utilice depende del sistema operativo del cliente. Los sistemas operativos tienen formas diferentes de delimitar la estructura JSON para que se transfiera correctamente desde la línea de comando. Para ver detalles acerca de cómo construir el comando adecuado en los sistemas operativos de Windows, Mac OS X y Linux, consulte las siguientes secciones. Para obtener más información acerca de las diferencias en la delimitación de estructuras de datos JSON en la AWS CLI en general, consulte [Entrecomillado de cadenas](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#quoting-strings) en la *Guía del usuario de AWS Command Line Interface*.

Ejemplos

En el comando de ejemplo siguiente se configura WLM manual para un grupo de parámetros denominado `example-parameter-group`. La configuración permite la aceleración de las consultas cortas con un tiempo de ejecución máximo establecido en 0, lo que le indica a WLM que debe establecer el valor dinámicamente. El valor de `ApplyType` es `dynamic`. Esta opción significa que cualquier cambio que se realice en las propiedades dinámicas del parámetro se aplicarán de inmediato, a menos que se hayan realizado otros cambios estáticos en la configuración. La configuración define tres colas con lo siguiente: 
+  La primera cola permite a los usuarios especificar `report` como una etiqueta (como se especifica en la propiedad `query_group`) en sus consultas para ayudar a direccionar las consultas a esa cola. Se pueden realizar búsquedas con caracteres comodín de la etiqueta `report*`, por lo que no es necesario que la etiqueta sea exacta para que las consultas se direccionen a la cola. Por ejemplo, `reports` y `reporting` también coincidirán con este grupo de consultas. La cola tiene asignado el 25 por ciento del total de memoria entre todas las colas y puede ejecutar hasta cuatro consultas al mismo tiempo. Las consultas se limitan a un tiempo máximo de 20.000 milisegundos (ms). El modo se establece en automático, por tanto cuando los slots de consulta de la cola cumplen los requisitos las consultas se envían a un clúster de escalado. 
+  La segunda cola habilita a los usuarios miembros de grupos `admin` o `dba` en la base de datos a que sus consultas se direccionen a la cola para su procesamiento. Las búsquedas de comodín están desactivadas para los grupos de usuarios, por lo que los usuarios deben coincidir de forma exacta con los grupos de la base de datos para que sus consultas se direccionen a la cola. La cola tiene asignado el 40 por ciento del total de memoria entre todas las colas y puede ejecutar hasta cinco consultas al mismo tiempo. El modo se establece como desactivado, de forma que todas las consultas enviadas por miembros del administrador o grupos de dba se ejecutan en el clúster principal.
+  La última cola de la configuración es la cola predeterminada. A esta cola se le asigna el 35 por ciento del total de memoria entre todas las colas y puede procesar hasta cinco consultas a la vez. El modo se establece en automático. 

**nota**  
 El ejemplo se muestra en varias líneas por fines ilustrativos. Los comandos reales no deben tener saltos de línea. 

```
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}
]'
```

A continuación se muestra un ejemplo de configuración de las reglas de monitorización de consultas de WLM para una configuración de WLM automática. El ejemplo crea un grupo de parámetros denominado `example-monitoring-rules`. La configuración define las tres mismas colas que las del ejemplo anterior, pero `query_concurrency` y `memory_percent_to_use` ya no se especifican. La configuración añade además las siguientes reglas y prioridades de consulta:
+ La primera cola define una regla denominada `rule_1`. La regla tiene dos predicados: `query_cpu_time > 10000000` y `query_blocks_read > 1000`. La acción de la regla es `log`. La prioridad de esta cola es `Normal`. 
+ La segunda cola define una regla denominada `rule_2`. La regla tiene dos predicados: `query_execution_time > 600000000` y `scan_row_count > 1000000000`. La acción de la regla es `abort`. La prioridad de esta cola es `Highest`. 
+ La última cola de la configuración es la cola predeterminada. La prioridad de esta cola es `Low`. 

**nota**  
 El ejemplo se muestra en varias líneas por fines ilustrativos. Los comandos reales no deben tener saltos de línea. 

```
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
} ]'
```

#### Configuración de WLM mediante la AWS CLI en la línea de comandos con un archivo JSON
<a name="wlm-cli-json-file"></a>

Puede modificar el parámetro `wlm_json_configuration` utilizando la AWS CLI y pasarlo al valor del argumento `parameters` como un archivo JSON.

```
aws redshift modify-cluster-parameter-group --parameter-group-name myclusterparaametergroup --parameters file://modify_pg.json 
```

Los argumentos de `--parameters` se almacenan en el archivo `modify_pg.json`: La ubicación del archivo se especifica en el formato del sistema operativo. Para obtener más información, consulte [Carga de parámetros desde un archivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html#cli-usage-parameters-file). A continuación, se muestran ejemplos del contenido del archivo 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"
    }
]
```

#### Reglas para la configuración de WLM mediante la AWS CLI en la línea de comandos de los sistemas operativos Mac OS X y Linux
<a name="wlm-cli-linux-and-mac"></a>

Siga estas reglas para ejecutar un comando de la AWS CLI con parámetros en una sola línea:
+ Toda la estructura JSON debe estar separada por comillas simples (') y un conjunto de corchetes ([ ]). 
+ Todos los nombres y valores de los parámetros deben estar separados por comillas dobles (").
+ Dentro del valor `ParameterValue`, debe separar toda la estructura anidada por comillas dobles (") y corchetes ([ ]).
+ Dentro de la estructura anidada, cada una de las propiedades y los valores para cada cola deben estar separados por llaves (\$1 \$1).
+ Dentro de la estructura anidada, debe utilizar el carácter de escape de barra oblicua inversa (\$1) antes de cada comilla doble (").
+ Para los pares de nombre/valor, los dos puntos (:) separan cada propiedad de su valor.
+ Cada par nombre/valor se separa del otro por una coma (,).
+ Las colas múltiples se separan con una coma (,) entre el final de la llave de una cola (\$1) y el comienzo de la siguiente llave de la cola (\$1).

#### Reglas para la configuración de WLM mediante la AWS CLI en Windows PowerShell para los sistemas operativos Microsoft Windows
<a name="wlm-cli-windows-powershell"></a>

Siga estas reglas para ejecutar un comando de la AWS CLI con parámetros en una sola línea:
+ Toda la estructura JSON debe estar separada por comillas simples (') y un conjunto de corchetes ([ ]).
+ Todos los nombres y valores de los parámetros deben estar separados por comillas dobles (").
+ Dentro del valor `ParameterValue`, debe separar toda la estructura anidada por comillas dobles (") y corchetes ([ ]).
+ Dentro de la estructura anidada, cada una de las propiedades y los valores para cada cola deben estar separados por llaves (\$1 \$1).
+ Dentro de la estructura anidada, debe utilizar el carácter de escape de barra oblicua inversa (\$1) antes de cada comilla doble (") y su carácter de escape de barra oblicua inversa (\$1). Este requisito significa que utilizará tres barras inversas y una comilla doble para asegurarse de que las propiedades se transfieran correctamente (\$1\$1\$1").
+ Para los pares de nombre/valor, los dos puntos (:) separan cada propiedad de su valor.
+ Cada par nombre/valor se separa del otro por una coma (,).
+ Las colas múltiples se separan con una coma (,) entre el final de la llave de una cola (\$1) y el comienzo de la siguiente llave de la cola (\$1).

#### Reglas para la configuración de WLM mediante el símbolo del sistema en los sistemas operativos Windows
<a name="wlm-cli-cmd-windows"></a>

Siga estas reglas para ejecutar un comando de la AWS CLI con parámetros en una sola línea:
+ Toda la estructura JSON debe estar separada por comillas dobles (") y un conjunto de corchetes ([ ]).
+ Todos los nombres y valores de los parámetros deben estar separados por comillas dobles (").
+ Dentro del valor `ParameterValue`, debe separar toda la estructura anidada por comillas dobles (") y corchetes ([ ]).
+ Dentro de la estructura anidada, cada una de las propiedades y los valores para cada cola deben estar separados por llaves (\$1 \$1).
+ Dentro de la estructura anidada, debe utilizar el carácter de escape de barra oblicua inversa (\$1) antes de cada comilla doble (") y su carácter de escape de barra oblicua inversa (\$1). Este requisito significa que utilizará tres barras inversas y una comilla doble para asegurarse de que las propiedades se transfieran correctamente (\$1\$1\$1").
+ Para los pares de nombre/valor, los dos puntos (:) separan cada propiedad de su valor.
+ Cada par nombre/valor se separa del otro por una coma (,).
+ Las colas múltiples se separan con una coma (,) entre el final de la llave de una cola (\$1) y el comienzo de la siguiente llave de la cola (\$1).

# Creación de un grupo de parámetros
<a name="parameter-group-create"></a>

Si desea establecer valores de parámetros diferentes a los del grupo de parámetros predeterminado, puede crear un grupo de parámetros personalizado. 

**Para crear un grupo de parámetros**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon Redshift en [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/).

1. En el menú de navegación, elija **Configurations** (Configuraciones) y, a continuación, elija **Workload management (Administración de la carga de trabajo)** para mostrar la página de **Workload management (Administración de la carga de trabajo)**. 

1. Seleccione **Create (Crear)** para mostrar la ventana de **Create parameter group (Crear grupo de parámetros)**. 

1. Introduzca un valor para **Parameter group name (Nombre de grupo de parámetros)** y **Description (Descripción)**. 

1. Haga clic en **Create (Crear)** para crear el grupo de parámetros,. 

# Modificación de un grupo de parámetros
<a name="parameter-group-modify"></a>

Puede consultar cualquier grupo de parámetros de para ver un resumen de los valores de los parámetros y la configuración de administración de cargas de trabajo (WLM). Puede modificar parámetros para cambiar la configuración de los parámetros y las propiedades de la configuración de WLM. 

**nota**  
No puede modificar el grupo de parámetros predeterminado.

------
#### [ Consola de administración de AWS ]

En la consola, los grupos de parámetros se muestran en la pestaña **Parámetros** y las **Colas de carga de trabajo** se muestran en la pestaña **Administración de cargas de trabajo**. 

**Para modificar un grupo de parámetros**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon Redshift en [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/).

1. En el menú de navegación, elija **Configurations** (Configuraciones) y, a continuación, elija **Workload management (Administración de la carga de trabajo)** para mostrar la página de **Workload management (Administración de la carga de trabajo)**. 

1. Seleccione el grupo de parámetros que desee modificar para mostrar la página de detalles con pestañas para **Parameters (Parámetros)** y **Workload management (Administración de la carga de trabajo)**. 

1. Haga clic en la pestaña **Parameters (Parámetros)** para ver la configuración de parámetros actual. 

1. Haga clic en **Edit parameters (Editar parámetros)** para permitir cambiar la configuración de estos 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 obtener más información sobre estos parámetros, consulte [Grupos de parámetros de Amazon Redshift](working-with-parameter-groups.md). 

1. Introduzca sus cambios y luego haga clic en **Save (Guardar)** para actualizar el grupo de parámetros. 

**Para modificar la configuración de WLM en un grupo de parámetros**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon Redshift en [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/).

1. En el menú de navegación, elija **Configurations** (Configuraciones) y, a continuación, elija **Workload management (Administración de la carga de trabajo)** para mostrar la página de **Workload management (Administración de la carga de trabajo)**. 

1. Seleccione el grupo de parámetros que desee modificar para mostrar la página de detalles con pestañas para **Parameters (Parámetros)** y **Workload management (Administración de la carga de trabajo)**. 

1. Seleccione la pestaña **Workload management (Administración de cargas de trabajo)** para ver la configuración actual de WLM. 

1. Elija **Editar las colas de carga de trabajo** para editar la configuración de WLM. 

1. (Opcional) Seleccione **Enable short query acceleration (Habilitar aceleración de consultas cortas, SQA)** para habilitarlas.

   Si se habilita SQA, **Maximum run time for short queries (1 to 20 seconds) [Tiempo máximo de ejecución para consultas cortas (de 1 a 20 segundos)]** se establece en **Dynamic (Dinámico)** de forma predeterminada. Para establecer el tiempo de ejecución máximo en un valor fijo, elija un valor comprendido entre 1 y 20.

1. Realice una o más de las siguientes acciones para modificar la configuración de la cola: 
   + Elija **Switch WLM mode (Cambiar modo de WLM)** para elegir entre **Auto WLM (WLM automática)** y **Manual WLM (WLM manual)**.

     Con **Auto WLM (WLM automática)**, los valores de **Memory (Memoria)** and **Concurrency on main (Simultaneidad en principal)** se establecen en **auto (automático)**.
   + Para crear una cola, seleccione **Edit workload queues (Editar colas de cargas de trabajo)** y seleccione **Add Queue (Añadir cola)**.
   + Para modificar una cola, cambie los valores de propiedad en la tabla. En función del tipo de cola, las propiedades pueden incluir las siguientes:
     + **Queue name (Nombre de cola)** no se puede cambiar. 
     + **Memoria (%)**
     + **Concurrency on main cluster (Simultaneidad en clúster principal)**
     + El valor de **Concurrency Scaling mode (Modo de escalado de simultaneidad)** puede ser **off (desactivado)** o **auto (automático)**.
     + **Tiempo de espera (ms)**
     + **Grupos de usuarios**
     + **Grupos de consultas**
     + **Roles de usuario**

     Para obtener más información sobre estas propiedades, consulte [Propiedades del parámetro de configuración de WLM](workload-mgmt-config.md#wlm-json-config-properties).
**importante**  
Si cambia el nombre de una cola, también cambia el valor de la dimensión `QueueName` de las métricas de cola WLM (por ejemplo, WLMQueueLength, WLMQueueWaitTime, WLMQueriesCompletedPerSecond, WLMQueryDuration, WLMRunningQueries, etc.). Por lo tanto, si cambia el nombre de una cola, es posible que tenga que cambiar las alarmas de CloudWatch que ha configurado. 
   + Para cambiar el orden de las colas, seleccione los botones de las flechas **Up (Arriba)** y **Down (Abajo)**. 
   + Para eliminar una cola, seleccione el botón **Delete (Eliminar)** en la fila de la cola de la tabla.

1. (Opcional) Seleccione **Defer dynamic changes until reboot (Aplazar cambios dinámicos hasta reiniciar)**. para que se apliquen los cambios a los clústeres hasta el próximo reinicio.
**nota**  
Algunos cambios requieren un reinicio del clúster independientemente de esta configuración. Para obtener más información, consulte [Propiedades dinámicas y estáticas de WLM](workload-mgmt-config.md#wlm-dynamic-and-static-properties).

1. Seleccione **Save**.

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

 Para configurar los parámetros de Amazon Redshift con la AWS CLI, utilice el comando [modify-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/redshift/modify-cluster-parameter-group.html) en un grupo de parámetros específico. Especifique el grupo de parámetros a modificar en `parameter-group-name`. Utilice el parámetro `parameters` (para el comando `modify-cluster-parameter-group`) para especificar los pares de nombre/valor de cada parámetro que desea modificar en el grupo de parámetros. 

**nota**  
Existen consideraciones especiales cuando se configura el parámetro `wlm_json_configuration` mediante la AWS CLI. Los ejemplos de esta sección aplican a todos los parámetros, excepto `wlm_json_configuration`. Para obtener más información acerca de la configuración de `wlm_json_configuration` mediante la AWS CLI, consulte [Administración de la carga de trabajo](workload-mgmt-config.md). 

Luego de modificar los valores de parámetros, debe reiniciar cualquier clúster que esté asociado al grupo de parámetros modificado. El estado del clúster muestra `applying` para el `ParameterApplyStatus` durante la aplicación de los valores y `pending-reboot` después de que se han aplicado los valores. Luego de reiniciar, la base de datos del clúster comienza a utilizar los nuevos valores de parámetros. Para obtener más información acerca del reinicio de clústeres, consulte [Reinicio de un clúster](reboot-cluster.md). 

**nota**  
El parámetro `wlm_json_configuration` contiene algunas propiedades que son dinámicas y no requieren el reinicio de los clústeres asociados para que se apliquen los cambios. Para obtener más información acerca de las propiedades dinámicas y estáticas, consulte [Propiedades dinámicas y estáticas de WLM](workload-mgmt-config.md#wlm-dynamic-and-static-properties). 

 La siguiente sintaxis muestra cómo utilizar el comando `modify-cluster-parameter-group` para configurar un parámetro. Especifique *parameter\$1group\$1name* y reemplace *parameter\$1name* y *parameter\$1value* por un parámetro real que desee modificar y un valor para ese parámetro. Si desea modificar más de un parámetro al mismo tiempo, separe con un espacio cada parámetro y valor establecido del siguiente. 

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

 En el siguiente ejemplo, se muestra cómo configurar los parámetros `statement_timeout` y `enable_user_activity_logging` para el grupo de parámetros `myclusterparametergroup`. 

**nota**  
 Por fines de legibilidad, el ejemplo se muestra en varias líneas pero, en la AWS CLI real, se ve en una línea. 

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

------

# Creación de una regla de supervisión de consultas
<a name="parameter-group-modify-qmr-console"></a>

Puede usar la consola de Amazon Redshift para crear y modificar reglas de monitoreo de consultas de WLM. Las reglas de monitorización de consultas forman parte del parámetro de configuración de WLM para un grupo de parámetros. Si se modifica una regla de monitoreo de consultas (QMR), el cambio se produce automáticamente sin necesidad de modificar el clúster. Para obtener más información, consulte [Reglas de monitoreo de consultas de WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html). 

Cuando crea une regla, define el nombre de la regla, uno o más predicados y una acción. 

Cuando guarda configuración de WLM que incluye una regla, puede ver el código JSON para la definición de la regla como parte del JSON para el parámetro de configuración de WLM. 



**Para crear una regla de monitorización de consultas**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon Redshift en [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/).

1. En el menú de navegación, elija **Configurations** (Configuraciones) y, a continuación, elija **Workload management (Administración de la carga de trabajo)** para mostrar la página de **Workload management (Administración de la carga de trabajo)**. 

1. Seleccione el grupo de parámetros que desee modificar para mostrar la página de detalles con pestañas para **Parameters (Parámetros)** y **Workload management (Administración de la carga de trabajo)**. 

1. Seleccione la pestaña **Administración cargas de trabajo** y seleccione **Editar las colas de carga de trabajo** para editar la configuración de WLM.

1. Añada una nueva regla utilizando una plantilla predefinida o desde cero. 

   Para usar una plantilla predefinida, haga lo siguiente: 

   1. Seleccione **Add rule from template (Añadir regla desde plantilla)** en el grupo **Query monitoring rules (Reglas de monitorización de consultas)**. Se muestra la lista de plantillas de regla. 

   1. Seleccione una o varias plantillas de regla. Cuando selecciona **Save (Guardar)**, WLM crea una regla para cada plantilla que selecciona. 

   1. Introduzca o confirme los valores de la regla, incluyendo **Rule names (Nombres de regla)**, **Predicates (Predicados)** y **Actions (Acciones)**. 

   1. Seleccione **Save**. 

   Para añadir una nueva regla desde cero, haga lo siguiente:

   1. Para añadir predicados adicionales, seleccione **Add predicate (Añadir predicado)**. Puede tener hasta tres predicados por regla. Si se cumplen todos los predicados, WLM desencadena la acción asociada. 

   1. Seleccione una acción en **Action (Acción)**. Cada regla tiene una acción.

   1. Seleccione **Save**.

Amazon Redshift genera su parámetro de configuración WLM en formato JSON y lo muestra en la sección **JSON**. 

# Eliminación de un grupo de parámetros
<a name="parameter-group-delete"></a>

Puede eliminar un grupo de parámetros si ya no lo necesita y si no está asociado a clústeres. Solo puede eliminar grupos de parámetros personalizados.

**Para eliminar un grupo de parámetros**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon Redshift en [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/).

1. En el menú de navegación, elija **Configurations** (Configuraciones) y, a continuación, elija **Workload management (Administración de la carga de trabajo)** para mostrar la página de **Workload management (Administración de la carga de trabajo)**. 

1. En **Parameter groups (Grupos de parámetros)**, seleccione el grupo de parámetros que desea modificar.
**nota**  
No puede eliminar el grupo de parámetros predeterminado.

1. Seleccione **Action (Acción)** y confirme que desea eliminar el grupo de parámetros. 