更改 Athena 引擎版本 - Amazon Athena
查找工作组的查询引擎版本在 Athena 控制台中更改引擎版本通过 Amazon CLI 更改引擎版本创建工作组时指定引擎版本在引擎版本升级之前测试查询为运行失败的查询排查问题
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

更改 Athena 引擎版本

Athena 偶尔会发布新的引擎版本，以提供更好的性能、功能并修复代码。当新的引擎版本可用时，Athena 会在控制台中通知您。您可以选择让 Athena 决定何时升级，也可以手动指定每个工作组的 Athena 引擎版本。

查找工作组的查询引擎版本

您可以使用 Workgroups（工作组）页面查找任何工作组的当前引擎版本。

要查找任何工作组的当前引擎版本

  1. 从 https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

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

    选择扩展菜单。

  3. 在 Athena 控制台导航窗格中，选择 Workgroups（工作组）。

  4. 在 Workgroups（工作组）页面上，找到所需的工作组。该工作组的 Query engine version（查询引擎版本）列显示查询引擎版本。

在 Athena 控制台中更改引擎版本

当新引擎版本可用时，您便可以选择让 Athena 决定何时升级工作组，或手动指定工作组使用的 Athena 引擎版本。如果当前只有一个版本可用，则无法手动指定其他版本。

注意

要更改工作组的引擎版本，您必须有权限对工作组执行 athena:ListEngineVersions 操作。有关 IAM policy 示例，请参阅 工作组策略示例。

要让 Athena 决定何时升级工作组

  1. 从 https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

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

  3. 在控制台导航窗格中，选择 Workgroups（工作组）。

  4. 在工作组列表中，选择要配置的工作组链接。

  5. 选择编辑。

  6. 在 Query engine version（查询引擎版本）部分中，对于 Update query engine（更新查询引擎），选择 Automatic（自动），让 Athena 选择何时升级您的工作组。这是默认设置。

  7. 选择 Save changes（保存更改）。

    在工作组列表中，工作组的 Query engine update status（查询引擎更新状态）显示 Automatic（自动）。

要手动选择引擎版本

  1. 从 https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

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

  3. 在控制台导航窗格中，选择 Workgroups（工作组）。

  4. 在工作组列表中，选择要配置的工作组链接。

  5. 选择编辑。

  6. 在 Query engine version（查询引擎版本）部分中，对于 Update query engine（更新查询引擎），选择 Manual（手动）以手动选择引擎版本。

  7. 使用 Query engine version（查询引擎版本）选项，选择希望工作组使用的引擎版本。如果没有其他引擎版本可用，则无法指定其他引擎版本。

  8. 选择 Save changes（保存更改）。

    在工作组列表中，工作组的 Query engine update status（查询引擎更新状态）显示 Manual（手动）。

通过 Amazon CLI 更改引擎版本

要通过 Amazon CLI 更改引擎版本，请使用以下示例中的语法。

aws athena update-work-group --work-group workgroup-name --configuration-updates EngineVersion={SelectedEngineVersion='Athena engine version 3'}

创建工作组时指定引擎版本

创建工作组时，可以指定工作组使用的引擎版本，或者让 Athena 决定何时升级工作组。如果有新的引擎版本可用，最佳实践是在升级其他工作组之前创建一个工作组以测试新引擎。要指定工作组的引擎版本，您必须具有工作组的 athena:ListEngineVersions 权限。有关 IAM policy 示例，请参阅 工作组策略示例。

要在创建工作组时指定引擎版本

  1. 从 https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

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

  3. 在控制台导航窗格中，选择 Workgroups（工作组）。

  4. 在 Workgroups（工作组）页面中，选择 Create workgroup（创建工作组）。

  5. 在 Create workgroup（创建工作组）页面上的 Query engine version（查询引擎版本）部分中，请执行以下操作之一：

    • 选择 Automatic（自动），让 Athena 选择何时升级您的工作组。这是默认设置。

    • 选择 Manual（手动）以手动选择其他引擎版本（如果可用）。

  6. 根据需要输入其他字段的信息。有关其他字段的信息，请参阅 创建工作组。

  7. 选择 Create workgroup (创建工作组)。

在引擎版本升级之前测试查询

当工作组升级到新的引擎版本时，您的某些查询可能会因不兼容而中断。为了确保引擎版本升级顺利进行，您可以提前测试查询。

要在引擎版本升级之前测试查询

  1. 验证您使用的工作组的引擎版本。您正在使用的引擎版本会显示在 Workgroups（工作组）页面上工作组的 Query engine version（查询引擎版本）列中。有关更多信息，请参阅 查找工作组的查询引擎版本。

  2. 创建使用新引擎版本的测试工作组。有关更多信息，请参阅 创建工作组时指定引擎版本。

  3. 使用新工作组运行要测试的查询。

  4. 如果查询未能正常运行，请使用 Athena 引擎版本参考 来检查可能会影响查询的中断更改。某些更改可能需要您更新查询的语法。

  5. 如果您的查询仍然失败，请联系 Amazon Web Services Support 以获取帮助。在 Amazon Web Services Management Console 中，选择 Support（支持）、Support Center（支持中心），或使用 Amazon Athena 标签在 Amazon re:Post 上提问。

为运行失败的查询排查问题

如果查询在引擎版本升级后运行失败，请使用 Athena 引擎版本参考 来检查中断更改，包括可能影响查询中语法的更改。

如果您的查询仍然失败，请联系 Amazon Web Services Support 以获取帮助。在 Amazon Web Services Management Console 中，选择 Support（支持）、Support Center（支持中心），或使用 Amazon Athena 标签在 Amazon re:Post 上提问。