Athena エンジンバージョンの変更 - Amazon Athena
ワークグループのクエリエンジンバージョンの確認Athena コンソールでのエンジンバージョンの変更AWS CLI を使用したエンジンバージョンの変更ワークグループの作成時におけるエンジンバージョンの指定エンジンバージョンをアップグレードする前のクエリのテスト失敗するクエリのトラブルシューティング

Athena エンジンバージョンの変更

Athena は、パフォーマンスと機能の改善、およびコードの修正を反映するために、新しいエンジンバージョンをリリースすることがあります。新しいエンジンバージョンが利用可能になると、Athena はコンソールで通知を行います。ユーザーは、アップグレードするタイミングを Athena に決定させる、またはワークグループごとに Athena エンジンのバージョンを手動で指定する選択ができます。

ワークグループのクエリエンジンバージョンの確認

[Workgroups] (ワークグループ) ページから、任意のワークグループの現在のエンジンバージョンを確認することができます。

ワークグループの現在のエンジンバージョンを確認する

  1. https://console.aws.amazon.com/athena/ で Athena コンソールを開きます。

  2. コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。

    展開メニューを選択します。

  3. Athena コンソールのナビゲーションペインで、[Workgroups] (ワークグループ) をクリックします。

  4. [Workgroups] (ワークグループ) ページで、目的のワークグループを探します。ワークグループの [Query engine version] (クエリエンジンのバージョン) 列には、クエリエンジンのバージョンが表示されています。

Athena コンソールでのエンジンバージョンの変更

新しいエンジンバージョンが利用可能になると、アップグレードするタイミングを Athena に決定させる、またはワークグループが使用する Athena のエンジンバージョンを手動で指定することを選択できます。使用できるバージョンが 1 つしかない場合は、別のバージョンを指定できません。

注記

ワークグループのエンジンバージョンを変更するには、ワークグループで athena:ListEngineVersions アクションを実行する許可が必要です。IAM ポリシーの例については、「ワークグループのポリシーの例」を参照してください。

Athena にワークグループをアップグレードするタイミングを決定させる

  1. https://console.aws.amazon.com/athena/ で Athena コンソールを開きます。

  2. コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。

  3. コンソールのナビゲーションペインで、[Workgroups] (ワークグループ) をクリックします。

  4. ワークグループのリストで、設定するワークグループへのリンクを選択します。

  5. [編集] を選択します。

  6. [Query engine version] (クエリエンジンのバージョン) セクションにある [Update query engine] (クエリエンジンを更新) で、[Automatic] (自動) を選択し、ワークグループのアップグレードタイミングを Athena が選択できるようにします。これはデフォルトの設定です。

  7. [Save changes] (変更の保存) をクリックします。

    ワークグループのリストでは、ワークグループの [Query engine update status] (クエリエンジンの更新ステータス) に [Automatic] (自動) と表示されます。

エンジンのバージョンを手動で選択する

  1. https://console.aws.amazon.com/athena/ で Athena コンソールを開きます。

  2. コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。

  3. コンソールのナビゲーションペインで、[Workgroups] (ワークグループ) をクリックします。

  4. ワークグループのリストで、設定するワークグループへのリンクを選択します。

  5. [編集] を選択します。

  6. 手動でエンジンバージョンを選択するには、[Query engine version] (クエリエンジンのバージョン) セクションにある [Update query engine] (クエリエンジンを更新) で、[Manual] (手動) を選択します。

  7. ワークグループで使用するエンジンのバージョンを自分で選択する場合は、[Query engine version] (クエリエンジンのバージョン) オプションを使用します。他に使用できるエンジンバージョンがない場合は、別のエンジンバージョンを指定することはできません。

  8. [Save changes] (変更の保存) をクリックします。

    ワークグループのリストでは、ワークグループの [Query engine update status] (クエリエンジンの更新ステータス) に [Manual] (手動) と表示されます。

AWS CLI を使用したエンジンバージョンの変更

AWS CLI を使用してエンジンバージョンを変更するには、次の例にある構文を使用します。

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

ワークグループの作成時におけるエンジンバージョンの指定

ワークグループを作成するときは、ワークグループが使用するエンジンバージョンを指定する、または Athena にワークグループをアップグレードするタイミングを決定させることができます。利用可能な新しいエンジンバージョンがある場合のベストプラクティスは、他のワークグループをアップグレードする前に、別にワークグループを作成して新しいエンジンのテストを行うことです。ワークグループのエンジンバージョンを指定するには、ワークグループに対する athena:ListEngineVersions 許可が必要です。IAM ポリシーの例については、「ワークグループのポリシーの例」を参照してください。

ワークグループの作成時にエンジンバージョンを指定する

  1. https://console.aws.amazon.com/athena/ で Athena コンソールを開きます。

  2. コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。

  3. コンソールのナビゲーションペインで、[Workgroups] (ワークグループ) をクリックします。

  4. [Workgroups] (ワークグループ) ページで、[Create workgroup] (ワークグループを作成する) をクリックします。

  5. [Create workgroup] (ワークグループの作成) ページにある [Query engine version] (クエリエンジンのバージョン) セクションで、以下のいずれかを実行します。

    • ワークグループをアップグレードするタイミングを Athena に選択させる場合は、[Automatic] (自動) を選択します。これはデフォルトの設定です。

    • 別の使用可能なエンジンバージョンを手動で選択する場合は、[Manual] (手動) を選択します。

  6. 必要に応じて、他のフィールドに情報を入力します。他のフィールドについては、「ワークグループの作成」を参照してください。

  7. [Create workgroup] (ワークグループの作成) を選択します。

エンジンバージョンをアップグレードする前のクエリのテスト

ワークグループが新しいエンジンバージョンにアップグレードされると、互換性の問題が原因となり一部のクエリが破損する場合があります。エンジンバージョンのアップグレードがスムーズに行われることを確実にするには、事前にクエリをテストすることができます。

エンジンバージョンのアップグレード前にクエリをテストする

  1. 使用しているワークグループのエンジンバージョンを確認します。使用しているエンジンのバージョンが、[Workgroups] (ワークグループ) ページで、対象のワークグループの [Query engine version] (クエリエンジンのバージョン) 列に表示されます。詳細については、「ワークグループのクエリエンジンバージョンの確認」を参照してください。

  2. 新しいエンジンバージョンを使用するテストワークグループを作成します。詳細については、「」を参照してくださいワークグループの作成時におけるエンジンバージョンの指定

  3. 新しいワークグループを使用して、テストするクエリを実行します。

  4. クエリが失敗した場合は、「Athena エンジンバージョンリファレンス」を使用して、クエリに影響を及ぼしている可能性がある破壊的変更をチェックします。変更には、クエリ構文の更新が必要になるものもあります。

  5. それでもクエリが失敗する場合は、AWS Support に連絡してサポートを受けてください。Adding a change AWS Management Console で、[Support] (サポート)、[Support Center] (サポートセンター) の順にクリックします。または、[Amazon Athena] タグを使用して AWS re:Post に質問します。

失敗するクエリのトラブルシューティング

エンジンバージョンのアップグレード後にクエリが失敗した場合は、「Athena エンジンバージョンリファレンス」を使用して、クエリの構文に影響を及ぼす可能性がある変更を含めた破壊的変更をチェックしてください。

それでもクエリが失敗する場合は、AWS Support に連絡してサポートを受けてください。AWS Management Console で、[Support] (サポート)、[Support Center] (サポートセンター) の順にクリックします。または、[Amazon Athena] タグを使用して AWS re:Post に質問します。