工作组故障排除 - Amazon Athena
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

如果我们为英文版本指南提供翻译,那么如果存在任何冲突,将以英文版本指南为准。在提供翻译时使用机器翻译。

工作组故障排除

按照以下提示进行工作组故障排除。

  • 检查您账户中各个用户的权限。他们必须可访问查询结果的位置,以及要从中运行查询的工作组。如果他们要切换工作组,那么同时需要两个工作组的权限。有关信息,请参阅用于访问工作组的 IAM 策略

  • 请注意 Athena 控制台中的上下文,以查看您要在哪一工作组中运行查询。如果您使用驱动程序,请确保设置为您需要的工作组。有关信息,请参阅指定从中运行查询的工作组

  • 如果使用API或驱动程序运行查询,则必须使用以下方式之一指定查询结果位置:对于个别查询,请使用 输出位置 (客户端)。在工作组中,使用 工作组配置. 如果没有以任何方式指定地点, Athena 在查询运行时发出错误。

  • 如果您使用工作组设置覆盖客户端设置,您可能会遇到有关查询结果位置的错误。例如,工作组用户可能没有相应权限,不能在 Amazon S3 中的工作组位置存储查询结果。在这种情况下,添加必需的权限。

  • 工作组会导致 API 操作的行为发生变化。要调用以下现有的 API 操作,要求您账户中的用户在 IAM 中对从中进行调用的工作组具有基于资源的权限。如果不存在对工作组和工作组操作的权限,以下API操作将丢弃 AccessDeniedException: 创建查询删除质询GetNamedQuery列表查询StartQueryExecutionStopqueryExecutionListquery执行GetQueryExecutionGetQueryResults,和 GetQueryResultsStream (此API操作只能与驱动程序一起使用,而且不会被公开使用)。有关详细信息,请参阅 AmazonAthena的行动、资源和条件钥匙IAM 用户指南.

    呼叫 BatchGetQueryExecutionBatchgetNamEdQuery API操作仅返回在用户拥有访问权限的工作组中运行的查询的信息。如果用户不可访问工作组,这些 API 操作会在未处理 ID 的列表中返回未授权的查询 ID。有关更多信息,请参阅 Athena 工作组 API。)

  • 如果将在其中运行查询的工作组使用强制查询结果位置配置,请不要为 CTAS 查询指定 external_location。在此例中,Athena 发出错误并使指定 external_location 的查询失败。例如,如果您覆盖查询结果位置的客户端设置,强制工作组使用其自己的位置,此查询失败:CREATE TABLE <DB>.<TABLE1> WITH (format='Parquet', external_location='s3://my_test/test/') AS SELECT * FROM <DB>.<TABLE2> LIMIT 10;

您可能会看到以下错误。下表给出与工作组相关的部分错误以及建议的解决方案的列表。

工作组错误
错误 出错情况...
query state CANCELED. Bytes scanned limit was exceeded. 查询超过查询数据限制并已取消。请考虑重写查询以使其读取更少的数据,或联系您的账户管理员。
User: arn:aws:iam::123456789012:user/abc is not authorized to perform: athena:StartQueryExecution on resource: arn:aws:athena:us-east-1:123456789012:workgroup/workgroupname 用户在一个工作组中运行查询,但不可访问该工作组。更新您的策略以便可访问该工作组。
INVALID_INPUT. WorkGroup <name> is disabled. 用户在一个工作组中运行查询,但该工作组已被禁用。您的工作组可由您的管理员禁用。也有可能是您不可访问它。在这两种情况下,与有权访问以修改工作组的管理员联系。
INVALID_INPUT. WorkGroup <name> is not found. 用户在一个工作组中运行查询,但该工作组不存在。如果工作组已被删除,就会发生这种情况。切换到另一工作组以运行查询。
InvalidRequestException: when calling the StartQueryExecution operation: No output location provided. An output location is required either through the Workgroup result configuration setting or as an API input.

用户使用 API 运行查询,但未指定查询结果的位置。您必须使用以下两种方法之一为查询结果设置输出位置:对于单独查询,使用 OutputLocation(客户端);对于工作组,使用 WorkGroupConfiguration

The Create Table As Select query failed because it was submitted with an 'external_location' property to an Athena Workgroup that enforces a centralized output location for all queries. Please remove the 'external_location' property and resubmit the query.

如果从中运行查询的工作组已使用强制实施的查询结果位置配置,而且您为 CTAS 查询指定 external_location。在这种情况下,请删除 external_location 并重新运行查询。