Configuración de la administración de cargas de trabajo - Amazon Redshift
Propiedades dinámicas y estáticas de WLMPropiedades del parámetro wlm_json_configuration Configuración del parámetro wlm_json_configuration mediante la AWS CLI

Configuración de la administración de cargas de trabajo

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

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.

Propiedades del parámetro wlm_json_configuration

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í
Priority (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í
Roles 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

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

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.

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

Concurrency (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 "*" o "?" para especificar varios grupos de usuarios al ejecutar consultas. Para obtener más información, consulte 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 "*" o "?" para especificar varios grupos de consultas al ejecutar consultas. Para obtener más información, consulte 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).

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 "*" o "?" para especificar varios grupos de consultas al ejecutar consultas. Para obtener más información, consulte 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.

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

Propiedad JSON: max_execution_time

Memory (%) (Porcentaje de 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.

nota

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. Puede disponer de hasta ocho reglas por cola y el límite total para todas las colas es de ocho reglas.

    • 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 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 en la Guía para desarrolladores de bases de datos de Amazon Redshift.

Configuración del parámetro wlm_json_configuration mediante la AWS CLI

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.

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

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

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

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 ({ }).

  • Dentro de la estructura anidada, debe utilizar el carácter de escape de barra oblicua inversa (\) 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 (}) y el comienzo de la siguiente llave de la cola ({).

Reglas para la configuración de WLM mediante la AWS CLI en Windows PowerShell para los sistemas operativos Microsoft Windows

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 ({ }).

  • Dentro de la estructura anidada, debe utilizar el carácter de escape de barra oblicua inversa (\) antes de cada comilla doble (") y su carácter de escape de barra oblicua inversa (\). Este requisito significa que utilizará tres barras inversas y una comilla doble para asegurarse de que las propiedades se transfieran correctamente (\\\").

  • 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 (}) y el comienzo de la siguiente llave de la cola ({).

Reglas para la configuración de WLM mediante el símbolo del sistema en los sistemas operativos Windows

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 ({ }).

  • Dentro de la estructura anidada, debe utilizar el carácter de escape de barra oblicua inversa (\) antes de cada comilla doble (") y su carácter de escape de barra oblicua inversa (\). Este requisito significa que utilizará tres barras inversas y una comilla doble para asegurarse de que las propiedades se transfieran correctamente (\\\").

  • 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 (}) y el comienzo de la siguiente llave de la cola ({).