Athena Engine Versioning - Amazon Athena

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 AWS Personal Health Dashboard. Your AWS Personal Health Dashboard notifies you about events that can affect your AWS services or account. For more information about AWS Personal Health Dashboard, see Getting started with the AWS Personal 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.