

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

# Controlla l'utilizzo della capacità
<a name="capacity-management-control-capacity-usage"></a>

Puoi controllare il numero di DPU che Athena assegna alle tue query impostando controlli DPU massimi o minimi. È possibile configurarli a livello di gruppo di lavoro per stabilire controlli di base per tutte le query o a livello di singola query per un controllo dettagliato. In questo modo è possibile controllare direttamente le prestazioni delle query, la concorrenza dei carichi di lavoro e i costi.
+ Quando si imposta un numero massimo di DPU, si evita che le query consumino più capacità di quella specificata. In questo modo è semplice controllare la concomitanza di costi e carichi di lavoro. Ad esempio, se la tua prenotazione di capacità è di 200 DPU, l'impostazione della DPU massima per query su 8 consente di eseguire 25 query contemporaneamente. Se aumenti la prenotazione a 400 DPU, puoi eseguire 50 query contemporaneamente.
+ Quando imposti un numero minimo di DPU, ti assicuri che le query vengano eseguite con il numero minimo di DPU desiderato. Ciò è utile quando si conosce in anticipo il profilo di utilizzo della capacità tipico per le query.

**Nota**  
I controlli sull'utilizzo della DPU si applicano solo alle query eseguite con prenotazioni di capacità.

**Nota**  
Per utilizzare lo stesso numero di DPU per tutte le query, utilizza lo stesso valore per la DPU minima e massima.

## Imposta i controlli DPU a livello di gruppo di lavoro
<a name="capacity-management-set-dpu-controls-workgroup-level"></a>

Imposta i controlli DPU a livello di gruppo di lavoro per gestire i costi e controllare le prestazioni del carico di lavoro per il gruppo di lavoro che scegli. **I controlli DPU impostati a livello di gruppo di lavoro si applicano a tutte le query quando le impostazioni Override lato client sono abilitate.**

**Per impostare i controlli DPU utilizzando la console**

1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Nel pannello di navigazione, seleziona **Workgroups** (Gruppi di lavoro).

1. Seleziona un gruppo di lavoro che utilizza una prenotazione di capacità.

1. Nella scheda **Controlli di esecuzione**, scegli **Modifica controlli**.

1. Configura quanto segue:
   + Per **Min DPU per query**, immettete un valore compreso tra 4 e 124 con incrementi di 4.
   + Per **DPU massima per query**, inserisci un valore compreso tra 4 e 124 con incrementi di 4.

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

1. (Facoltativo) Seleziona Ignora **le impostazioni lato client per applicare queste impostazioni e ignorare le configurazioni** DPU a livello di query.

