Modificare le versioni del motore Athena - Amazon Athena

Modificare le versioni del motore Athena

Athena rilascia occasionalmente una nuova versione del motore per fornire prestazioni migliorate, nuove funzionalità e correzioni di codice. Quando è disponibile una nuova versione del motore, Athena ti avvisa nella console. Puoi scegliere se lasciare che Athena decida quando eseguire l'aggiornamento o specificare manualmente una versione del motore Athena per gruppo di lavoro.

È possibile utilizzare anche la pagina Workgroups (Gruppi di lavoro) per trovare la versione corrente del motore per qualsiasi gruppo di lavoro.

Per trovare la versione corrente del motore per qualsiasi gruppo di lavoro

  1. Aprire la console Athena all'indirizzo https://console.aws.amazon.com/athena/.

  2. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.

    Scegli il menu di espansione.

  3. Nel pannello di navigazione della console Athena, scegli Workgroups (Gruppi di lavoro).

  4. Nella pagina Workgroups (Gruppi di lavoro), trova il gruppo di lavoro che desideri. Nella colonna Query engine version (Versione del motore di query) per il gruppo di lavoro viene visualizzata la versione del motore di query.

Quando è disponibile una nuova versione del motore, è possibile scegliere se consentire ad Athena di decidere quando aggiornare il gruppo di lavoro o specificare manualmente la versione del motore Athena utilizzata dal gruppo di lavoro. Se attualmente è disponibile solo una versione, non è possibile specificare manualmente una versione diversa.

Nota

Per modificare la versione del motore per un gruppo di lavoro, è necessario disporre dell'autorizzazione a eseguire il l'azione athena:ListEngineVersions sul gruppo di lavoro. Per esempi di policy IAM, consulta Esempi di policy per i gruppi di lavoro.

Delega ad Athena l'aggiornamento del gruppo di lavoro

  1. Aprire la console Athena all'indirizzo https://console.aws.amazon.com/athena/.

  2. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.

  3. Nel pannello di navigazione della console, scegli Workgroups (Gruppi di lavoro).

  4. Nell'elenco dei gruppi di lavoro, scegli il link per il gruppo di lavoro che desideri configurare.

  5. Scegli Modifica.

  6. Nella sezione Query engine version (Versione del motore di query), per Update query engine (Aggiornamento del motore di query), scegli Automatic (Automatico) per delegare ad Athena l'aggiornamento del gruppo di lavoro. Questa è l'impostazione predefinita.

  7. Scegli Save changes (Salva modifiche).

    Nell'elenco dei gruppi di lavoro, Query engine update status (Stato di aggiornamento del motore di query) per il gruppo di lavoro mostra Automatic (Automatico).

Per scegliere manualmente una versione del motore

  1. Aprire la console Athena all'indirizzo https://console.aws.amazon.com/athena/.

  2. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.

  3. Nel pannello di navigazione della console, scegli Workgroups (Gruppi di lavoro).

  4. Nell'elenco dei gruppi di lavoro, scegli il link per il gruppo di lavoro che desideri configurare.

  5. Scegli Modifica.

  6. Nella sezione Query engine version (Versione del motore di query), per Update query engine (Aggiornamento del motore di query), scegli Manual (Manuale) per scegliere manualmente una versione del motore.

  7. Utilizza l'opzione Query engine version (Versione del motore di query) per scegliere la versione del motore che intendi utilizzare nel gruppo di lavoro. Non puoi specificare una versione diversa del motore se non è disponibile.

  8. Scegli Save changes (Salva modifiche).

    Nell'elenco dei gruppi di lavoro, Query engine update status (Stato di aggiornamento del motore di query) per il gruppo di lavoro mostra Manual (Manuale).

Per modificare la versione del motore tramite la AWS CLI, utilizza la sintassi dell'esempio seguente.

aws athena update-work-group --work-group workgroup-name --configuration-updates EngineVersion={SelectedEngineVersion='Athena engine version 3'}

Quando si crea un gruppo di lavoro, è possibile specificare la versione del motore utilizzata dal gruppo di lavoro o consentire ad Athena di decidere quando aggiornare il gruppo di lavoro. Se è disponibile una nuova versione del motore, una best practice consiste nel creare un gruppo di lavoro per testare il nuovo motore prima di aggiornare gli altri gruppi di lavoro. Per specificare la versione del motore per un gruppo di lavoro, è necessario disporre dell'autorizzazione athena:ListEngineVersions sul gruppo di lavoro. Per esempi di policy IAM, consulta Esempi di policy per i gruppi di lavoro.

Per specificare la versione del motore quando si crea un gruppo di lavoro

  1. Aprire la console Athena all'indirizzo https://console.aws.amazon.com/athena/.

  2. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.

  3. Nel pannello di navigazione della console, scegli Workgroups (Gruppi di lavoro).

  4. Nella pagina Gruppi di lavoro scegli Crea gruppo di lavoro.

  5. Nella pagina Create workgroup (Crea gruppo di lavoro), nella sezione Query engine version (Versione del motore di query), effettua una delle seguenti operazioni:

    • Scegli Automatic (Automatico) per delegare ad Athena l'aggiornamento del gruppo di lavoro. Questa è l'impostazione predefinita.

    • Scegli Manual per scegliere manualmente una versione del motore diversa se disponibile.

  6. Inserisci le informazioni per gli altri campi, se necessario. Per informazioni su altri campi, consulta Creare un gruppo di lavoro.

  7. Selezionare Create workgroup (Crea gruppo di lavoro).

Quando un gruppo di lavoro viene aggiornato a una nuova versione del motore, alcune delle query potrebbero interrompersi a causa di incompatibilità. Per assicurarsi che l'aggiornamento della versione del motore vada senza intoppi, è possibile testare le query in anticipo.

Per testare le query prima dell'aggiornamento della versione del motore

  1. Verificare la versione del motore del gruppo di lavoro che si sta utilizzando. La versione del motore che si sta utilizzando viene visualizzata nella pagina Workgroups (Gruppi di lavoro) nella colonna Query engine version (Versione del motore di query) per il gruppo di lavoro. Per ulteriori informazioni, consulta Ricercare la versione del motore per un gruppo di lavoro.

  2. Crea un gruppo di lavoro di prova che utilizzi la nuova versione del motore. Per ulteriori informazioni, consulta Specificare la versione del motore quando si crea un gruppo di lavoro.

  3. Utilizza il nuovo gruppo di lavoro per eseguire le query che desideri verificare.

  4. Se una query non riesce, verificare l'interruzione delle modifiche nel nuovo motore che potrebbero influire sulla query. Alcune modifiche potrebbero richiedere l'aggiornamento della sintassi delle query.

  5. Se le query continuano a fallire, contatta Supporto AWS per ricevere assistenza. Nella Console di gestione AWS, scegliere Support, Support Center, oppure fare una domanda su AWS re:Post utilizzando il tag Amazon Athena.

Se una query ha esito negativo dopo un aggiornamento della versione del motore, verificare l'interruzione delle modifiche, incluse le modifiche che potrebbero influire sulla sintassi delle query.

Se le query continuano a fallire, contatta Supporto AWS per ricevere assistenza. Nella Console di gestione AWS, selezionare Support, Support Center, oppure fare una domanda su AWS re:Post utilizzando il tag Amazon Athena.