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

标记工作组

标签包含您定义的一个键和一个值。您在标记工作组时,将为其分配自定义元数据。您可以使用标签按照不同方式(例如用途、所有者或环境)对 AWS 资源进行分类。对于 Athena,工作组是您可以进行标记的资源。例如,您可以在账户中为工作组创建一组标签,以帮助您跟踪工作组所有者,或按用途识别工作组。我们建议您使用 AWS 标记最佳实践来创建一组一致的标签,以满足您组织的要求。

您可以通过 Athena 控制台或 API 操作来使用标签。

有关标签的基本知识

标签是为 Athena 资源分配的标记。每个标签都包含您定义的一个键和一个可选值。

标签可让您按不同方式对 AWS 资源进行分类。例如,您可以为账户的工作组定义一组标签,以帮助您跟踪每个工作组所有者或用途。

您可以在创建新的 Athena 工作组时添加标签,也可以从现有工作组添加、编辑或删除标签。您可以在控制台中编辑标签。如果您使用 API 操作,要编辑标签,请删除旧标签并添加新标签。如果删除工作组,则该工作组的任何标签也会被删除。账户中的其他工作组可继续使用相同标签。

Athena 不会将标签自动分配给您的资源,如工作组。您可以编辑标签的键和值,还可以随时删除工作组的标签。您可以将标签的值设为空的字符串,但是不能将其设为空值。请勿同时将重复的标签键添加到同一个工作组。如果这样操作,Athena 会发布一条错误消息。如果在单独的 TagResource 操作中使用现有标签键标记工作组,则新的标签值将覆盖旧值。

在 IAM 中,您可以控制 AWS 账户中的哪些用户有权创建、编辑、删除或列出标签。有关更多信息,请参阅标签策略示例

有关 Amazon Athena 标签操作的完整列表,请参阅 Amazon Athena API 参考中的 API 操作名称。

您可以使用相同的标签记账。有关更多信息,请参阅 AWS Billing and Cost Management 用户指南 中的使用标签记账

有关更多信息,请参阅 标签限制

标签限制

标签具有以下限制:

  • 在 Athena 中,您可以标记工作组。但不能标记查询。

  • 每个工作组的最大标签数是 50。要不超出限制,请检查并删除未使用的标签。

  • 对于每个工作组,每个标签键都必须是唯一的,每个标签键只能有一个值。请勿同时将重复的标签键添加到同一个工作组。如果这样操作,Athena 会发布一条错误消息。如果在单独的 TagResource 操作中使用现有标签键标记工作组,则新的标签值将覆盖旧值。

  • 标签键长度为 1-128 个 Unicode 字符(UTF-8 格式)。

  • 标签值长度为 0-256 个 Unicode 字符(UTF-8 格式)。

    标记操作(如添加、编辑、删除或列出标签),需要您为工作组资源指定一个 ARN。

  • Athena 允许使用 UTF-8 格式的字母、数字和空格,以及以下字符:+ - = . _ : / @。

  • 标签键和值区分大小写。

  • 请勿在标签键中使用 "aws:" 前缀,它将保留以供 AWS 使用。不能编辑或删除带此前缀的标签键。具有此前缀的标签不计入每个资源的标签数限制。

  • 您分配的标签仅可用于您的 AWS 账户。