更新数据来源连接器 - Amazon Athena

更新数据来源连接器

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. 请注意,主页标题中的版本号格式如下:

    Athena Query Federation 版本 v year.week_of_year.iteration_of_week

    例如,Athena Query Federation 版本 v2023.8.3 的版本号为 2023.8.3。

查找并记下资源名称

在准备升级时,必须找到并记下以下信息:

  1. 连接器的 Lambda 函数名称。

  2. Lambda 函数环境变量。

  3. Lambda 应用程序名称,用于管理连接器的 Lambda 函数。

在 Athena 控制台中查找资源名称
  1. https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

  2. 如果控制台导航窗格不可见,请选择左侧的扩展菜单。

    选择扩展菜单。
  3. 在导航窗格中,选择 Data sources(数据来源)。

  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. 记录 year.week_of_year.iteration_of_week 的值(例如,2021.42.1)。这是您的连接器的版本。

部署连接器的新版本

按照以下步骤部署连接器的新版本。

部署连接器的新版本
  1. https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

  2. 如果控制台导航窗格不可见,请选择左侧的扩展菜单。

    选择扩展菜单。
  3. 在导航窗格中,选择 Data sources(数据来源)。

  4. Data sources(数据源)页面上,选择 Create data source(创建数据源)。

  5. 选择要升级的数据来源,然后选择下一步

  6. 连接详细信息部分中,选择创建 Lambda 函数。这将打开 Lambda 控制台,可在其中部署更新后的应用程序。

    AWS Lambda 控制台中的“连接器”页面。
  7. 由于您实际上并不是在新建数据来源,因此可以关闭 Athena 控制台选项卡。

  8. 在连接器的 Lambda 控制台页面中,执行以下步骤:

    1. 确保已从应用程序名称中移除了 serverlessrepo- 前缀,然后将应用程序名称复制到应用程序名称字段。

    2. 将您的 Lambda 函数名称复制到 AthenaCatalogName 字段。在某些连接器中,此字段名为 LambdaFunctionName

    3. 将您记录的环境变量复制到其相应的字段中。

  9. 选择选项我确认此应用程序创建自定义 IAM 角色和资源策略,然后选择部署

  10. 要验证您的应用程序是否已更新,选择部署选项卡。

    部署历史记录部分显示您的更新已完成。

    连接器更新已完成。
  11. 要确认新版本号,您可以像以前一样展开 SAM 模板,找到 CodeUri,然后在字段中检查连接器版本号。

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