View a markdown version of this page

データソースコネクタを更新する - Amazon Athena

データソースコネクタを更新する

最新バージョンを使用して新機能と機能強化を利用するために、Athena ではデータソースコネクタを定期的に更新することを推奨しています。データソースコネクタの更新には、次のステップが含まれます。

Lambda を使用した AWS Glue Data Catalog フェデレーションコネクタ

最新バージョンの Athena Query Federation を確認する

Athena データソースコネクタの最新バージョン番号は、最新の Athena Query Federation バージョンに対応しています。特定のケースでは、GitHub のリリースが AWS Serverless Application Repository (SAR) で入手可能なリリースよりも少し新しい可能性があります。

最新の Athena Query Federation バージョン番号を確認するには
  1. GitHub URL (https://github.com/awslabs/aws-athena-query-federation/releases/latest) を確認してください。

  2. メインページの見出し次の形式のようになっており、そこからリリース番号を書き留めます。

    Release v .年の X 週目.週の周期 of Athena Query Federation

    例えば、Release v2023.8.3 of Athena Query Federation のリリース番号は 2023.8.3 です。

コネクタバージョンの検索

現在使用しているコネクタのバージョンを確認するには、次の手順に従います。

コネクタバージョンを検索するには
  1. Lambda アプリケーションの Lambda コンソールページで、[イメージ] タブを選択します。

  2. [イメージ] タブで、イメージ URI を見つけます。URI は次の形式に従います。

    Image_location_account.dkr.ecr.us-west-2.amazonaws.com/athena-federation-repository:Version
  3. イメージ URI のバージョン番号は、形式 year.week_of_year.iteration_of_week (例: 2021.42.1) に従います。この数値はコネクタバージョンを表しています。

新しいコネクタバージョンのデプロイ

新しいバージョンのコネクタをデプロイするには、次のステップに従います。

新しいコネクタバージョンをデプロイするには
  1. 最新バージョンの Athena Query Federation を確認する手順に従って、必要なバージョンを検索します。

  2. フェデレーティッドコネクタの Lambda 関数で、Image URI を見つけ、タグを希望のバージョンに更新します。例えば、次のようになります。

    変更前:

    509399631660.dkr.ecr.us-east-1.amazonaws.com/athena-federation-repository:2025.15.1

    変更後:

    509399631660.dkr.ecr.us-east-1.amazonaws.com/athena-federation-repository:2025.26.1
注記

現在のバージョンが 2025.15.1 より古い場合は、次の重要な変更点に注意してください。

  • リポジトリ名が athena-federation-repository に更新されました

  • この更新より前のバージョンでは、コマンドオーバーライドが設定されていない可能性があります。複合ハンドラーに設定する必要があります。

Athena データカタログフェデレーションコネクタ

最新バージョンの Athena Query Federation を確認する

Athena データソースコネクタの最新バージョン番号は、最新の Athena Query Federation バージョンに対応しています。特定のケースでは、GitHub のリリースが AWS Serverless Application Repository (SAR) で入手可能なリリースよりも少し新しい可能性があります。

最新の Athena Query Federation バージョン番号を確認するには
  1. GitHub URL (https://github.com/awslabs/aws-athena-query-federation/releases/latest) を確認してください。

  2. メインページの見出し次の形式のようになっており、そこからリリース番号を書き留めます。

    Release v .年の X 週目.週の周期 of Athena Query Federation

    例えば、Release v2023.8.3 of Athena Query Federation のリリース番号は 2023.8.3 です。

リソース名を検索して書き留める

アップグレードの準備として、次の情報を確認して書き留めておく必要があります:

  1. コネクタの Lambda 関数名。

  2. Lambda 関数の環境変数。

  3. コネクタの Lambda 関数を管理する Lambda アプリケーション名。

Athena コンソールからリソース名を検索するには
  1. https://console.aws.amazon.com/athena/ で Athena コンソールを開きます。

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

    展開メニューを選択します。
  3. ナビゲーションペインで、[データソースとカタログ] を選択します。

  4. [データソース名] 列で、コネクタのデータソースへのリンクを選択します。

  5. [データソースの詳細] セクションの [Lambda 関数] で、Lambda 関数へのリンクを選択します。

    Lambda 関数へのリンクを選択します。
  6. [関数] ページの [関数名] 列で、コネクタの関数名を見つけて書き留めます。

    関数名を書き留めます。
  7. 関数名のリンクを選択します。

  8. [関数の概要] セクションで、[構成] タブを選択します。

  9. 左側のペインで、[環境変数] をクリックします。

  10. 環境変数」セクションで、キーとそれに対応する値を見つけて書き留めます。

  11. ページの上部までスクロールします。

  12. メッセージ [この関数はアプリケーションに属しています。] [管理するにはここをクリックししてください] が表示されたら、[ここをクリック] リンクを選択してください。

  13. serverlessrepo-your_application_name」ページで、serverlessrepo を除いたアプリケーション名を見つけて書き留めてください。例えば、アプリケーション名が serverlessrepo-DynamoDbTestApp の場合、アプリケーション名は DynamoDbTestApp です。

  14. アプリケーションの Lambda コンソールページを開いたままにして、[使用しているコネクタのバージョンを確認] のステップに進んでください。

使用しているコネクタのバージョンを確認する

使用しているコネクタのバージョンを確認するには、次のステップに従います。

使用しているコネクタのバージョンを確認するには
  1. Lambda アプリケーションの Lambda コンソールページで、[デプロイ] タブを選択します。

  2. [デプロイ] タブで、[SAM テンプレート] を展開します。

  3. CodeUri を検索します。

  4. CodeUri 下にある[キー] フィールドで、次の文字列を探します:

    applications-connector_name-versions-year.week_of_year.iteration_of_week/hash_number

    次の例は、CloudWatch コネクタの文字列を示しています:

    applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...
  5. .年内の第 X 週.週内のイテレーション値の値を記録します (例えば、2021.42.1)。これはお使いのコネクタのバージョンです。

新しいバージョンのコネクタをデプロイする

新しいバージョンのコネクタをデプロイするには、次のステップに従います。

新しいバージョンのコネクタをデプロイするには
  1. https://console.aws.amazon.com/athena/ で Athena コンソールを開きます。

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

    展開メニューを選択します。
  3. ナビゲーションペインで、[データソースとカタログ] を選択します。

  4. [データソースとカタログ] ページで [データソースを作成] を選択します。

  5. アップグレードするデータソースを選択し、[次へ] を選択します。

  6. [接続の詳細] セクションで、[Lambda 関数の作成] を選択します。これにより、更新したアプリケーションをデプロイできる Lambda コンソールが開きます。

    AWS Lambda コンソールのコネクタページ。
  7. 実際には新しいデータソースを作成していないため、[Athena コンソール] タブを閉じてかまいません。

  8. コネクタの Lambda コンソールページで、次のステップを実行します:

    1. アプリケーション名から serverlessrepo- プレフィックスを削除したことを確認し、アプリケーション名を [アプリケーション名] フィールドにコピーします。

    2. Lambda 関数名を [Athena カタログ名] フィールドにコピーします。一部のコネクタでは、このフィールドを [Lambda 関数名] と呼んでいます。

    3. 記録した環境変数を対応するフィールドにコピーします。

  9. [このアプリがカスタム IAM ロールとリソースポリシーを作成することを承認します] を選択した後、[デプロイ] を選択します。

  10. アプリケーションが更新されたことを確認するには、[デプロイ] タブを選択します。

    [デプロイ履歴] セクションには、更新が完了したことが表示されます。

    これでコネクタの更新が完了しました。
  11. 新しいバージョン番号を確認するには、以前と同様に [SAM テンプレート] を展開して CodeUri を検索し、コネクタのバージョン番号を [キー] フィールドで確認します。

これで、更新したコネクタを使用して Athena フェデレーティッドクエリを作成できるようになりました。