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à.
# Gestisci la capacità di elaborazione delle query
Puoi utilizzare le prenotazioni di capacità per ottenere una capacità di elaborazione serverless dedicata per le query eseguite in Athena. Con le prenotazioni di capacità, puoi sfruttare le funzionalità di gestione dei carichi di lavoro che ti aiutano a stabilire le priorità, controllare e scalare i carichi di lavoro più importanti. Ad esempio, puoi aggiungere capacità per controllare il numero di query che puoi eseguire contemporaneamente, scegliere quali carichi di lavoro possono utilizzare la capacità e condividere la capacità tra i carichi di lavoro. La capacità è serverless e completamente gestita da Athena e mantenuta per tutto il tempo necessario. La configurazione è semplice e non sono necessarie modifiche alle query SQL.
Per ottenere la capacità di elaborazione delle query, è necessario creare una prenotazione di capacità, specificare il numero di unità di elaborazione dati (DPUs) richieste e assegnare uno o più gruppi di lavoro alla prenotazione.
I gruppi di lavoro svolgono un ruolo importante quando utilizzi le prenotazioni della capacità. I gruppi di lavoro consentono di organizzare le interrogazioni in raggruppamenti logici o casi d'uso. Con le prenotazioni della capacità, puoi assegnare selettivamente capacità ai gruppi di lavoro in modo da controllare la modalità di fatturazione e il comportamento delle richieste per ciascun gruppo di lavoro. Per ulteriori informazioni sui gruppi di lavoro, consulta [Usare i gruppi di lavoro per controllare l’accesso alle query e i costi](workgroups-manage-queries-control-costs.md).
L'assegnazione dei gruppi di lavoro alle prenotazioni di capacità consente di dare priorità a queste query, poiché vengono eseguite sulla capacità riservata dell'utente e non vengono conteggiate ai fini della quota di query DDL e DML. Ad esempio, è possibile allocare la capacità a un gruppo di lavoro utilizzato per le query relative ai report finanziari urgenti per isolare tali interrogazioni da quelle meno critiche in un altro gruppo di lavoro. In questo modo è possibile eseguire query prevedibili per carichi di lavoro critici, consentendo al contempo l'esecuzione indipendente di altri carichi di lavoro.
Puoi utilizzare contemporaneamente prenotazioni della capacità e gruppi di lavoro per soddisfare requisiti diversi. Di seguito sono riportati alcuni scenari di esempio:
+ **Isola le query importanti**: per garantire che un carico di lavoro importante abbia la capacità necessaria quando ne hai bisogno, crea una prenotazione di capacità e assegna il relativo gruppo di lavoro alla prenotazione. Solo le richieste del gruppo di lavoro assegnato utilizzano la capacità di elaborazione della prenotazione. Ad esempio, per garantire l'esecuzione affidabile delle query che supportano un'applicazione di produzione, assegnate il gruppo di lavoro di produzione incaricato di tali interrogazioni a una prenotazione di capacità. Quando sviluppate le interrogazioni, utilizzate un gruppo di lavoro separato non associato a una prenotazione e spostate le interrogazioni nel gruppo di lavoro di produzione quando siete pronti.
+ **Condividi la capacità tra carichi di lavoro simili: più carichi di lavoro** possono condividere la capacità di una prenotazione. Ciò consente di ottenere un costo prevedibile per questi carichi di lavoro e di controllarne la concomitanza. Ad esempio, se disponi di carichi di lavoro pianificati che tollerano gli orari di inizio dell'esecuzione delle query ritardati, puoi assegnare i relativi gruppi di lavoro a un'unica prenotazione. Ciò consente di liberare la quota di query DDL e DML per le query interattive eseguite nello stesso account, garantendo che tali query vengano avviate con un ritardo minimo.
## Comprendi DPUs
La capacità è misurata in unità di elaborazione dati (DPUs). DPUs rappresentano le risorse di calcolo e memoria serverless utilizzate da Athena per accedere ed elaborare i dati per conto dell'utente. Una DPU fornisce in genere 4 v CPUs e 16 GB di memoria. Il numero di DPUs file che possiedi influenza il numero di query che puoi eseguire contemporaneamente. Ad esempio, una prenotazione con 256 DPUs può supportare circa il doppio del numero di query simultanee rispetto a una prenotazione con 128. DPUs
Per informazioni sulla stima dei requisiti di capacità, consulta [Determina dei requisiti di capacità](capacity-management-requirements.md). Per informazioni sui prezzi, consulta [Prezzi di Amazon Athena](https://aws.amazon.com/athena/pricing/).
## Considerazioni e limitazioni
+ Puoi utilizzare le prenotazioni di capacità e la fatturazione per query, in base ai dati scansionati, contemporaneamente nello stesso account.
+ Le query eseguite sulle prenotazioni di capacità non vengono conteggiate ai fini della quota di query DDL e DML.
+ Se la tua capacità è occupata a soddisfare altre interrogazioni, le nuove query inviate vengono messe in coda fino a esaurimento posti. Il tempo massimo consentito in coda è di 10 ore.
+ Un gruppo di lavoro può essere assegnato a una prenotazione di capacità alla volta. È possibile assegnare un totale di 20 gruppi di lavoro a una singola prenotazione. Quando si assegnano più gruppi di lavoro a una prenotazione, la capacità viene condivisa tra i gruppi di lavoro e assegnata alle query in base all'ordine di invio. L'ordine di esecuzione potrebbe variare a causa del modo in cui Athena alloca dinamicamente la capacità alle query.
+ Athena alloca automaticamente tra 4 e 124 interrogazioni DML DPUs in base alla loro complessità. Le query DDL ne consumano 4 ciascuna. DPUs Per ulteriori informazioni, consulta i seguenti argomenti:
+ [Determina dei requisiti di capacità](capacity-management-requirements.md)
+ [Controlla l'utilizzo della capacità](capacity-management-control-capacity-usage.md)
+ Il numero minimo DPUs richiesto per ogni prenotazione di capacità è 4. Per informazioni sui prezzi, consulta [Prezzi di Amazon Athena](https://aws.amazon.com/athena/pricing/).
+ Puoi creare fino a 100 prenotazioni di capacità con un massimo di 1.000 in totale DPUs per account e regione. Se ne hai bisogno di più di 1.000 DPUs per il tuo caso d'uso, contatta [athena-feedback@amazon.com](mailto:athena-feedback@amazon.com?subject=Athena Provisioned Capacity DPU Limit Request).
+ Le richieste di capacità non sono garantite e possono richiedere fino a 30 minuti per essere completate. La capacità non è trasferibile a un'altra prenotazione di capacità Account AWS, oppure Regione AWS.
+ La `DPUConsumed` CloudWatch metrica è per gruppo di lavoro anziché per prenotazione. Pertanto, se sposti un gruppo di lavoro da una prenotazione all'altra, il parametro `DPUConsumed` include i dati del momento in cui il gruppo di lavoro apparteneva alla prima prenotazione. Per ulteriori informazioni sull'utilizzo delle CloudWatch metriche in Athena, consulta. [Monitora le metriche delle query di Athena con CloudWatch](query-metrics-viewing.md)
+ Per eliminare un gruppo di lavoro assegnato a una prenotazione, per prima cosa rimuovi il gruppo di lavoro dalla prenotazione.
+ I gruppi di lavoro configurati per utilizzare Apache Spark non sono supportati.
+ Le prenotazioni di capacità non sono disponibili nei seguenti spot pubblicitari: Regioni AWS
+ Israele (Tel Aviv)
+ Medio Oriente (Emirati Arabi Uniti)
+ Medio Oriente (Bahrein)
+ Asia Pacifico (Nuova Zelanda)
**Topics**
+ [Comprendi DPUs](#capacity-management-understanding-dpus)
+ [Considerazioni e limitazioni](#capacity-management-considerations-limitations)
+ [Determina dei requisiti di capacità](capacity-management-requirements.md)
+ [Crea prenotazioni della capacità](capacity-management-creating-capacity-reservations.md)
+ [Controlla l'utilizzo della capacità](capacity-management-control-capacity-usage.md)
+ [Regola automaticamente la capacità](capacity-management-automatically-adjust-capacity.md)
+ [Gestisci le prenotazioni](capacity-management-managing-reservations.md)
+ [Policy IAM per le prenotazioni della capacità](capacity-reservations-iam-policy.md)
+ [Prenotazione di capacità Athena APIs](capacity-management-api-list.md)
# Determina dei requisiti di capacità
Prima di creare una prenotazione di capacità, è possibile stimare la capacità richiesta in modo da assegnarle il numero corretto di DPUs. Inoltre, dopo aver utilizzato una prenotazione, potresti voler verificare se la capacità della prenotazione è insufficiente o eccessiva. Questo argomento descrive le tecniche che è possibile utilizzare per effettuare queste stime e descrive anche alcuni AWS strumenti per valutare l'utilizzo e i costi.
**Topics**
+ [Stima la capacità richiesta](#capacity-management-requirements-estimating)
+ [Segnali che è necessaria una capacità maggiore](#capacity-management-requirements-insufficient-capacity)
+ [Verifica la capacità inattiva](#capacity-management-requirements-idle-capacity)
+ [Monitoraggio del consumo di DPU](#capacity-management-requirements-monitoring-dpu-consumption)
## Stima la capacità richiesta
Nella stima dei requisiti di capacità, è utile considerare due punti di vista: quanta capacità potrebbe richiedere una determinata query e quanta capacità potrebbe essere necessaria in generale.
### Stima i requisiti di capacità per query
Per determinare il numero di dati DPUs che una query potrebbe richiedere, è possibile utilizzare le seguenti linee guida:
+ Le query DDL consumano 4. DPUs
+ Le query DML consumano tra 4 e 124. DPUs
Athena determina il numero di DPUs richieste da una query DML al momento dell'invio della query. Il numero varia in base alla dimensione dei dati, al formato di archiviazione, al costrutto della query e ad altri fattori. In genere, Athena tenta di selezionare il numero delle DPU più basso ed efficiente. Se Athena determina che è necessaria una maggiore potenza di calcolo per il corretto completamento della query, aumenta il numero di dati DPUs assegnati all'interrogazione.
### Stima dei requisiti di capacità specifici del carico di lavoro
Per determinare la capacità necessaria per eseguire più query contemporaneamente, considera le linee guida generali riportate nella tabella seguente:
****
| Query simultanee | DPUs richiesto |
| --- | --- |
| 10 | 40 o più |
| 20 | 96 o più |
| 30 o più | 240 o più |
Tieni presente che il numero effettivo di DPUs cui hai bisogno dipende dai tuoi obiettivi e dai tuoi modelli di analisi. Ad esempio, se desideri che le query vengano avviate immediatamente senza fare la coda, determina il picco di richiesta di query simultanee e quindi fornisci il numero di richieste corrispondenti. DPUs
È possibile effettuare il provisioning per un numero DPUs inferiore a quello della domanda di picco, ma è possibile che si verifichi una coda quando si verifica un picco di domanda. Quando si verifica un accodamento, Athena mantiene le query in coda e le esegue quando la capacità diventa disponibile.
Se il tuo obiettivo è eseguire le query entro un budget fisso, puoi utilizzare il [Calcolatore AWS dei prezzi](https://calculator.aws/#/addService/Athena) per determinare il numero di DPUs richieste adatte al tuo budget.
Infine, ricorda che la dimensione dei dati, il formato di archiviazione e il modo in cui viene scritta una query influiscono sui requisiti richiesti dalla DPUs query. Per aumentare le prestazioni delle query, puoi comprimere o partizionare i dati o convertirli in formati colonnari. Per ulteriori informazioni, consulta [Ottimizzazione delle prestazioni](performance-tuning.md).
## Segnali che è necessaria una capacità maggiore
Messaggi di errore relativi alla capacità insufficiente e l'accodamento delle query indicano che la capacità assegnata è inadeguata.
Se le query non vanno a buon fine e viene visualizzato un messaggio di errore relativo ad una capacità insufficiente, probabilmente il numero di DPU di prenotazione della capacità è troppo basso per la query. Ad esempio, se hai una prenotazione con 24 DPUs ed esegui una query che ne richiede più di 24 DPUs, la query avrà esito negativo. Per monitorare questo errore di query, puoi utilizzare [EventBridge gli eventi](athena-events.md) di Athena. Prova ad aggiungerne altri DPUs e a eseguire nuovamente la query.
Se molte query sono accodate, significa che la capacità è utilizzata del tutto da altre query. Per ridurre la coda, effettua una delle seguenti operazioni:
+ DPUs Aggiungila alla tua prenotazione per aumentare la concorrenza tra le query.
+ Rimuovi i gruppi di lavoro dalla tua prenotazione per liberare spazio per altre query.
Per verificare l'eccessiva coda delle query, utilizza la [CloudWatchmetrica](query-metrics-viewing.md) del tempo di coda delle query Athena per i gruppi di lavoro inclusi nella prenotazione di capacità. Se il valore è superiore alla soglia preferita, puoi aggiungerlo alla prenotazione di capacità. DPUs
## Verifica la capacità inattiva
Per verificare la capacità inattiva, puoi diminuire il numero di DPUs partecipanti alla prenotazione o aumentarne il carico di lavoro, quindi osservare i risultati.
**Come verificare la capacità inattiva**
1. Esegui una delle seguenti operazioni:
+ Riduci il numero di DPUs persone presenti nella prenotazione (riduci le risorse disponibili)
+ Aggiungi gruppi di lavoro alla prenotazione (aumenta il carico di lavoro)
1. Utilizzato [CloudWatch](query-metrics-viewing.md)per misurare il tempo di coda delle interrogazioni.
1. Se il tempo di coda aumenta oltre il livello desiderato, effettua una delle seguenti operazioni
+ Rimuovi i gruppi di lavoro
+ Aggiungilo DPUs alla tua prenotazione di capacità
1. Dopo ogni modifica, controlla le prestazioni e il tempo di coda delle query.
1. Continua a regolare il numero di and/or DPU del carico di lavoro per raggiungere l'equilibrio desiderato.
Se non vuoi mantenere la capacità al di fuori del periodo di tempo preferito, puoi [annullare](capacity-management-cancelling-a-capacity-reservation.md) la prenotazione e crearne un'altra in un secondo momento. Tuttavia, anche se hai annullato di recente la capacità di un'altra prenotazione, le richieste di nuova capacità non sono garantite; inoltre nuove prenotazioni richiedono tempo per essere create.
## Monitoraggio del consumo di DPU
Dopo l'esecuzione delle query, è possibile visualizzare la DPU utilizzata dalle query per affinare le stime della capacità. Athena fornisce i parametri di consumo della DPU tramite la console, le operazioni API e. CloudWatch Queste informazioni aiutano a identificare le query che consumano più o meno risorse del previsto e a ottimizzare l'allocazione della capacità sulla base di dati reali. Per informazioni dettagliate sulla visualizzazione e il monitoraggio del consumo di DPU, vedere. [Monitora l'utilizzo della DPU](capacity-management-control-capacity-usage.md#capacity-management-monitor-dpu-usage)
## Strumenti per valutare i requisiti di capacità e i costi
Puoi utilizzare i seguenti servizi e funzionalità AWS per misurare l'utilizzo e i costi di Athena.
### CloudWatch metriche
Puoi configurare Athena per pubblicare metriche relative alle query su Amazon CloudWatch a livello di gruppo di lavoro. Dopo l'abilitazione dei parametri del gruppo di lavoro, nella console Athena, nella pagina dei dettagli del gruppo di lavoro, vengono visualizzati i parametri delle query del gruppo di lavoro.
Per informazioni sulle metriche di Athena pubblicate su CloudWatch e sulle relative dimensioni, vedere. [Monitora le metriche delle query di Athena con CloudWatch](query-metrics-viewing.md)
### CloudWatch metriche di utilizzo
Puoi utilizzare le metriche di CloudWatch utilizzo per fornire visibilità sul modo in cui il tuo account utilizza le risorse visualizzando l'utilizzo corrente del servizio su CloudWatch grafici e dashboard. Per Athena, le metriche di disponibilità dell'utilizzo corrispondono alle quote di AWS [servizio](service-limits.md) per Athena. È possibile configurare gli allarmi che avvisano quando l'uso si avvicina a una quota di servizio.
Per ulteriori informazioni, consulta [Monitora le metriche di utilizzo di Athena con CloudWatch](monitoring-athena-usage-metrics.md).
### EventBridge Eventi Amazon
Puoi utilizzare Amazon Athena con Amazon EventBridge per ricevere notifiche in tempo reale sullo stato delle tue richieste. Quando una query inviata modifica lo stato, Athena pubblica un evento in EventBridge cui sono contenute informazioni sulla transizione dello stato della query. Puoi scrivere semplici regole per gli eventi che ti interessano e intraprendere azioni automatiche quando un evento corrisponde a una regola.
Per ulteriori informazioni, consulta le risorse seguenti.
+ [Monitora gli eventi di interrogazione di Athena con EventBridge](athena-events.md)
+ [Che cos'è Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [ EventBridgeEventi Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
### Tag
In Athena le prenotazioni della capacità supportano i tag. Un tag è formato da una chiave e da un valore. Per tenere traccia dei costi in Athena, puoi utilizzare i tag di allocazione dei AWS costi generati. AWS utilizza i tag di allocazione dei costi per organizzare i costi delle risorse nel rapporto costi [e](https://docs.aws.amazon.com/cur/latest/userguide/what-is-cur.html) utilizzo. Ciò semplifica la categorizzazione e il AWS monitoraggio dei costi. Per attivare i tag di allocazione dei costi per Athena, utilizza la [console di Gestione dei costi e fatturazione AWS](https://console.aws.amazon.com/billing/).
Per ulteriori informazioni, consulta le risorse seguenti.
+ [Assegnare tag alle risorse di Athena](tags.md)
+ [Attivazione dei tag di allocazione dei AWS costi generati](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activate-built-in-tags.html)
+ [Utilizzo dei tag per l’allocazione dei costi AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)
# Crea prenotazioni della capacità
Per iniziare, crei una prenotazione di DPUs capacità con il numero richiesto, quindi assegni uno o più gruppi di lavoro che utilizzeranno tale capacità per le loro query. Puoi modificare la capacità in un secondo momento, in base alle tue esigenze, per fornire prestazioni più coerenti o gestire meglio i costi. Per informazioni sulla stima dei requisiti di capacità, consulta [Determina dei requisiti di capacità](capacity-management-requirements.md).
**Importante**
Le richieste di capacità non sono garantite e possono richiedere fino a 30 minuti per essere completate.
**Creazione di una prenotazione della capacità**
1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.
1. Scegli **Amministrazione**, **Prenotazioni della capacità**.
1. Scegli **Crea prenotazione della capacità**.
1. Nella pagina **Crea prenotazione della capacità**, per **Nome prenotazione della capacità**, inserisci il nome. Il nome deve essere univoco, da 1 a 128 caratteri e comprendere solo i seguenti caratteri A-z, A-z, 0-9, \$1(trattino basso), .(punto) e -(trattino). Dopo aver creato la prenotazione, non puoi modificare il nome.
1. Per **DPU**, scegli o inserisci il numero di unità di elaborazione dati (DPUs) che desideri, in incrementi di 4. Per ulteriori informazioni, consulta [Comprendi DPUs](capacity-management.md#capacity-management-understanding-dpus).
1. (Facoltativo) Espandi l'opzione **Tag**, quindi scegli **Aggiungi nuovo tag** per aggiungere una o più key/value coppie personalizzate da associare alla risorsa di prenotazione della capacità. Per ulteriori informazioni, consulta [Assegnare tag alle risorse di Athena](tags.md).
1. Scegli **Rivedi**.
1. Alla richiesta di **conferma della creazione della prenotazione della capacità**, conferma il numero di DPUs e altre informazioni. Regione AWS Se accetti, seleziona **Invia**.
Nella pagina dei dettagli, **lo stato** della prenotazione della capacità viene visualizzato come **In sospeso.** Quando la capacità della prenotazione è disponibile per eseguire le query, il relativo stato viene visualizzato come **Attivo**.
A questo punto, puoi aggiungere uno o più gruppi di lavoro alla tua prenotazione. Per le fasi, consulta [Aggiungi gruppi di lavoro a una prenotazione](capacity-management-adding-workgroups-to-a-reservation.md).
# Controlla l'utilizzo della capacità
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
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
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
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).
# Regola automaticamente la capacità
Puoi regolare automaticamente la capacità della tua prenotazione in risposta all'utilizzo del carico di lavoro utilizzando la soluzione di auto-scaling di Athena. Aggiunge automaticamente capacità quando l'utilizzo supera la soglia configurata e rimuove la capacità nei periodi di basso utilizzo per ridurre i costi. È possibile personalizzarne il comportamento impostando diverse soglie di utilizzo, quantità minime e massime di DPU, incrementi di scalabilità e frequenza di valutazione dell'utilizzo. In questo modo si eliminano le regolazioni manuali della capacità e si aiuta a bilanciare i requisiti prestazionali con l'ottimizzazione dei costi.
Questa soluzione serverless viene distribuita utilizzando un modello. CloudFormation Crea una macchina a stati Step Functions che monitora le metriche di utilizzo e prende decisioni sulla scalabilità. È possibile personalizzare ulteriormente il modello o la macchina a stati per soddisfare le proprie esigenze specifiche.
Per iniziare, usa la console Athena e scegli **Configura l'auto-scaling** nella pagina dei dettagli della prenotazione della capacità, che ti reindirizza al modello precaricato. CloudFormation In alternativa, segui la procedura riportata di seguito.
## Prerequisiti
+ È richiesta una prenotazione attiva della capacità
+ Autorizzazioni IAM richieste per la distribuzione di CloudFormation stack e la creazione di risorse Step Functions
## Avvia lo stack CloudFormation
Questo CloudFormation modello automatizzato implementa la soluzione di auto-scaling Athena Capacity Reservation. È necessario completare i passaggi applicabili [Prerequisiti](#capacity-management-auto-scaling-prerequisites) prima di avviare lo stack.
[https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?&templateURL=https:%2F%2Fathena-downloads.s3.us-east-1.amazonaws.com%2F%2Ftemplates%2F%2Fcapacity-reservation-scaling%2F%2Fstate-machine%2F%2Fathena-capacity-reservation-scaling-template-v1.1.yaml](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?&templateURL=https:%2F%2Fathena-downloads.s3.us-east-1.amazonaws.com%2F%2Ftemplates%2F%2Fcapacity-reservation-scaling%2F%2Fstate-machine%2F%2Fathena-capacity-reservation-scaling-template-v1.1.yaml)
**Per lanciare la soluzione di auto-scaling**
1. Accedi alla [console AWS di gestione](https://console.aws.amazon.com/) e seleziona il pulsante per avviare il `AWSAccelerator-InstallerStack` CloudFormation modello.
1. Per impostazione predefinita, il modello viene avviato negli Stati Uniti orientali (Virginia settentrionale). Per avviare la soluzione in un altro modo Regione AWS, utilizza il selettore della regione nella barra di navigazione della console.
1. **Nella pagina **Create stack**, verifica che l'URL del modello sia nella casella di testo URL **Amazon S3** e scegli Avanti.**
1. Nella pagina **Specificare i dettagli dello stack**, assegna un nome allo stack di soluzioni.
1. In **Parametri**, esaminate i parametri per questo modello di soluzione e modificateli se necessario. Questa soluzione utilizza i seguenti valori predefiniti.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/athena/latest/ug/capacity-management-automatically-adjust-capacity.html)
**Nota**
Tutti i valori della DPU devono essere multipli di 4 per soddisfare i requisiti di prenotazione della capacità di Athena.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Configure stack options (Configura opzioni pila)**, scegliere **Next (Successivo)**.
1. Nella pagina **Rivedi e crea**, rivedi e conferma le impostazioni. Seleziona la casella riconoscendo che il modello potrebbe creare risorse IAM.
1. Scegli **Invia** per distribuire lo stack.
**Puoi visualizzare lo stato dello stack nella CloudFormation console nella colonna Stato.** Dovresti ricevere uno `CREATE_COMPLETE` stato tra qualche minuto.
# Gestisci le prenotazioni
Puoi visualizzare e gestire le prenotazioni della capacità nella pagina **Prenotazioni della capacità**. Puoi eseguire attività di gestione come aggiungere o ridurre DPUs, modificare le assegnazioni dei gruppi di lavoro e etichettare o annullare le prenotazioni.
**Visualizzazione e gestione delle prenotazioni della capacità**
1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.
1. Seleziona **Amministrazione**, **Prenotazioni della capacità**.
1. Nella pagina delle prenotazioni della capacità, puoi eseguire le seguenti attività:
+ Per creare una prenotazione della capacità, scegliere **Crea prenotazione della capacità**.
+ Utilizza la casella di ricerca per filtrare le prenotazioni per nome o numero di. DPUs
+ Seleziona il menu a discesa dello stato per filtrare in base allo stato di prenotazione della capacità (ad esempio **Attivo** o **Annullato**). Per ulteriori informazioni sullo stato delle prenotazioni, consulta [Comprendi lo stato di prenotazione](#capacity-management-understanding-reservation-status).
+ Per visualizzare i dettagli di una prenotazione della capacità, scegli il link relativo alla prenotazione. La pagina dei dettagli della prenotazione include opzioni per [modificare la capacità](capacity-management-editing-capacity-reservations.md), [aggiungere gruppi di lavoro](capacity-management-adding-workgroups-to-a-reservation.md), [rimuovere gruppi di lavoro](capacity-management-removing-a-workgroup-from-a-reservation.md), e [annullare](capacity-management-cancelling-a-capacity-reservation.md) la prenotazione.
+ Per modificare una prenotazione (ad esempio, aggiungendo o rimuovendo DPUs), seleziona il pulsante relativo alla prenotazione, quindi scegli **Modifica**.
+ Per annullare una prenotazione, seleziona il relativo pulsante, quindi seleziona **Annulla**.
## Comprendi lo stato di prenotazione
La tabella seguente descrive i possibili valori di stato per una prenotazione della capacità.
****
| Stato | Description |
| --- | --- |
| Pending (In attesa) | Athena sta elaborando la tua richiesta di capacità. La capacità non è pronta per eseguire query. |
| Attivo | La capacità è disponibile per eseguire query. |
| Non riuscito | La richiesta di capacità non è stata completata correttamente. Tieni presente che l'adempimento delle richieste di capacità non è garantito. Le prenotazioni non riuscite vengono conteggiate ai fini dei limiti DPU dell'account. Per interrompere l'utilizzo, è necessario annullare la prenotazione. |
| Aggiornamento in sospeso | Athena sta elaborando una modifica alla prenotazione. Ad esempio, questo stato si verifica dopo aver modificato la prenotazione per aggiungerla o rimuoverla DPUs. |
| Annullamento in corso | Athena sta elaborando una richiesta di cancellazione della prenotazione. Le query ancora in esecuzione nei gruppi di lavoro che utilizzavano la prenotazione possono essere completate, ma le altre query del gruppo di lavoro utilizzeranno la capacità (non fornita) on demand. |
| Annullato | L'annullamento della prenotazione della capacità è stato completato. Le prenotazioni annullate rimangono nella console per 45 giorni. Dopo 45 giorni, Athena eliminerà la prenotazione. Durante i 45 giorni, non puoi ridefinire o riutilizzare la prenotazione, ma puoi fare riferimento ai tag e visualizzarne i dettagli per riferimenti cronologici. Non è garantito che la capacità annullata sia prenotabile in futuro. La capacità non può essere trasferita su un'altra prenotazione, Account AWS oppure Regione AWS. |
## Comprendi Active DPUs e Target DPUs
Nell'elenco delle prenotazioni della capacità nella console Athena, la prenotazione mostra due valori DPU: **DPU attive** e **DPU di destinazione**.
+ **DPU attiva**: il numero di DPUs quelle disponibili nella prenotazione per eseguire le query. **Ad esempio, se richiedi 100 e la richiesta viene soddisfatta DPUs, **Active DPU** visualizza 100.**
+ **DPU target**: il numero verso DPUs cui è in corso il trasferimento della prenotazione. La **DPU di destinazione** mostra un valore diverso dalla **DPU attiva** quando viene creata una prenotazione o è in sospeso un aumento o una diminuzione del numero di DPUs
**Ad esempio, dopo aver inviato una richiesta per creare una prenotazione con 24 DPUs, **lo stato** della prenotazione sarà **In sospeso**, la DPU **attiva sarà **0** e la DPU** di **destinazione** sarà 24.**
**Se hai una prenotazione con 100 DPUs e la modifichi per richiederne un aumento di 20 DPUs, **lo stato** sarà **Aggiornamento in sospeso**, la DPU **attiva sarà **100** e la DPU** **Target** sarà 120.**
**Se hai una prenotazione con 100 DPUs e la modifichi per richiederne una riduzione di 20 DPUs, **lo stato** sarà **Aggiornamento in sospeso**, la DPU **attiva sarà **100** e la DPU** **Target** sarà 80.**
Durante queste transizioni, Athena sta lavorando attivamente per acquisire o ridurre il numero DPUs di persone in base alla richiesta dell'utente. Quando la **DPU attiva** diventa uguale alla **DPU di destinazione**, il numero obiettivo è stato raggiunto e nessuna modifica è in sospeso.
Per recuperare questi valori a livello di codice, puoi richiamare l'azione dell'API. [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html) L'API fa riferimento alle **DPU attive** e alle **DPU di destinazione** come `AllocatedDpus` e `TargetDpus`.
**Topics**
+ [Comprendi lo stato di prenotazione](#capacity-management-understanding-reservation-status)
+ [Comprendi Active DPUs e Target DPUs](#capacity-management-understanding-dpu-status)
+ [Modifica le prenotazioni della capacità](capacity-management-editing-capacity-reservations.md)
+ [Aggiungi gruppi di lavoro a una prenotazione](capacity-management-adding-workgroups-to-a-reservation.md)
+ [Rimuovi un gruppo di lavoro da una prenotazione](capacity-management-removing-a-workgroup-from-a-reservation.md)
+ [Annulla una prenotazione della capacità](capacity-management-cancelling-a-capacity-reservation.md)
+ [Elimina una prenotazione della capacità](capacity-management-deleting-a-capacity-reservation.md)
# Modifica le prenotazioni della capacità
Dopo aver creato una prenotazione di capacità, puoi modificarne il numero DPUs e aggiungere o rimuovere i relativi tag personalizzati.
**Per modificare una prenotazione della capacità**
1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.
1. Seleziona **Amministrazione**, **Prenotazioni della capacità**.
1. Nell'elenco delle prenotazioni della capacità, effettua una delle seguenti operazioni:
+ Seleziona il pulsante accanto alla prenotazione, quindi scegli **Modifica**.
+ Seleziona il link di prenotazione, quindi seleziona **Modifica**.
1. Per **DPU**, scegli o inserisci il numero di unità di elaborazione dati che desideri. Per ulteriori informazioni, consulta [Comprendi DPUs](capacity-management.md#capacity-management-understanding-dpus).
**Nota**
Puoi richiedere di aggiungerla DPUs a una prenotazione di capacità attiva in qualsiasi momento.
Puoi richiedere di diminuire una prenotazione di capacità attiva quando è trascorso 1 minuto DPUs da quando la prenotazione è diventata attiva o quando è DPUs stata aggiunta l'ultima volta.
Quando richiedi una riduzione DPUs, Athena dà la priorità alla rimozione delle attività inattive rispetto a quelle attive. DPUs DPUs Se si stanno consumando DPUs query contrassegnate per la rimozione, Athena attende il completamento delle query prima di rimuovere il. DPUs
1. (Facoltativo) In **Tag** seleziona **Rimuovi** per rimuovere un tag oppure seleziona **Aggiungi nuovo tag** per aggiungere un nuovo tag.
1. Seleziona **Invia**. La pagina dei dettagli della prenotazione mostra la configurazione aggiornata.
# Aggiungi gruppi di lavoro a una prenotazione
Dopo aver creato una prenotazione della capacità, puoi aggiungere fino a 20 gruppi di lavoro alla prenotazione. L'aggiunta di un gruppo di lavoro a una prenotazione comunica ad Athena quali query devono essere eseguite sulla capacità riservata dell'utente. Le query provenienti da gruppi di lavoro non associati a una prenotazione continuano a essere eseguite utilizzando il modello di prezzo predefinito per terabyte (TB) scansionato.
Quando una prenotazione include due o più gruppi di lavoro, le query provenienti da tali gruppi di lavoro possono utilizzare la capacità della prenotazione. Puoi aggiungere e rimuovere regole gruppi di lavoro in qualunque momento. Quando aggiungi o rimuovi gruppi di lavoro, le query in esecuzione non vengono interrotte.
Quando la prenotazione è in sospeso, le query dei gruppi di lavoro aggiunti continuano a essere eseguite utilizzando il modello di prezzo predefinito per terabyte (TB) scansionato fino a quando la prenotazione non diventa attiva.
**Come aggiungere uno o più gruppi di lavoro alla prenotazione della capacità**
1. Nella pagina dei dettagli della prenotazione della capacità, seleziona **Aggiungi gruppi di lavoro**.
1. Nella pagina **Aggiungi gruppi di lavoro**, seleziona i gruppi di lavoro che intendi aggiungere, quindi seleziona **Aggiungi gruppi di lavoro**. Non è possibile assegnare un gruppo di lavoro a più di una prenotazione.
La pagina dei dettagli della prenotazione della capacità elenca i gruppi di lavoro aggiunti. Le query eseguite in tali gruppi di lavoro utilizzeranno la capacità che hai riservato quando la prenotazione è attiva.
# Rimuovi un gruppo di lavoro da una prenotazione
Se non hai più bisogno di capacità da destinare a un gruppo di lavoro o intendi spostare un gruppo di lavoro nella sua prenotazione, puoi rimuoverlo in qualsiasi momento. La rimozione di un gruppo di lavoro da una prenotazione è un processo semplice. Dopo aver rimosso un gruppo di lavoro da una prenotazione, le query del gruppo di lavoro rimosso tornano a utilizzare la capacità su richiesta e vengono fatturate in base ai terabyte (TB) scansionati.
**Rimozione di uno o più gruppi di lavoro da una prenotazione**
1. Nella pagina dei dettagli per la prenotazione della capacità, seleziona i gruppi di lavoro che intendi rimuovere.
1. Seleziona **Rimuovi gruppi di lavoro**. La richiesta **Rimuovere i gruppi di lavoro**? ti comunica che tutte le query attualmente attive termineranno prima che il gruppo di lavoro venga rimosso dalla prenotazione..
1. Scegli **Rimuovi**. La pagina dei dettagli della prenotazione della capacità mostra che i gruppi di lavoro rimossi non sono più presenti.
# Annulla una prenotazione della capacità
Se non desideri più utilizzare una prenotazione della capacità, puoi annullarla. Le query ancora in esecuzione nei gruppi di lavoro che utilizzavano la prenotazione potranno terminare, ma le altre query del gruppo di lavoro non utilizzeranno più la prenotazione.
**Nota**
Non è garantito che la capacità annullata sia prenotabile in futuro. La capacità non può essere trasferita su un'altra prenotazione, oppure. Account AWS Regione AWS
**Come annullare una prenotazione della capacità**
1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.
1. Seleziona **Amministrazione**, **Prenotazioni della capacità**.
1. Nell'elenco delle prenotazioni della capacità, effettua una delle seguenti operazioni:
+ Seleziona il pulsante accanto alla prenotazione, quindi seleziona **Annulla**.
+ Seleziona il link di prenotazione, quindi seleziona **Annulla prenotazione della capacità**.
1. Nella sezione **Annullare la prenotazione della capacità?** richiedi, inserisci **annulla**, quindi scegli **Annulla prenotazione della capacità**.
Lo stato della prenotazione cambia in **Annullamento** e un banner sullo stato di avanzamento ti comunica che è in corso l'annullamento.
Una volta completato l'annullamento, la prenotazione della capacità rimane invariata, ma lo stato viene visualizzato come **Annullato**. La prenotazione verrà cancellata 45 giorni dopo l'annullamento. Durante i 45 giorni, non puoi ridefinire o riutilizzare una prenotazione che è stata annullata, ma puoi fare riferimento ai relativi tag e visualizzarla come riferimento cronologico.
# Elimina una prenotazione della capacità
Se desideri rimuovere tutti i riferimenti a una prenotazione della capacità annullata, puoi eliminare la prenotazione. Una prenotazione deve essere annullata prima di poter essere eliminata. Una prenotazione eliminata viene immediatamente rimossa dal tuo account e non può più essere referenziata, nemmeno dal relativo ARN.
**Come eliminare una prenotazione della capacità**
1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.
1. Seleziona **Amministrazione**, **Prenotazioni della capacità**.
1. Nell'elenco delle prenotazioni della capacità, effettua una delle seguenti operazioni:
+ Seleziona il pulsante accanto alla prenotazione annullata, quindi scegli **Operazioni**, **Elimina**.
+ Seleziona il link di prenotazione, quindi seleziona **Elimina**.
1. Quando viene richiesto **Eliminare la prenotazione della capacità?**, seleziona **Elimina**.
Un banner ti informa che la prenotazione della capacità è stata eliminata con successo. La prenotazione eliminata non appare più nell'elenco delle prenotazioni della capacità.
# Policy IAM per le prenotazioni della capacità
Per controllare l'accesso alle prenotazione della capacità, utilizza le autorizzazioni IAM a livello di risorsa o le policy IAM basate sull'identità. Ogni volta che si utilizzano le policy IAM, assicurati di seguire le best practice IAM. Per ulteriori informazioni, consulta [Best Practice di sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) nella *Guida per l'utente di IAM*.
La seguente procedura è specifica di Athena.
Per informazioni specifiche su IAM, segui i collegamenti elencati alla fine di questa sezione. Per informazioni sulle policy JSON di esempio relative alle prenotazioni della capacità, consulta [Esempi di norme sulla prenotazione della capacità](example-policies-capacity-reservations.md).
**Come utilizzare l'editor visivo nella console IAM per creare una policy di prenotazione della capacità**
1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel pannello di navigazione sulla sinistra, selezionare **Policies** (Policy) e fare clic su **Create Policy** (Crea policy).
1. Nella scheda **Visual editor (Editor visivo)**, selezionare **Choose a Service (Scegli un servizio)**. Quindi selezionare Athena per aggiungerlo alla policy.
1. Scegliere **Select actions (Seleziona operazioni)**, quindi scegliere le operazioni da aggiungere alla policy. L'editor visivo mostra le operazioni disponibili in Athena. Per ulteriori informazioni, consulta [Operazioni, risorse e chiavi di condizione per Amazon Athena](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonathena.html) nella *Documentazione di riferimento per l'autorizzazione ai servizi*.
1. Seleziona **add actions** per immettere un'operazione specifica oppure usa i caratteri jolly (\$1) per specificare più operazioni.
Come impostazione predefinita, la policy che si sta creando utilizza le operazioni selezionate. Se si selezionano una o più operazioni che supportano le autorizzazioni a livello di risorsa per la risorsa `capacity-reservation` in Athena, l'editor elenca la risorsa `capacity-reservation`
1. Seleziona **Risorse** per specificare le prenotazioni della capacità specifiche della tua policy. Per le policy JSON di esempio relative alla prenotazione della capacità, consulta [Esempi di norme sulla prenotazione della capacità](example-policies-capacity-reservations.md).
1. Specificare la risorsa `capacity-reservation` come segue:
```
arn:aws:athena:::capacity-reservation/
```
1. Scegliere **Review policy (Rivedi policy)** e digitare i valori per **Name (Nome)** e **Description (Descrizione)** (facoltativa) per la policy che si sta creando. Esaminare il riepilogo della policy per accertarsi di disporre delle autorizzazioni desiderate.
1. Seleziona **Crea policy** per salvare la nuova policy.
1. Allega questa policy basata su un'identità a un utente, un gruppo o un ruolo.
Per ulteriori informazioni, consulta gli argomenti seguenti nella *Referenza sull'autorizzazione del servizio* e nella *Guida per l'utente di IAM*:
+ [Operazioni, risorse e chiavi di condizione per Amazon Athena](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonathena.html)
+ [Creazione di policy con l'editor visivo](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-visual-editor)
+ [Aggiunta e rimozione delle policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)
+ [Controllo dell'accesso alle risorse](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_controlling.html#access_controlling-resources)
Per le policy JSON di esempio relative alla prenotazione della capacità, consulta [Esempi di norme sulla prenotazione della capacità](example-policies-capacity-reservations.md).
Per un elenco completo delle operazioni Amazon Athena, consulta i nomi delle operazioni API nella [documentazione di riferimento dell'API Amazon Athena](https://docs.aws.amazon.com/athena/latest/APIReference/).
# Esempi di norme sulla prenotazione della capacità
Questa sezione include policy di esempio che puoi utilizzare per abilitare varie operazioni sulle prenotazioni della capacità. Ogni volta che si utilizzano le policy IAM, assicurati di seguire le best practice IAM. Per ulteriori informazioni, consulta [Best Practice di sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) nella *Guida per l'utente di IAM*.
Una prenotazione della capacità è una risorsa IAM gestita da Athena. Pertanto, se la policy della prenotazione della capacità utilizza operazioni che accettano `capacity-reservation` come input, è necessario specificare l'ARN della prenotazione della capacità nel modo seguente:
```
"Resource": [arn:aws:athena:::capacity-reservation/]
```
``Dov'è il nome della tua prenotazione della capacità. Ad esempio, per una prenotazione della capacità denominata `test_capacity_reservation`, specificala come risorsa nel modo seguente:
```
"Resource": ["arn:aws:athena:us-east-1:123456789012:capacity-reservation/test_capacity_reservation"]
```
Per un elenco completo delle operazioni Amazon Athena, consulta i nomi delle operazioni API nella [documentazione di riferimento dell'API Amazon Athena](https://docs.aws.amazon.com/athena/latest/APIReference/). Per ulteriori informazioni sulle policy IAM, consulta [Creazione di policy con l'editor visivo](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-visual-editor) nella *Guida per l'utente di IAM*.
**Example Esempio di policy per elencare le prenotazioni della capacità**
La policy seguente consente a tutti gli utenti di elencare tutte le prenotazioni di capacità.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"athena:ListCapacityReservations"
],
"Resource": "*"
}
]
}
```
**Example Esempio di policy per le operazioni di gestione**
La seguente policy consente a un utente di creare, annullare, ottenere dettagli e aggiornare la prenotazione della capacità `test_capacity_reservation`. La policy consente inoltre a un utente di assegnare `workgroupA` e `workgroupB` a `test_capacity_reservation`.
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect": "Allow",
"Action": [
"athena:CreateCapacityReservation",
"athena:GetCapacityReservation",
"athena:CancelCapacityReservation",
"athena:UpdateCapacityReservation",
"athena:GetCapacityAssignmentConfiguration",
"athena:PutCapacityAssignmentConfiguration"
],
"Resource": [
"arn:aws:athena:us-east-1:123456789012:capacity-reservation/test_capacity_reservation",
"arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA",
"arn:aws:athena:us-east-1:123456789012:workgroup/workgroupB"
]
}
]
}
```
# Prenotazione di capacità Athena APIs
L'elenco seguente contiene collegamenti di riferimento alle operazioni API relative alla prenotazione della capacità in Athena. Per le strutture dei dati e altre operazioni dell'API Athena, consulta la [https://docs.aws.amazon.com/athena/latest/APIReference/](https://docs.aws.amazon.com/athena/latest/APIReference/).
+ [CancelCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_CancelCapacityReservation.html)
+ [CreateCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_CreateCapacityReservation.html)
+ [DeleteCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_DeleteCapacityReservation.html)
+ [GetCapacityAssignmentConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityAssignmentConfiguration.html)
+ [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html)
+ [ListCapacityReservations](https://docs.aws.amazon.com/athena/latest/APIReference/API_ListCapacityReservations.html)
+ [PutCapacityAssignmentConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_PutCapacityAssignmentConfiguration.html)
+ [UpdateCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_UpdateCapacityReservation.html)