

# 更新数据来源连接器
<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. 请注意，主页标题中的版本号格式如下：

   **Athena Query Federation ****版本 v** *year*.*week\$1of\$1year*.*iteration\$1of\$1week*

   例如，**Athena Query Federation 版本 v2023.8.3** 的版本号为 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. 请注意，主页标题中的版本号格式如下：

   **Athena Query Federation ****版本 v** *year*.*week\$1of\$1year*.*iteration\$1of\$1week*

   例如，**Athena Query Federation 版本 v2023.8.3** 的版本号为 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_cn/athena/latest/ug/images/nav-pane-expansion.png)

1. 在导航窗格中，选择**数据来源和目录**。

1. 在**数据来源名称**列中，选择指向连接器数据来源的链接。

1. 在**数据来源详细信息**部分的 **Lambda 函数**下，选择指向您的 Lambda 函数的链接。  
![\[选择指向 Lambda 函数的链接。\]](http://docs.aws.amazon.com/zh_cn/athena/latest/ug/images/connectors-updating-1.png)

1. 在**函数**页面的**函数名称**列中，记下连接器的函数名称。  
![\[记下函数名称。\]](http://docs.aws.amazon.com/zh_cn/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_cn/athena/latest/ug/images/nav-pane-expansion.png)

1. 在导航窗格中，选择**数据来源和目录**。

1. 在**数据来源和目录**页面上，选择**创建数据来源**。

1. 选择要升级的数据来源，然后选择**下一步**。

1. 在**连接详细信息**部分中，选择**创建 Lambda 函数**。这将打开 Lambda 控制台，可在其中部署更新后的应用程序。  
![\[AWS Lambda 控制台中的“连接器”页面。\]](http://docs.aws.amazon.com/zh_cn/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_cn/athena/latest/ug/images/connectors-updating-4.png)

1. 要确认新版本号，您可以像以前一样展开 **SAM 模板**，找到 **CodeUri**，然后在**键**字段中检查连接器版本号。

现在，您可以使用更新后的连接器创建 Athena 联合查询。