# 标记 Athena 资源
标签包含您定义的一个键和一个值。您在标记 Athena 资源时，将为该资源分配自定义元数据。您可以使用标签按照不同方式（例如按用途、所有者或环境）对 Amazon 资源进行分类。在 Athena 中，工作组、数据目录和容量预留等资源是可标记的资源。例如，您可以在账户中为工作组创建一组标签，以帮助您跟踪工作组所有者，或按用途识别工作组。如果您还在 Billing and Cost Management（账单和成本管理）控制台中启用标签作为成本分配标签，则与运行查询相关的费用将显示在“成本和使用情况报告”中，并带有该成本分配标签。我们建议您使用 Amazon [标记最佳实践](https://docs.amazonaws.cn/whitepapers/latest/tagging-best-practices/tagging-best-practices.html) 来创建一组一致的标签，以满足您组织的要求。
您可以通过 Athena 控制台或 API 操作来使用标签。
**Topics**
+ [标签基本知识](#tag-basics)
+ [标签限制](#tag-restrictions)
+ [使用工作组的标签](tags-console.md)
+ [使用 API 和 Amazon CLI 标签操作](tags-operations.md)
+ [使用基于标签的 IAM 访问控制策略](tags-access-control.md)
## 标签基本知识
标签是为 Athena 资源分配的标记。每个标签都包含定义的一个键和一个可选值。
标签可让您按不同方式对 Amazon 资源进行分类。例如，您可以为账户的工作组定义一组标签，以帮助您跟踪每个工作组所有者或用途。
您可以在创建新的 Athena 工作组或数据目录时添加标签，也可以在其中添加、编辑或删除标签。您可以在控制台中编辑标签。要使用 API 操作编辑标签，请删除旧标签并添加新标签。如果删除资源，资源的所有标签也会被删除。
Athena 不会自动向您的资源分配标签。您可以修改标签的密钥和值，还可以随时删除资源的标签。您可以将标签的值设为空的字符串，但是不能将其设为空值。请不要将重复的标签键添加到同一资源中。如果这样操作，Athena 会发布一条错误消息。如果通过 **TagResource** 操作用现有标签键标记资源，则新的标签值将覆盖旧值。
在 IAM 中，您可以控制 Amazon Web Services 账户中的哪些用户有权创建、编辑、删除或列出标签。有关更多信息，请参阅 [使用基于标签的 IAM 访问控制策略](tags-access-control.md)。
有关 Amazon Athena 标记操作的完整列表，请参阅 [Amazon Athena API 参考](https://docs.amazonaws.cn/athena/latest/APIReference/)中的 API 操作名称。
您可以使用标签记账。有关更多信息，请参阅《Amazon 账单与成本管理 用户指南**》中的 [使用账单标签](https://docs.amazonaws.cn/awsaccountbilling/latest/aboutv2/custom-tags.html)。
有关更多信息，请参阅 [标签限制](#tag-restrictions)。
## 标签限制
标签具有以下限制：
+ 在 Athena 中，您可以标记工作组、数据目录和容量预留。但不能标记查询。
+ 每个资源的最大标签数是 50。要不超出限制，请检查并删除未使用的标签。
+ 对于每个资源，每个标签键都必须是唯一的，每个标签键只能有一个值。请不要同时将重复的标签键添加到同一资源中。如果这样操作，Athena 会发布一条错误消息。如果在单独的 `TagResource` 操作中使用现有标签键标记工作组，则新的标签值将覆盖旧值。
+ 标签键长度为 1-128 个 Unicode 字符（UTF-8 格式）。
+ 标签值长度为 0-256 个 Unicode 字符（UTF-8 格式）。
标记操作（如添加、编辑、删除或列出标签），需要您为工作组资源指定一个 ARN。
+ Athena 允许使用 UTF-8 格式的字母、数字和空格，以及以下字符：\+ - = . \_ : / @。
+ 标签键和值区分大小写。
+ 标记键中的 `"aws:"` 前缀将保留以供 Amazon 使用。不能编辑或删除带此前缀的标签键。具有此前缀的标签不计入每个资源的标签数限制。
+ 您分配的标签仅可用于您的 Amazon Web Services 账户。