Athena engine versioning - Amazon Athena
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Athena engine versioning

Athena occasionally releases a new engine version to provide improved performance, functionality, and code fixes. When a new engine version is available, Athena notifies you through the Athena console and your Amazon Health Dashboard. Your Amazon Health Dashboard notifies you about events that can affect your Amazon services or account. For more information about Amazon Health Dashboard, see Getting started with the Amazon Health Dashboard.

Engine versioning is configured per workgroup. You can use workgroups to control which query engine your queries use. The query engine that is in use is shown in the query editor, on the details page for the workgroup, and by the Athena APIs.

You can choose to upgrade your workgroups as soon as a new engine is available or continue using the older version until it is no longer supported. You can also let Athena decide when to upgrade your workgroups. This is the default setting. If you take no action, Athena notifies you in advance prior to upgrading your workgroups. If you let Athena decide, Athena upgrades your workgroups for you unless it finds incompatibilities.

When you start using a new engine version, a small subset of queries may break due to incompatibilities. You can use workgroups to test your queries in advance of the upgrade by creating a test workgroup that uses the new engine or by test upgrading an existing workgroup. For more information, see Testing queries in advance of an engine version upgrade.