本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 更新資料來源連接器
<a name="connectors-updating"></a>

Athena 建議您定期將使用的資料來源連接器更新到最新版本，以利用新功能和增強功能。更新資料來源連接器包含下列步驟：

# Glue 連線 (建議)
<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** *year*.*week\$1of\$1year*.*iteration\$1of\$1week* **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 函式中，找到 ImageURI 並將標籤更新為所需的版本。例如：

   從：

   ```
   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`
對於此更新之前的版本，可能不會設定命令覆寫。您必須將其設定為複合處理常式。

# 舊版連線
<a name="connectors-updating-legacy"></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** *year*.*week\$1of\$1year*.*iteration\$1of\$1week* **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/zh_tw/athena/latest/ug/images/nav-pane-expansion.png)

1. 在導覽窗格中，選擇**資料來源和目錄**。

1. 在**資料來源名稱**資料欄中，選擇連接器資料來源的連結。

1. 在 **資料來源詳細資訊**區段的 **Lambda 函數**下，選擇 Lambda 函數的連結。  
![\[選擇 Lambda 函數的連結。\]](http://docs.aws.amazon.com/zh_tw/athena/latest/ug/images/connectors-updating-1.png)

1. 在**函數**頁面的**函數名稱**資料欄中，記下連接器的函數名稱。  
![\[記下函數名稱。\]](http://docs.aws.amazon.com/zh_tw/athena/latest/ug/images/connectors-updating-2.png)

1. 選擇函數名稱連結。

1. 在**函數概觀**區段下，選擇**組態**索引標籤。

1. 在左側的窗格中，選擇**環境變數**。

1. 在**環境變數**區段中，記下索引鍵及其對應值。

1. 捲動至頁面頂端。

1. 在訊息**此函數屬於一個應用程式。中 按一下此處進行管理**，選擇**按一下此處**連結。

1. 在 **serverlessrepo-*your\$1application\$1name*** 頁面上，記下不帶 **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. 記錄 *year*.*week\$1of\$1year*.*iteration\$1of\$1week* 的值 (例如 **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/zh_tw/athena/latest/ug/images/nav-pane-expansion.png)

1. 在導覽窗格中，選擇**資料來源和目錄**。

1. 在**資料來源和目錄**頁面上，選擇**建立資料來源**。

1. 選擇您想要升級的資料來源，然後選擇**下一步**。

1. 在**連線詳細資訊**區段中，選擇**建立 Lambda 函數**。這會開啟 Lambda 主控台，您將能在其中部署更新的應用程式。  
![\[AWS Lambda 主控台中的連接器頁面。\]](http://docs.aws.amazon.com/zh_tw/athena/latest/ug/images/connectors-updating-3.png)

1. 由於您實際上並未建立新的資料來源，因此您可以關閉 Athena 主控台索引標籤。

1. 在連接器的 Lambda 主控台頁面上，執行以下步驟：

   1. 請確定您已從應用程式名稱中移除 **serverlessrepo-** 字首，然後將應用程式名稱複製到**應用程式名稱**欄位。

   1. 將您的 Lambda 函數名稱複製到 **AthenaCatalogName** 欄位。某些連接器將此欄位稱為 **LambdaFunctionName**。

   1. 將您記錄的環境變數複製到其對應欄位中。

1. 選擇選項**我認可此應用程式建立自訂的 IAM 角色和資源政策**，然後選擇**部署**。

1. 若要確認您的應用程式是否已更新，請選擇**部署**索引標籤。

   **部署歷史記錄**區段會顯示您的更新已完成。  
![\[連接器更新已完成。\]](http://docs.aws.amazon.com/zh_tw/athena/latest/ug/images/connectors-updating-4.png)

1. 若要確認新的版本編號，您可以像以前一樣展開 **SAM 範本**，尋找 **CodeUri**，然後在**索引鍵**欄位中檢查連接器版本編號。

您現在可以使用更新的連接器來建立 Athena 聯合查詢。