はじめに

『Athena エンジンの自動アップグレードは、2023 年 5 月 1 日の 70 日後に開始されます。』
という案内がきてたので、事前に業務で使ってるSQLが互換するか事前に確認したという話です。

確認方法

案内によると期限来ると自動でDBエンジンがV2→V3に切り替わるので、事前にSQLが動くか確認せよ！という事なので、手動でDBエンジンを切り替えて、クエリの実行確認後に、また自動切換えモードに戻しておく。という一連の作業をしたのでメモ書きします。

それぞれの制約が書いてあります。関係ありそうな関数をSQL側で利用していないか机上確認を実施します。
（関係ありそうな関数を利用していなかったので、関数固有のお話は今回のメモ書きには登場しません。）

手動のDBエンジン切り替え

上記の画面で、『自動　→　手動』と『クエリエンジンのバージョン：Athena engine version 3 』に変更する事で切り替えます。

SQLの実行

利用しているSQL（実行可能な状態）をプログラム（かログから）抽出して、管理コンソールの『クエリエディタ』で実行して、動作確認を実施します。

影響ある関数を利用しているのであれば、項目の値もチェックする必要があると思いますが、SQLの成功・失敗のレベルで確認します。

自動アップデートへの戻し

V3バージョンアップが終わって、将来V4バージョンアップも来ることに備えて、自動アップデートに戻しておきます。

変更を保存して作業終了です。

参考：案内原文（機械翻訳版）

こんにちは

Athena エンジンの自動アップグレードは、2023 年 5 月 1 日の 70 日後に開始されます。ワークグループをアップグレードする前に、一連の検証テストを実行して、そのクエリがエンジンバージョン 3 で正しく効率的に実行されることを確認します。すべてのお客様が独自の検証テストを実行し、次のプラクティスに従って、すべてのクエリが期待どおりに実行されることを確認することをお勧めします。

Athena エンジンバージョン 3 の制限事項 [1] と重大な変更点 [2] を確認し、影響を受けるクエリを更新します。
テストワークグループを作成するか、既存の本番前環境をアップグレードすることにより、Athena エンジンバージョン 3 に対するクエリを検証および認定するために、本番前でテストします。たとえば、エンジンバージョン 3 を実行する新しいテストワークグループを作成して、運用前またはステージング環境から統合テストを実行し、障害やパフォーマンスの低下を監視できます。 Athena によって公開された CloudWatch メトリクスとディメンションの詳細については、CloudWatch メトリクスを使用した Athena クエリのモニタリング [3] を参照してください。
メトリクスに基づいて各クエリをアップグレードし、Athena エンジンバージョン 3 ワークグループに対してクエリをテストします。たとえば、エンジンバージョン 3 の新しいワークグループを、既存のエンジンバージョン 2 ワークグループと一緒に作成できます。ごく一部のクエリをエンジンバージョン 3 ワークグループに送信し、障害やパフォーマンスの低下を監視し、クエリが成功してパフォーマンスが向上した場合は、クエリの数を増やすことができます。すべてのクエリが Athena エンジンバージョン 3 に移行されるまで繰り返します。

エンジンバージョン 3 の改善点と変更点の詳細については、「Athena エンジンバージョンリファレンス」ドキュメント [4] を参照してください。「自動アップグレード」に設定されていないワークグループをアップグレードする方法については、「Changing Athena engine versions」ドキュメント [5] を参照してください。

ご質問やご不明な点がございましたら、AWS サポート [6] までお問い合わせください。

[1] https://docs.aws.amazon.com/athena/latest/ug/engine-versions-reference-0003.html#engine-versions-reference-0003-known-limitations
[2] https://docs.aws.amazon.com/athena/latest/ug/engine-versions-reference-0003.html#engine-versions-reference-0003-breaking-changes
[3] https://docs.aws.amazon.com/athena/latest/ug/query-metrics-viewing.html
[4] https://docs.aws.amazon.com/athena/latest/ug/engine-versions-reference.html
[5] https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html
[6] https://aws.amazon.com/support

AWSの相談・お困りごとありましたら、、、

AWSの活用方法や、お困りごとの相談、随時、お仕事の受付しております。