

# データソースコネクタを更新する
<a name="connectors-updating"></a>

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

## Lambda を使用した AWS Glue Data Catalog フェデレーションコネクタ
<a name="connectors-updating-gc"></a>

### 最新バージョンの Athena Query Federation を確認する
<a name="connectors-updating-finding-the-latest-version"></a>

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](https://github.com/awslabs/aws-athena-query-federation/releases/latest)) を確認してください。

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

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

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

### コネクタバージョンの検索
<a name="connectors-find-version"></a>

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

**コネクタバージョンを検索するには**

1. Lambda アプリケーションの Lambda コンソールページで、**[イメージ]** タブを選択します。

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

   ```
   {{Image_location_account}}.dkr.ecr.us-west-2.amazonaws.com/athena-federation-repository:{{Version}}
   ```

1. イメージ URI のバージョン番号は、形式 `year.week_of_year.iteration_of_week` (例: `2021.42.1`) に従います。この数値はコネクタバージョンを表しています。

### 新しいコネクタバージョンのデプロイ
<a name="connectors-deploy-new-version"></a>

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

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

1. 最新バージョンの Athena Query Federation を確認する手順に従って、必要なバージョンを検索します。

1. フェデレーティッドコネクタの 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 データカタログフェデレーションコネクタ
<a name="connectors-updating-legacy"></a>

### 最新バージョンの Athena Query Federation を確認する
<a name="connectors-updating-finding-the-latest-version-legacy"></a>

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](https://github.com/awslabs/aws-athena-query-federation/releases/latest)) を確認してください。

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

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

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

### リソース名を検索して書き留める
<a name="connectors-updating-finding-and-noting-resource-names"></a>

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

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

1. Lambda 関数の環境変数。

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

**Athena コンソールからリソース名を検索するには**

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

1. コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。  
![展開メニューを選択します。](http://docs.aws.amazon.com/ja_jp/athena/latest/ug/images/nav-pane-expansion.png)

1. ナビゲーションペインで、**[データソースとカタログ]** を選択します。

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

1. **[データソースの詳細]** セクションの **[Lambda 関数]** で、Lambda 関数へのリンクを選択します。  
![Lambda 関数へのリンクを選択します。](http://docs.aws.amazon.com/ja_jp/athena/latest/ug/images/connectors-updating-1.png)

1. **[関数]** ページの **[関数名]** 列で、コネクタの関数名を見つけて書き留めます。  
![関数名を書き留めます。](http://docs.aws.amazon.com/ja_jp/athena/latest/ug/images/connectors-updating-2.png)

1. 関数名のリンクを選択します。

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

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

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

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

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

1. 「**serverlessrepo-{{your\_application\_name}}**」ページで、**serverlessrepo** を除いたアプリケーション名を見つけて書き留めてください。例えば、アプリケーション名が **serverlessrepo-DynamoDbTestApp** の場合、アプリケーション名は **DynamoDbTestApp** です。

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

### 使用しているコネクタのバージョンを確認する
<a name="connectors-updating-finding-the-version-that-you-are-using"></a>

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

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

1. Lambda アプリケーションの Lambda コンソールページで、**[デプロイ]** タブを選択します。

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

1. **CodeUri** を検索します。

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

   ```
   applications-{{connector_name}}-versions-{{year}}.{{week_of_year}}.{{iteration_of_week}}/{{hash_number}}
   ```

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

   ```
   applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...
   ```

1. {{年}}.{{年内の第 X 週}}.{{週内のイテレーション値}}の値を記録します (例えば、**2021.42.1**)。これはお使いのコネクタのバージョンです。

### 新しいバージョンのコネクタをデプロイする
<a name="connectors-updating-deploying-the-new-version"></a>

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

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

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

1. コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。  
![展開メニューを選択します。](http://docs.aws.amazon.com/ja_jp/athena/latest/ug/images/nav-pane-expansion.png)

1. ナビゲーションペインで、**[データソースとカタログ]** を選択します。

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

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

1. **[接続の詳細]** セクションで、**[Lambda 関数の作成]** を選択します。これにより、更新したアプリケーションをデプロイできる Lambda コンソールが開きます。  
![AWS Lambda コンソールのコネクタページ。](http://docs.aws.amazon.com/ja_jp/athena/latest/ug/images/connectors-updating-3.png)

1. 実際には新しいデータソースを作成していないため、[Athena コンソール] タブを閉じてかまいません。

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

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

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

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

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

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

   **[デプロイ履歴]** セクションには、更新が完了したことが表示されます。  
![これでコネクタの更新が完了しました。](http://docs.aws.amazon.com/ja_jp/athena/latest/ug/images/connectors-updating-4.png)

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

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