**Per impostare i controlli DPU utilizzando il AWS CLI**
+ Utilizzate il `update-work-group` comando per impostare i controlli DPU per un gruppo di lavoro:

  ```
  aws athena update-work-group \
    --work-group my_workgroup \
    --configuration-updates '{
          "EngineConfiguration": {
              "Classifications": [
                  {
                      "Name": "athena-query-engine-properties",
                      "Properties": {
                          "max-dpu-count" : "24",
                          "min-dpu-count" : "12"
                          }
                      }
                  ]
          }}'
  ```

  Se lo impostate su`true`, `EnforceWorkGroupConfiguration` le impostazioni del gruppo di lavoro hanno la precedenza su tutti i controlli DPU specificati a livello di query quando inviati tramite. [StartQueryExecution](https://docs.aws.amazon.com/athena/latest/APIReference/API_StartQueryExecution.html) Ciò garantisce un'allocazione coerente delle risorse tra tutte le interrogazioni del gruppo di lavoro.

## Imposta i controlli DPU con query individuali
<a name="capacity-management-set-dpu-controls-individual-queries"></a>

Imposta i controlli DPU a livello di query quando hai bisogno di un controllo granulare con query che richiedono risorse diverse. **I controlli DPU a livello di query hanno la precedenza sulle impostazioni a livello di gruppo di lavoro, a meno che il gruppo di lavoro non abbia abilitato le impostazioni Override lato client.**

**Per impostare i controlli DPU per un'interrogazione utilizzando la console**

1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Nel riquadro di navigazione, scegli **Query Editor (Editor della query)**.

1. Seleziona un gruppo di lavoro che utilizza una prenotazione di capacità.

1. Scegli la scheda **Impostazioni della query**.

1. Nella sezione **Controlli di esecuzione**, scegli **Modifica controlli**.

1. Configura quanto segue:
   + Per **Min DPU per query**, immettete un valore compreso tra 4 e 124 con incrementi di 4.
   + Per **DPU massima per query**, inserisci un valore compreso tra 4 e 124 con incrementi di 4.

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

**Per impostare i controlli DPU per una query utilizzando il AWS CLI**
+ Utilizzate il `start-query-execution` comando con il `engine-configuration` parametro:

  ```
  aws athena start-query-execution \
    --query-string "SELECT * FROM my_table LIMIT 10" \
    --work-group "my_workgroup" \
    --engine-configuration '{
      "Classifications": [ {
          "Name": "athena-query-engine-properties",
              "Properties": {
                  "max-dpu-count" : "32",
                  "min-dpu-count" : "8"
                  }
              }
          ]}'
  ```

La relazione tra le impostazioni DPU a livello di query e a livello di gruppo di lavoro dipende dalla configurazione del gruppo di lavoro:
+ Quando **Override le impostazioni lato client è abilitata, i controlli DPU a livello di gruppo di lavoro hanno la precedenza su qualsiasi impostazione** a livello di query. Ciò garantisce un utilizzo coerente delle risorse per tutte le interrogazioni nel gruppo di lavoro specificato.
+ Quando **Override le impostazioni lato client** non è abilitato, i controlli DPU a livello di query hanno la precedenza sulle impostazioni a livello di gruppo di lavoro. Ciò consente la flessibilità necessaria per ottimizzare le singole query.

Se non specifichi i controlli DPU a nessuno dei due livelli, Athena alloca automaticamente la capacità in base alla complessità delle query.

**Nota**  
Per le query DDL, il valore massimo per il minimo è 4. DPUs L'impostazione di un valore minimo più elevato per le query DDL genera un errore.

## Monitora l'utilizzo della DPU
<a name="capacity-management-monitor-dpu-usage"></a>

Una volta completate le query, puoi visualizzarne l'utilizzo della DPU. Athena fornisce metriche di utilizzo della DPU tramite la console, le operazioni API e. CloudWatch

**Per visualizzare il consumo di DPU nella console**

1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Nel riquadro di navigazione, scegli **Query Editor (Editor della query)**.

1. Al termine di una query, visualizza il relativo valore **DPU consumato** nel contenitore dei risultati della query.

1. Per visualizzare il consumo di DPU per le query precedenti:

   1. Scegli **Interrogazioni recenti nel riquadro** di navigazione.

   1. Seleziona l'icona delle impostazioni per aggiungere la colonna **Consumed DPU** alla tabella, se non è già visualizzata.

   1. Controlla il consumo di DPU per ogni query completata.

1. Facoltativamente, dall'**editor di Query**, scegli la scheda **Query stats** e controlla la DPU **Consumed**.

**Per recuperare il consumo di DPU utilizzando l'API**

1. Utilizza le seguenti operazioni API per recuperare il consumo di DPU a livello di codice:
   + `GetQueryExecution`- Restituisce i dettagli di esecuzione per una query specifica
   + `BatchGetQueryExecution`- Restituisce i dettagli di esecuzione per più query

1. Esempio con AWS CLI:

   ```
   aws athena get-query-execution \
     --query-execution-id "123e4567-e89b-12d3-a456-426614174000"
   ```

   La risposta include il `DpuCount` campo nell'`Statistics`oggetto:

   ```
   {
     "QueryExecution": {
       "Statistics": {
         "DpuCount": 8
       }
     }
   }
   ```

**Per monitorare l'utilizzo della DPU con CloudWatch**
+ Athena pubblica metriche relative alle query CloudWatch che consentono di monitorare l'utilizzo della capacità e altri dati sulle prestazioni. Per ulteriori informazioni, consulta [Monitora le metriche delle query di Athena con CloudWatch](query-metrics-viewing.md).