

 Amazon Redshift non supporterà più la creazione di nuovi Python UDFs a partire dalla Patch 198. Python esistente UDFs continuerà a funzionare fino al 30 giugno 2026. Per ulteriori informazioni, consulta il [post del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Gruppi di parametri di Amazon Redshift.
<a name="working-with-parameter-groups"></a>

 In Amazon Redshift, a ogni cluster creato è associato un gruppo di parametri. Un *gruppo di parametri* è un insieme di parametri che vengono applicati a tutti i database creati nel cluster. Questi parametri configurano le impostazioni dei database, come timeout di query e stile delle date. Quando si avvia un cluster, è necessario associarlo a un gruppo di parametri. Se intendi cambiare il gruppo di parametri successivamente, puoi modificare il cluster e scegliere un gruppo di parametri differente.

Ogni gruppo di parametri include vari parametri per configurare le impostazioni del database. L'elenco di parametri disponibili dipende dalla famiglia di gruppi di parametri a cui il gruppo di parametri appartiene. La famiglia del gruppo di parametri predefinito è `redshift-2.0`. 

Amazon Redshift fornisce un gruppo di parametri di default per ogni famiglia di gruppi di parametri. Il gruppo di parametri predefinito comporta valori preimpostati per ognuno dei parametri e non può essere modificato. Il formato del nome del gruppo di parametri predefinito è `default.parameter_group_family`. Ad esempio, il gruppo di parametri predefinito per la famiglia del gruppo di parametri `redshift-2.0` è `default.redshift-2.0`. 

Se intendi utilizzare valori di parametri differenti da quelli del gruppo di parametri predefinito, è necessario creare un gruppo di parametri personalizzato e associarlo al tuo cluster. Inizialmente, i valori dei parametri di un gruppo di parametri personalizzato sono identici a quelli del gruppo di parametri predefinito. L'`source` iniziale per tutti i parametri è `engine-default` perché i valori sono preimpostati da Amazon Redshift. Dopo la modifica di un valore di parametro, `source` diventa `user` a indicare che il valore è stato modificato rispetto al relativo valore predefinito. 

**Nota**  
La console Amazon Redshift non visualizza l'`source` di ogni parametro. È necessario utilizzare l'API Amazon Redshift, il AWS CLI, o uno dei seguenti AWS SDKs per visualizzare il. `source`

Per i gruppi di parametri che crei, puoi modificare un valore di parametro in qualsiasi momento oppure ripristinare i valori predefiniti di tutti i parametri. Puoi inoltre associare un differente gruppo di parametri a un cluster. In alcuni casi, puoi modificare i valori dei parametri in un gruppo di parametri già associato al cluster o associare un gruppo di parametri diversi a un cluster. In questi casi, potrebbe essere necessario riavviare il cluster affinché i valori aggiornati dei parametri abbiano validità. Se il cluster riporta un errore e viene riavviato da Amazon Redshift, le modifiche vengono applicate in quel momento. Se il cluster viene riavviato durante la manutenzione, le modifiche non vengono applicate. Per ulteriori informazioni, consultare [Proprietà WLM dinamiche e statiche](workload-mgmt-config.md#wlm-dynamic-and-static-properties).

## Valori di parametro predefiniti
<a name="default-param-group-values"></a>

**Nota**  
 A partire dal 10 gennaio 2025, il valore predefinito per il parametro `require_ssl` è true. Se non desideri che il cluster richieda SSL, puoi utilizzare un gruppo di parametri personalizzato durante la creazione del cluster oppure puoi modificare il cluster per associarlo a un gruppo di parametri personalizzato dopo avere creato il cluster con quello predefinito.

La tabella seguente mostra i valori di parametro predefiniti con collegamenti a informazioni più dettagliate su ogni parametro. Questi sono i valori predefiniti per la famiglia del gruppo di parametri `redshift-2.0`. 


| Nome del parametro | Valore | Ulteriori informazioni | 
| --- | --- | --- | 
|  auto\$1analyze  |  true  |  [auto\$1analyze](https://docs.aws.amazon.com/redshift/latest/dg/t_Analyzing_tables.html#t_Analyzing_tables-auto-analyze) nella Guida per gli sviluppatori di database di Amazon Redshift  | 
|  auto\$1mv  |  true  |  [Viste materializzate automatizzate](https://docs.aws.amazon.com/redshift/latest/dg/materialized-view-auto-mv.html) nella Guida per sviluppatori del database di Amazon Redshift | 
|  datestyle  |   ISO, MDY   |  [datestyle](https://docs.aws.amazon.com/redshift/latest/dg/r_datestyle.html) nella Guida per gli sviluppatori di database di 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) nella Guida per gli sviluppatori di database di Amazon Redshift  | 
|  enable\$1user\$1activity\$1logging  |   false   |  [Logging di controllo dei database](db-auditing.md) in questa guida  | 
|  extra\$1float\$1digits  |  0  |  [extra\$1float\$1digits](https://docs.aws.amazon.com/redshift/latest/dg/r_extra_float_digits.html) nella Guida per gli sviluppatori di database di 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) nella Guida per gli sviluppatori di di database di Amazon Redshift  | 
|  query\$1group  |  default   |  [query\$1group](https://docs.aws.amazon.com/redshift/latest/dg/r_query_group.html) nella Guida per gli sviluppatori di database di Amazon Redshift  | 
|  require\$1ssl  |  true  |  [Configurazione delle opzioni di sicurezza per le connessioni](connecting-ssl-support.md) in questa guida  | 
|  search\$1path  |   \$1user, public   |  [search\$1path](https://docs.aws.amazon.com/redshift/latest/dg/r_search_path.html) nella Guida per gli sviluppatori di database di Amazon Redshift  | 
|  statement\$1timeout  |  0  |  [statement\$1timeout](https://docs.aws.amazon.com/redshift/latest/dg/r_statement_timeout.html) nella Guida per gli sviluppatori di database di Amazon Redshift  | 
|  wlm\$1json\$1configuration  |   [\$1"auto\$1wlm":true\$1]   |  [Gestione dei carichi di lavoro](workload-mgmt-config.md) in questa guida | 
|  use\$1fips\$1ssl  |  false  |  Abilita la modalità SSL conforme a FIPS solo se il sistema deve essere conforme a FIPS. | 

**Nota**  
Il parametro `max_cursor_result_set_size` è obsoleto. Per ulteriori informazioni sulla dimensione del set di risultati del cursore, consultare [Vincoli del cursore](https://docs.aws.amazon.com/redshift/latest/dg/declare.html#declare-constraints) nella *Guida per gli sviluppatori di database di Amazon Redshift*.

Puoi ignorare temporaneamente un parametro utilizzando il comando `SET` nel database. Il comando `SET` ignora il parametro soltanto per la durata della sessione corrente. Oltre ai parametri elencati nella tabella precedente, puoi anche regolare temporaneamente il numero di slot impostando `wlm_query_slot_count` nel database. Il parametro `wlm_query_slot_count` non è disponibile per la configurazione nei gruppi di parametri. Per ulteriori informazioni sulla regolazione del numero di slot, consultare [wlm\$1query\$1slot\$1count](https://docs.aws.amazon.com/redshift/latest/dg/r_wlm_query_slot_count.html) nella *Guida per gli sviluppatori di database di Amazon Redshift*. Per ulteriori informazioni su come ignorare temporaneamente gli altri parametri, consultare [Modifica della configurazione del server](https://docs.aws.amazon.com/redshift/latest/dg/t_Modifying_the_default_settings.html) nella *Guida per gli sviluppatori di database di Amazon Redshift*.

# Gestione dei carichi di lavoro
<a name="workload-mgmt-config"></a>

In Amazon Redshift, viene utilizzata la gestione del carico di lavoro (WLM) per definire il numero di code di query disponibili e il modo in cui le query sono instradate a tali code per l'elaborazione. WLM è parte della configurazione del gruppo di parametri. Un cluster utilizza la configurazione WLM specificata nel relativo gruppo di parametri associato. 

Quando crei un gruppo di parametri, la configurazione WLM predefinita contiene una coda che può eseguire fino a cinque query contemporaneamente. Puoi aggiungere ulteriori code e configurare le proprietà WLM in ognuna se vuoi avere un maggiore controllo sull'elaborazione delle query. Ogni coda aggiunta ha la stessa configurazione WLM predefinita fino a che non ne configuri le proprietà.

Quando aggiungi ulteriori code, l'ultima nella configurazione è la *code predefinita*. A meno che una query non sia instradata a un'altra coda in base ai criteri nella configurazione WLM, viene elaborata dalla coda predefinita. È possibile specificare la modalità e il livello di simultaneità (slot di query) per la coda predefinita, ma non è possibile specificare i gruppi di utenti o i gruppi di query per la coda predefinita.

 Come per gli altri parametri, non puoi modificare la configurazione WLM nel gruppo di parametri predefinito. I cluster associati al gruppo di parametri predefinito utilizzano sempre la configurazione WLM predefinita. Per modificare la configurazione WLM, crea un nuovo gruppo di parametri e quindi associa quel gruppo a un cluster che richiede la configurazione WLM personalizzata. 

## Proprietà WLM dinamiche e statiche
<a name="wlm-dynamic-and-static-properties"></a>

Le proprietà della configurazione WLM sono dinamiche o statiche. Puoi applicare proprietà dinamiche al database senza riavviare il cluster, ma le proprietà statiche richiedono un riavvio del cluster affinché le modifiche abbiano effetto. Per ulteriori informazioni sulle proprietà statiche e dinamiche, consultare [Proprietà WLM dinamiche e statiche](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-dynamic-properties.html).

## Proprietà del parametro di configurazione WLM
<a name="wlm-json-config-properties"></a>

Puoi configurare WLM utilizzando la console Amazon Redshift, AWS CLI l'API Amazon Redshift o uno dei. AWS SDKs La configurazione WLM utilizza varie proprietà per definire il comportamento delle code, come l'allocazione di memoria tra le code, il numero di query eseguibili contemporaneamente in una coda e così via.

**Nota**  
 Le seguenti proprietà vengono visualizzate con i relativi nomi della console Amazon Redshift, con i nomi delle proprietà JSON corrispondenti nelle descrizioni. 

La tabella seguente riepiloga se una proprietà e applicabile a WLM automatico o a WLM manuale.


****  

| Proprietà WLM | WLM automatico | WLM manuale | 
| --- | --- | --- | 
| Auto WLM (WLM automatico) | Sì  | Sì | 
| Abilitazione dell'accelerazione di query brevi | Sì  | Sì | 
| Tempo di esecuzione massimo per query brevi | Sì  | Sì | 
| Priorità | Sì | No | 
| Queue type (Tipo di coda) | Sì  | Sì | 
| Nome coda | Sì  | Sì | 
| Modalità Dimensionamento simultaneo | Sì  | Sì | 
| Concurrency (Simultaneità) | No | Sì | 
| Gruppi di utenti | Sì  | Sì | 
| Carattere jolly per gruppi di utenti | Sì  | Sì | 
| Gruppi di query | Sì  | Sì | 
| Carattere jolly per gruppi di query | Sì  | Sì | 
| Ruoli utente | Sì  | Sì | 
| Carattere jolly del ruolo utente | Sì  | Sì | 
| Timeout | No | Deprecated | 
| Memoria | No | Sì | 
| Regole di monitoraggio delle query | Sì  | Sì | 

L'elenco seguente descrive le proprietà WLM che puoi configurare.

**Auto WLM (WLM automatico)**  
**Auto WLM (WLM automatico)** impostato su `true` abilita il WLM automatico. La gestione automatica del carico di lavoro imposta i valori per **Simultaneità su principale** e **Memoria (%)** su `Auto`. Amazon Redshift gestisce le query simultanee e l'allocazione della memoria. Il valore predefinito è `true`.  
Proprietà JSON: `auto_wlm`

**Abilitazione dell'accelerazione di query brevi**  
L'accelerazione di query brevi (SQA) rende prioritarie le query a esecuzione breve rispetto a quelle a esecuzione prolungata. SQA esegue le query a esecuzione breve in uno spazio dedicato, di modo che le query SQA non siano costrette ad attendere nelle code dietro le query più lunghe. Con SQA, l'esecuzione delle query brevi è più rapida e gli utenti vedono prima i risultati. Quando abiliti SQA, puoi anche specificare il tempo di esecuzione massimo per le query brevi. Per abilitare SQA, imposta `true`. Il valore predefinito è `false`. Questa impostazione viene applicata a ciascun gruppo di parametri anziché alla coda.  
Proprietà JSON: `short_query_queue`

****Tempo di esecuzione massimo per query brevi****  
Quando abiliti SQA, puoi specificare 0 affinché WLM imposti dinamicamente il tempo di esecuzione massimo per le query brevi. In alternativa, è possibile specificare un valore fisso di 1-20 secondi, in millisecondi. Il valore predefinito è `0`.  
Proprietà JSON: `max_execution_time`

**Priorità**  
La priorità imposta la priorità delle query eseguite in una coda. Per impostare la priorità, **WLM mode (Modalità WLM)** deve essere impostata su **Auto WLM (WLM automatico)**; ovvero, `auto_wlm` deve essere `true`. I valori di priorità possono essere `highest`, `high`, `normal`, `low` e `lowest`. Il valore predefinito è `normal`.  
Proprietà JSON: `priority`

**Queue type (Tipo di coda)**  
Il tipo di coda indica se una coda è utilizzata da **Auto WLM (WLM automatico)** o da **Manual WLM (WLM manuale)**. Impostare `queue_type` su `auto` o su `manual`. Se non si specifica un valore predefinito, viene utilizzato `manual`.  
Proprietà JSON: `queue_type`

**Nome coda**  
Il nome della coda. Puoi impostare il nome della coda in base alle tue esigenze. I nomi delle code devono essere univoci all'interno di una configurazione WLM, contenere fino a 64 caratteri alfanumerici, caratteri di sottolineatura o spazi e non possono contenere virgolette. Ad esempio, se disponi di una coda per le query ETL, puoi denominarla `ETL queue`. Questo nome viene utilizzato nei parametri, nei valori della tabella di sistema e nella console Amazon Redshift per identificare la coda. Le query e i report che utilizzano il nome di queste origini devono essere in grado di gestire le modifiche del nome. In precedenza, i nomi delle code erano generati da Amazon Redshift. I nomi predefiniti delle code sono `Queue 1`, `Queue 2`, con l'ultima coda denominata `Default queue`.   
Se modifichi il nome di una coda, cambia anche il valore della `QueueName` dimensione delle metriche della coda WLM (come WLMQueue Length,,, WLMQuery Duration WLMQueue WaitTime WLMQueriesCompletedPerSecond, WLMRunning Queries e così via). Pertanto, se si modifica il nome di una coda, potrebbe essere necessario modificare CloudWatch gli allarmi impostati. 
Proprietà JSON: `name`

**Modalità dimensionamento della simultaneità**  
Per abilitare il dimensionamento della simultaneità su una coda, imposta la **Concurrency Scaling mode (Modalità dimensionamento della simultaneità)** su `auto`. Quando il numero di query instradate a una coda supera la simultaneità configurata della coda, le query idonee vengono inviate al cluster di dimensionamento. Quando gli slot diventano disponibili, le query vengono eseguite nel cluster principale. Il valore predefinito è `off`.  
Proprietà JSON: `concurrency_scaling`

**Concurrency (Simultaneità)**  
Il numero di query eseguibili simultaneamente in una coda WLM manuale. Questa proprietà si applica solo a WLM manuale. Se il dimensionamento simultaneo è abilitato, le query idonee vengono inviate a un cluster di dimensionamento quando la coda raggiunge il livello di simultaneità (slot di query). Se il dimensionamento della simultaneità non è abilitato, le query attendono in coda fino a quando uno slot non diventa disponibile. L'intervallo è tra 1 e 50.  
Proprietà JSON: `query_concurrency`

**Gruppi di utenti**  
Un elenco di nomi di gruppo utenti separati da virgola. Quando i membri del gruppo di utenti eseguono le query nel database, le relative query sono instradate alla coda associata di quel gruppo di utenti.  
Proprietà JSON: `user_group`

**Carattere jolly per gruppi di utenti**  
Un valore booleano che indica se abilitare i caratteri jolly per gruppi di utenti. Se è 0, i caratteri jolly sono disabilitati; se è 1, sono abilitati. Quando sono abilitati, puoi utilizzare i caratteri jolly "\$1" o "?" per specificare più gruppi di utenti quando esegui le query. Per ulteriori informazioni, consultare [Caratteri jolly](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Proprietà JSON: `user_group_wild_card`

**Gruppi di query**  
Un elenco di gruppi di query separati da virgola. Quando i membri del gruppo di query eseguono delle query nel database, le query sono instradate alla coda associata al relativo gruppo di query.  
Proprietà JSON: `query_group`

**Carattere jolly per gruppi di query**  
Un valore booleano che indica se abilitare i caratteri jolly per gruppi di query. Se è 0, i caratteri jolly sono disabilitati; se è 1, sono abilitati. Quando sono abilitati, puoi utilizzare i caratteri jolly "\$1" o "?" per specificare più gruppi di query quando esegui le query. Per ulteriori informazioni, consultare [Caratteri jolly](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Proprietà JSON: `query_group_wild_card`

**Ruoli utente**  
Un elenco di ruoli utente separati da virgola. Quando i membri con quel ruolo utente eseguono le query nel database, queste sono instradate alla coda associata con quel ruolo utente. Per ulteriori informazioni, consulta [Controllo accessi basato sui ruoli (RBAC)](https://docs.aws.amazon.com/redshift/latest/dg/t_Roles.html).  
Proprietà JSON: `user_role`

**Carattere jolly dei ruoli utente**  
Un valore booleano che indica se abilitare i caratteri jolly per gruppi di query. Se è 0, i caratteri jolly sono disabilitati; se è 1, sono abilitati. Quando sono abilitati, puoi utilizzare i caratteri jolly "\$1" o "?" per specificare più gruppi di query quando esegui le query. Per ulteriori informazioni, consultare [Caratteri jolly](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-wildcards).  
Proprietà JSON: `user_role_wild_card`

**Timeout (ms)**  
Il timeout WLM (`max_execution_time`) è sconsigliato. Non è disponibile se si utilizza WLM automatico. Al contrario, è necessario creare una regola di monitoraggio di query (QMR) utilizzando `query_execution_time` per limitare il tempo di esecuzione trascorso per una query. Per ulteriori informazioni, consultare [Regole di monitoraggio delle query WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html).   
Il tempo massimo, in millisecondi, entro il quale le query possono essere eseguite prima di essere annullate. In alcuni casi, una query di sola lettura, come un'istruzione SELECT, può essere cancellata a causa di un timeout WLM. In questi casi, WLM tenta di indirizzare la query alla successiva coda corrispondente in base alle regole di assegnazione delle code WLM. Se la query non soddisfa nessun'altra definizione di coda, viene annullata e non viene quindi assegnata alla coda predefinita. Per ulteriori informazioni, consultare [Hop della coda di query WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-defining-query-queues.html#wlm-queue-hopping). Il timeout WLM non si applica a una query il cui stato è `returning`. Per visualizzare lo stato di una query, consultare la tabella di sistema [STV\$1WLM\$1QUERY\$1STATE](https://docs.aws.amazon.com/redshift/latest/dg/r_STV_WLM_QUERY_STATE.html).  
Proprietà JSON: `max_execution_time`

**Memoria (%)**  
La percentuale di memoria da allocare alla coda. Se si specifica una percentuale di memoria per almeno una delle code, è necessario specificare una percentuale per tutte le altre code fino a un totale del 100%. Se l'allocazione della memoria è sotto il 100 percento in tutte le code, la memoria non allocata viene gestita dal servizio. Il servizio può assegnare questa memoria non allocata temporaneamente a una coda che necessita di memoria aggiuntiva per l'elaborazione.  
Proprietà JSON: `memory_percent_to_use`

**Regole di monitoraggio delle query**  
Puoi utilizzare il monitoraggio delle query WLM per monitorare in modo continuo le code WLM per le query in base ai criteri o ai predicati che specifichi. Ad esempio, potresti monitorare le query che tendono a consumare una quantità eccessiva di risorse di sistema e quindi avviare una determinata azione quando una query supera i limiti delle prestazioni specificati.   
Se scegli di creare regole a livello di programmazione, ti consigliamo vivamente di utilizzare la console per generare il JSON da includere nella definizione del gruppo di parametri.
Una regola di monitoraggio viene associata a una specifica coda di query. Puoi avere fino a 25 regole per coda, che è anche il limite complessivo di tutte le code.  
Proprietà JSON: `rules`  
Gerarchia delle proprietà JSON:   

```
rules
    rule_name
    predicate
        metric_name
        operator
        value
    action
        value
```
Per ogni regola, specifichi le seguenti proprietà:  
+ `rule_name`: i nomi delle regole devono essere univoci nella configurazione WLM. Possono essere composti da un massimo di 32 caratteri alfanumerici o caratteri di sottolineatura e non possono contenere spazi o virgolette.
  + `predicate`: è possibile avere fino a tre predicati per regola. Per ogni predicato, specifica le seguenti proprietà.
    + `metric_name`: per un elenco di parametri, consultare [Parametri di monitoraggio delle query](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html#cm-c-wlm-query-monitoring-metrics) nella *Guida per gli sviluppatori di database di Amazon Redshift*.
    + `operator`: le operazioni sono `=`, `<` e `>`. 
    + `value`: il valore di soglia per il parametro specificato che avvia un'operazione. 
+ `action`: ogni regola è associata a un'operazione. Le operazioni valide sono:
  + `log`
  + `hop` (disponibile solo con WLM manuale)
  + `abort`
  + `change_query_priority` (disponibile solo con WLM automatico)
L'esempio seguente mostra il codice JSON di una regola di monitoraggio di query WLM denominata `rule_1`, con due predicati e l'operazione `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"
          }
        ]
```

Per ulteriori informazioni su ognuna di queste proprietà e strategie per la configurazione di code di query, consultare [Implementazione della gestione del carico di lavoro](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-implementing-workload-management.html) nella *Guida per gli sviluppatori di database di Amazon Redshift*. 

## Configurazione del parametro WLM utilizzando AWS CLI
<a name="Configuring-the-wlm-json-configuration-Parameter"></a>

 Per configurare la gestione del carico di lavoro, è necessario modificare il parametro `wlm_json_configuration`. La dimensione massima del valore della proprietà `wlm_json_configuration`è 8000 caratteri. Il valore è formattato in JavaScript Object Notation (JSON). Se configuri WLM utilizzando l' AWS CLI API Amazon Redshift o una di queste, usa AWS SDKs il resto di questa sezione per scoprire come costruire la struttura JSON per il parametro. `wlm_json_configuration` 

**Nota**  
 Se si configura la WLM utilizzando la console Amazon Redshift, non è necessario conoscere la formattazione JSON, in quanto la console fornisce un modo semplice per aggiungere code e configurarne le proprietà. Per ulteriori informazioni sulla configurazione di WLM mediante la console, consultare [Modifica di un gruppo di parametri](parameter-group-modify.md). 

Esempio

L'esempio seguente è la configurazione WLM predefinita, che definisce una coda con un WLM automatico. 

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

Esempio

L'esempio seguente è una configurazione WLM personalizzata, che definisce una coda WLM manuale con un livello di simultaneità (slot di query) pari a 5. 

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

Sintassi

La configurazione WLM predefinita è molto semplice, con una sola coda e una sola proprietà. Puoi aggiungere altre code e configurare molteplici proprietà per ogni coda nella struttura JSON. La sintassi seguente rappresenta la struttura JSON che utilizzi per configurare molteplici code con molteplici proprietà: 

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

         ]"
   }
]
```

Nell'esempio precedente, le proprietà rappresentative che iniziano con **q1** sono oggetti in una matrice per la prima coda. Ciascuno di questi oggetti è una name/value coppia `name` e `value` insieme impostano le proprietà WLM per la prima coda. Le proprietà rappresentative che iniziano con **q2** sono oggetti in una matrice per la seconda coda. Se sono necessarie altre code, è necessario aggiungere un altro array per ogni coda supplementare e impostare le proprietà per ogni oggetto.

 Quando si modifica la configurazione della gestione del carico di lavoro, è necessario includere l'intera struttura per le code, anche se si intende modificare soltanto una proprietà in una coda. Questo perché l'intera struttura JSON viene passata in forma di stringa come valore del parametro `wlm_json_configuration`. 

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

Il parametro `wlm_json_configuration` richiede uno specifico formato quando utilizzi l' AWS CLI. Il formato utilizzato dipende dal sistema operativo del cliente. Poiché i sistemi operativi dispongono di più modi per racchiudere la struttura JSON, questa viene passata correttamente dalla riga di comando. Per dettagli su come creare il comando appropriato nei sistemi operativi Linux, Mac OS X e Windows, vedi le sezioni seguenti. *Per ulteriori informazioni sulle differenze nell'inclusione delle strutture di dati JSON in generale, consulta [Quoting strings AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#quoting-strings) in the User Guide.AWS Command Line Interface *

Esempi

L'esempio di comando seguente configura WLM manuale per un gruppo di parametri denominato `example-parameter-group`. La configurazione abilita l'accelerazione di query brevi con un tempo di esecuzione massimo per tali query impostato su 0; questo valore comporta l'impostazione dinamica del valore da parte di WLM. L'impostazione `ApplyType` è `dynamic`. Questa impostazione comporta l'applicazione immediata di eventuali modifiche apportate alle proprietà dinamiche nel parametro, a meno che altre modifiche statiche non siano state apportate alla configurazione. La configurazione definisce tre code con quanto segue: 
+  La prima coda consente agli utenti di specificare `report` come etichetta (come specificato nella proprietà `query_group`) nelle loro query per facilitare l'instradamento delle query a quella coda. Le ricerche con caratteri jolly sono abilitate per l'etichetta `report*`, quindi questa non deve essere esatta affinché le query siano instradate alla coda. Ad esempio, `reports` e `reporting` corrispondono entrambe a questo gruppo di query. La coda utilizza il 25% della memoria totale allocata per tutte le code e può eseguire fino a quattro query contemporaneamente. Le query sono limitate a un tempo massimo di 20000 millisecondi (ms). La modalità è impostata su auto, quindi quando gli slot della query della coda sono completi, le query idonee vengono inviate a un cluster di dimensionamento. 
+  La seconda coda consente agli utenti che sono membri dei gruppi `admin` e `dba` nel database di instradare le loro query alla coda per l'elaborazione. Le ricerche con caratteri jolly sono disabilitate per i gruppi di utenti, quindi gli utenti devono corrispondere esattamente ai gruppi nel database affinché le loro query siano instradate alla coda. La coda utilizza il 40% della memoria totale allocata per tutte le code e può eseguire fino a cinque query contemporaneamente. La modalità è impostata su off, quindi tutte le query inviate dai membri dell'admin o di gruppi dba vengono eseguite nel cluster principale.
+  L'ultima coda nella configurazione è la coda predefinita. Questa coda utilizza il 35% della memoria totale allocata per tutte le code e può elaborare fino a cinque query contemporaneamente. La modalità è impostata su auto. 

**Nota**  
 L'esempio è mostrato su più linee per scopi dimostrativi. I comandi effettivi non comportano interruzioni di riga. 

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

Quanto segue è un esempio di configurazione delle regole di monitoraggio di query WLM per una configurazione WLM automatico. L'esempio crea un gruppo di parametri denominato `example-monitoring-rules`. La configurazione definisce le stesse tre code dell'esempio precedente, ma `query_concurrency` e `memory_percent_to_use` non sono più specificati. La configurazione aggiunge anche le seguenti regole e priorità di query:
+ La prima coda definisce una regola denominata `rule_1`. La regola ha due predicati: `query_cpu_time > 10000000` e `query_blocks_read > 1000`. L'operazione della regola è `log`. La priorità di questa coda è `Normal`. 
+ La seconda coda definisce una regola denominata `rule_2`. La regola ha due predicati: `query_execution_time > 600000000` e `scan_row_count > 1000000000`. L'operazione della regola è `abort`. La priorità di questa coda è `Highest`. 
+ L'ultima coda nella configurazione è la coda predefinita. La priorità di questa coda è `Low`. 

**Nota**  
 L'esempio è mostrato su più linee per scopi dimostrativi. I comandi effettivi non comportano interruzioni di riga. 

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

#### Configurazione di WLM utilizzando la riga di comando con un file AWS CLI JSON
<a name="wlm-cli-json-file"></a>

Puoi modificare il parametro `wlm_json_configuration` tramite AWS CLI e passare il valore dell'argomento `parameters` come un file JSON.

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

Gli argomenti per `--parameters` sono memorizzati nel file `modify_pg.json`. La posizione del file è specificata nel formato del tuo sistema operativo. Per ulteriori informazioni, consultare la sezione relativa al [caricamento di parametri da un file](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html#cli-usage-parameters-file). Di seguito vengono mostrati degli esempi del contenuto del file 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"
    }
]
```

#### Regole per la configurazione di WLM utilizzando la AWS CLI riga di comando sui sistemi operativi Linux e macOS X
<a name="wlm-cli-linux-and-mac"></a>

Segui queste regole per eseguire un AWS CLI comando con parametri su una riga:
+ L'intera struttura JSON deve essere racchiusa tra virgolette singole (') e un set di parentesi quadre ([ ]). 
+ Tutti i nomi e i valori di parametro devono essere racchiusi tra virgolette doppie (").
+ Nel valore `ParameterValue`, è necessario racchiudere l'intera struttura nidificata tra virgolette doppie (") e parentesi quadre ([ ]).
+ Nella struttura nidificata, ogni proprietà e valore di ogni coda deve essere racchiuso tra parentesi graffe (\$1 \$1).
+ Nella struttura nidificata, è necessario utilizzare la barra rovesciata (\$1) come carattere di escape prima delle virgolette doppie (").
+ Per name/value le coppie, i due punti (:) separano ogni proprietà dal relativo valore.
+ Ogni name/value coppia è separata dall'altra da una virgola (,).
+ Le code sono separate da una virgola (,) tra la parentesi graffa finale (\$1) di una coda e la parentesi graffa iniziale (\$1) della coda successiva.

#### Regole per la configurazione di WLM utilizzando Windows su sistemi operativi PowerShell Microsoft Windows AWS CLI
<a name="wlm-cli-windows-powershell"></a>

Segui queste regole per eseguire un AWS CLI comando con parametri su una riga:
+ L'intera struttura JSON deve essere racchiusa tra virgolette singole (') e un set di parentesi quadre ([ ]).
+ Tutti i nomi e i valori di parametro devono essere racchiusi tra virgolette doppie (").
+ Nel valore `ParameterValue`, è necessario racchiudere l'intera struttura nidificata tra virgolette doppie (") e parentesi quadre ([ ]).
+ Nella struttura nidificata, ogni proprietà e valore di ogni coda deve essere racchiuso tra parentesi graffe (\$1 \$1).
+ Nella struttura nidificata, è necessario utilizzare il carattere di escape (\$1) prima delle virgolette doppie (") e del relativo carattere di escape (\$1). Ciò significa che dovrai utilizzare tre barre rovesciate e le virgolette doppie affinché le proprietà siano passate correttamente (\$1\$1\$1").
+ Per name/value le coppie, i due punti (:) separano ogni proprietà dal relativo valore.
+ Ogni name/value coppia è separata dall'altra da una virgola (,).
+ Le code sono separate da una virgola (,) tra la parentesi graffa finale (\$1) di una coda e la parentesi graffa iniziale (\$1) della coda successiva.

#### Regole per la configurazione di WLM mediante il prompt dei comandi su sistemi operativi Windows
<a name="wlm-cli-cmd-windows"></a>

Segui queste regole per eseguire un AWS CLI comando con parametri su una riga:
+ L'intera struttura JSON deve essere racchiusa tra virgolette doppie (") e un set di parentesi quadre ([ ]).
+ Tutti i nomi e i valori di parametro devono essere racchiusi tra virgolette doppie (").
+ Nel valore `ParameterValue`, è necessario racchiudere l'intera struttura nidificata tra virgolette doppie (") e parentesi quadre ([ ]).
+ Nella struttura nidificata, ogni proprietà e valore di ogni coda deve essere racchiuso tra parentesi graffe (\$1 \$1).
+ Nella struttura nidificata, è necessario utilizzare il carattere di escape (\$1) prima delle virgolette doppie (") e del relativo carattere di escape (\$1). Ciò significa che dovrai utilizzare tre barre rovesciate e le virgolette doppie affinché le proprietà siano passate correttamente (\$1\$1\$1").
+ Per name/value le coppie, i due punti (:) separano ogni proprietà dal relativo valore.
+ Ogni name/value coppia è separata dall'altra da una virgola (,).
+ Le code sono separate da una virgola (,) tra la parentesi graffa finale (\$1) di una coda e la parentesi graffa iniziale (\$1) della coda successiva.

# Creazione di un gruppo di parametri
<a name="parameter-group-create"></a>

Se intendi impostare dei valori differenti da quelli del gruppo di parametri predefinito, puoi creare il tuo gruppo di parametri personale. 

**Come creare un gruppo di parametri**

1. Accedi a Console di gestione AWS e apri la console Amazon Redshift all'indirizzo. [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)

1. Dal menu di navigazione scegliere **Configurations** (Configurazioni), quindi scegliere **Workload management** (Gestione carichi di lavoro) per visualizzare la pagina **Workload management** Gestione carichi di lavoro). 

1. Scegli **Create (Crea)** per visualizzare la finestra **Create parameter group (Crea gruppo di parametri)**. 

1. Inserisci un valore per le voci **Parameter group name (Nome gruppo parametri)** and **Description (Descrizione)**. 

1. Per creare il gruppo di parametri, scegli **Create (Crea)**. 

# Modifica di un gruppo di parametri
<a name="parameter-group-modify"></a>

Puoi visualizzare uno qualsiasi dei tuoi gruppi di parametri per vedere un riepilogo dei valori dei parametri e della configurazione WLM (Workload Management, gestione del carico di lavoro). In un gruppo di parametri, puoi modificare le impostazioni dei parametri e le proprietà della configurazione WLM. 

**Nota**  
Non è consentito modificare il gruppo di parametri predefinito.

------
#### [ Console di gestione AWS ]

Nella console i gruppi di parametri sono visualizzati nella scheda **Parametri** e le **Code di carichi di lavoro** sono visualizzate nella scheda **Gestione del carico di lavoro**. 

**Per modificare un gruppo di parametri**

1. Accedi a Console di gestione AWS e apri la console Amazon Redshift all'indirizzo. [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)

1. Dal menu di navigazione scegliere **Configurations** (Configurazioni), quindi scegliere **Workload management** (Gestione carichi di lavoro) per visualizzare la pagina **Workload management** Gestione carichi di lavoro). 

1. Scegli il gruppo di parametri che intendi modificare per visualizzare la pagina dei dettagli, contenente le schede **Parameters (Parametri)** e **Workload management (Gestione workload)**. 

1. Scegli la scheda **Parameters (Parametri)** per visualizzare le impostazioni dei parametri correnti. 

1. Scegli **Edit parameters (Modifica parametri)** per abilitare la modifica delle impostazioni di questi parametri: 
   + `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`

   Per ulteriori informazioni su questi parametri, consultare [Gruppi di parametri di Amazon Redshift.](working-with-parameter-groups.md). 

1. Inserisci le modifiche e scegli **Save (Salva)** per aggiornare il gruppo di parametri. 

**Per modificare la configurazione WLM in un gruppo di parametri**

1. Accedi a Console di gestione AWS e apri la console Amazon Redshift all'indirizzo. [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)

1. Dal menu di navigazione scegliere **Configurations** (Configurazioni), quindi scegliere **Workload management** (Gestione carichi di lavoro) per visualizzare la pagina **Workload management** Gestione carichi di lavoro). 

1. Scegli il gruppo di parametri che intendi modificare per visualizzare la pagina dei dettagli, contenente le schede **Parameters (Parametri)** e **Workload management (Gestione dei carichi di lavoro)**. 

1. Scegli la scheda **Workload management (Gestione dei carichi di lavoro)** per visualizzare la configurazione WLM attuale. 

1. Scegli **Modifica le code dei carichi di lavoro** per modificare la configurazione WLM. 

1. (Facoltativo) Per abilitare la funzionalità SQA (Short Query Acceleration, accelerazione di query brevi), seleziona **Enable short query acceleration (Abilita accelerazione di query brevi)**.

   Quando abiliti la funzionalità SQA, per impostazione predefinita l'opzione **Maximum run time for short queries (1 to 20 seconds) (Tempo di esecuzione massimo per query brevi (da 1 a 20 secondi))** viene impostata su **Dynamic (Dinamico)**. Per impostare il runtime massimo su un valore fisso, scegliere un valore compreso tra 1 e 20.

1. Eseguire una o più delle seguenti operazioni per modificare la configurazione relativa alle code: 
   + Scegli **Switch WLM mode (Cambia modalità WLM)** per scegliere tra **Automatic WLM (WLM automatico)** e **Manual WLM (WLM manuale)**.

     Con **WLM automatico**, i valori **Memoria** e **Simultaneità su principale** sono impostati su **auto**.
   + Per creare una coda, scegli **Edit workload queues (Modifica code dei carichi di lavoro)**, quindi scegli **Add Queue (Aggiungi coda)**.
   + Per modificare una coda, modifica i valori di proprietà nella tabella. A seconda del tipo di coda, le proprietà possono includere quanto segue:
     + Il **Queue name (Nome della coda)** può essere modificato. 
     + **Memoria (%)**
     + **Concurrency on main cluster (simultaneità nel cluster principale)**
     + La **Concurrency Scaling mode (Modalità dimensionamento della simultaneità)** può essere **off (disattivata)** o **auto (automatica)**
     + **Timeout (ms)**
     + **Gruppi di utenti**
     + **Gruppi di query**
     + **Ruoli utente**

     Per ulteriori informazioni su queste proprietà, consultare [Proprietà del parametro di configurazione WLM](workload-mgmt-config.md#wlm-json-config-properties).
**Importante**  
Se modifichi il nome di una coda, cambia anche il valore della `QueueName` dimensione delle metriche della coda WLM (ad esempio, WLMQueue Lunghezza,, WLMQuery Durata WLMQueue WaitTime WLMQueriesCompletedPerSecond, WLMRunning Interrogazioni e così via). Pertanto, se modifichi il nome di una coda, potresti dover modificare gli allarmi CloudWatch impostati. 
   + Per modificare l'ordine delle code, utilizza i pulsanti freccia **Up (Su)** e **Down (Giù)**. 
   + Per eliminare una coda, scegli **Delete (Elimina)** nella riga della coda nella tabella.

1. (Facoltativo) Per applicare le modifiche ai cluster dopo il riavvio degli stessi, seleziona **Defer dynamic changes until reboot (Rinvia modifiche dinamiche fino al riavvio)**.
**Nota**  
Alcune modifiche richiedono il riavvio dei cluster indipendentemente dalla selezione o meno di questa impostazione. Per ulteriori informazioni, consultare [Proprietà WLM dinamiche e statiche](workload-mgmt-config.md#wlm-dynamic-and-static-properties).

1. Scegli **Save** (Salva).

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

 Per configurare i parametri di Amazon Redshift utilizzando AWS CLI, si utilizza il [modify-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/redshift/modify-cluster-parameter-group.html)comando per un gruppo di parametri specifico. Il gruppo di parametri da modificare deve essere specificato in `parameter-group-name`. Utilizza il `parameters` parametro (per il `modify-cluster-parameter-group` comando) per specificare name/value le coppie per ogni parametro che desideri modificare nel gruppo di parametri. 

**Nota**  
Esistono alcune considerazioni speciali in relazione alla configurazione del parametro `wlm_json_configuration` con l' AWS CLI. Gli esempi in questa sezione sono validi per tutti i parametri ad eccezione di `wlm_json_configuration`. Per ulteriori informazioni sulla configurazione `wlm_json_configuration` mediante l'utilizzo di AWS CLI, vedere[Gestione dei carichi di lavoro](workload-mgmt-config.md). 

Dopo la modifica dei valori di parametro, è necessario riavviare gli eventuali cluster associati al gruppo di parametri modificato. Lo stato del cluster visualizza `applying` per `ParameterApplyStatus` durante l'applicazione dei valori, quindi `pending-reboot` dopo l'applicazione dei valori. Dopo il riavvio, i database nel cluster iniziano a utilizzare i nuovi valori di parametro. Per ulteriori informazioni sul riavvio di cluster, consultare [Riavvio di un cluster](reboot-cluster.md). 

**Nota**  
Il parametro `wlm_json_configuration` contiene alcune proprietà dinamiche che non richiedono il riavvio dei cluster associati affinché le modifiche siano applicate. Per ulteriori informazioni sulle proprietà dinamiche e statiche, consultare [Proprietà WLM dinamiche e statiche](workload-mgmt-config.md#wlm-dynamic-and-static-properties). 

 La sintassi seguente mostra come utilizzare il comando `modify-cluster-parameter-group` per configurare un parametro. È possibile specificare *parameter\$1group\$1name* e sostituire entrambi *parameter\$1name* e *parameter\$1value* con un parametro effettivo da modificare e un valore per quel parametro. Se intendi modificare più parametri contemporaneamente, separa ogni set di parametri e di valori da quello successivo con uno spazio. 

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

 L'esempio seguente mostra come configurare i parametri `statement_timeout` e `enable_user_activity_logging` per il gruppo di parametri `myclusterparametergroup`. 

**Nota**  
 Ai fini della leggibilità, l'esempio viene visualizzato su più righe, ma in realtà si AWS CLI tratta di una sola riga. 

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

------

# Creazione di una regola di monitoraggio delle query
<a name="parameter-group-modify-qmr-console"></a>

È possibile utilizzare la console Amazon Redshift per creare e modificare le regole di monitoraggio delle query di WLM. Le regole di monitoraggio di query fanno parte del parametro di configurazione WLM di un gruppo di parametri. Se si modifica una regola di monitoraggio delle query (QMR), la modifica viene eseguita automaticamente senza la necessità di modificare il cluster. Per ulteriori informazioni, consultare [Regole di monitoraggio delle query WLM](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html). 

Quando crei una regola, definisci il nome della stessa, uno o più predicati e un'operazione. 

Quando salvi una configurazione WLM che include una regola, puoi visualizzare il codice JSON della definizione della regola nel codice JSON del parametro di configurazione WLM. 



**Per creare una regola di monitoraggio di query**

1. Accedi a Console di gestione AWS e apri la console Amazon Redshift all'indirizzo. [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)

1. Dal menu di navigazione scegliere **Configurations** (Configurazioni), quindi scegliere **Workload management** (Gestione carichi di lavoro) per visualizzare la pagina **Workload management** Gestione carichi di lavoro). 

1. Scegli il gruppo di parametri che intendi modificare per visualizzare la pagina dei dettagli, contenente le schede **Parameters (Parametri)** e **Workload management (Gestione dei carichi di lavoro)**. 

1. Scegli la scheda **Gestione del carico di lavoro** e quindi **Modifica le code dei carichi di lavoro** per modificare la configurazione WLM.

1. Aggiungi una nuova regola utilizzando un modello predefinito o partendo da zero. 

   Per utilizzare un modello predefinito, procedi come segue: 

   1. Scegli **Add rule from template (Aggiungi regola da modello** nel gruppo **Query monitoring rules (Regole di monitoraggio delle query)**. Viene visualizzato l'elenco dei modelli di regola. 

   1. Scegliere uno o più modelli di regole. Quando scegli **Save (Salva)**, WLM crea una regola per ogni modello scelto. 

   1. Inserisci o conferma i calore per la regole, inclusi **Rule names (Nomi delle regole)**, **Predicates (Predicati)** e **Actions (Operazioni)**. 

   1. Scegli **Save** (Salva). 

   Per aggiungere una nuova regola da zero, procedi come segue:

   1. Per aggiungere ulteriori predicati, scegli **Add predicate (Aggiungi predicato)**. Possono essere aggiunti fino a tre predicati per ogni regola. Se tutti i predicati sono soddisfatti, WLM attiva l'operazione associata. 

   1. Scegli un'operazione in **Action (Operazione)**. A ogni regola, è necessario associare un'operazione.

   1. Scegli **Save** (Salva).

Amazon Redshift genera il parametro di configurazione WLM in formato JSON e lo visualizza nella sezione **JSON**. 

# Eliminazione di un gruppo di parametri
<a name="parameter-group-delete"></a>

Puoi eliminare un gruppo di parametri se questo non è più necessario e non è associato ad alcun cluster. È consentito eliminare soltanto gruppi di parametri personalizzati.

**Come eliminare un gruppo di parametri**

1. Accedi a Console di gestione AWS e apri la console Amazon Redshift all'indirizzo. [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)

1. Dal menu di navigazione scegliere **Configurations** (Configurazioni), quindi scegliere **Workload management** (Gestione carichi di lavoro) per visualizzare la pagina **Workload management** Gestione carichi di lavoro). 

1. In **Parameter groups (Gruppi di parametri)**, scegli il gruppo di parametri da modificare.
**Nota**  
Non è possibile eliminare il gruppo di parametri predefinito.

1. Scegli **Delete (Elimina)** e conferma di voler eliminare il gruppo di parametri. 