本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 对 Amazon Keyspaces 资源使用标签和标注 您可以使用*标签*来标记 Amazon Keyspaces（Apache Cassandra 兼容）资源。标签可让您按各种方法对资源进行分类，例如，按用途、所有者、环境或其他标准。标签可帮助您： + 根据您分配到资源的标签来快速识别资源。 + 查看按标签细分的 AWS 账单。 + 根据标签控制对 Amazon Keyspaces 资源的访问。有关使用标签的 IAM 策略示例，请参阅 [基于 Amazon Keyspaces 标签的授权](security_iam_service-with-iam.md#security_iam_service-with-iam-tags)。 亚马逊弹性计算云 (Amazon)、亚马逊简单存储 AWS 服务 (Amazon S3 EC2)、Amazon Keyspaces 等服务支持标记。有效的标签让您可对具有特定标签的服务创建报告，从而提供成本分析。 要开始使用标签，请执行以下操作： 1. 了解 [在 Amazon Keyspaces 中使用标签标注资源的限制](TaggingRestrictions.md)。 1. 使用 [在 Amazon Keyspaces 中标记密钥空间、表和流](Tagging.Operations.md) 创建标签。 1. [使用标签为 Amazon Keyspaces 创建成本分配报告](CostAllocationReports.md)用于跟踪每个有效标签的 AWS 费用。 最后，最佳实践是遵循最佳标签策略。有关信息，请参阅 [AWS 标记策略](https://d0.awsstatic.com/aws-answers/AWS_Tagging_Strategies.pdf)。 # 在 Amazon Keyspaces 中使用标签标注资源的限制 每个标签都由键 和值组成，这两个参数都由您定义。以下限制适用： + 每个 Amazon Keyspaces 密钥空间、表或数据流只能有一个具有相同密钥的标签。如果您尝试添加现有标签（相同键），现有标签值会更新为新值。 + 应用于密钥空间的标签不会自动应用于该密钥空间内的表。要将相同的标签应用于键空间及其所有表，必须为每项资源添加单独的标签。 + 应用于表的标签不会自动应用于该表的流。要在创建表的过程中对表和流应用相同的标签，可以在创建表时使用`PropagateTagsOnEnable`标志。使用此标志，Amazon Keyspaces 在直播创建期间将表的标签应用于流。直播处于活动状态时，对表格标签的更改不适用于该直播。 + 创建多区域键空间或表时，您在创建过程中定义的任何标签都会自动应用于所有区域中的所有键空间和表。当您使用 `ALTER KEYSPACE` 或 `ALTER TABLE` 更改现有标签时，更新仅应用于您进行更改的区域中的键空间或表。 + 值充当标签类别（键）中的描述符。在 Amazon Keyspaces 中，值不能为空或为 null。 + 标签键和值区分大小写。 + 最大键长度为 128 个 Unicode 字符。 + 最大值长度为 256 个 Unicode 字符。 + 允许的字符包括字母、空格和数字，以及以下特殊字符：`+ - = . _ : /` + 每个资源的最大标签数是 50。 + AWS-assigned 的标签名称和值会自动分配`aws:`前缀，但您无法分配前缀。 AWS-分配的标签名称不计入 50 的标签限制。用户分配的标签名称在成本分配报告中具有 `user:` 前缀。 + 您不能回溯标签的应用日期。 # 在 Amazon Keyspaces 中标记密钥空间、表和流 您可以使用 Amazon Keyspaces 控制台、或 Cassandra 查询语言 (CQL) 添加、列出、 AWS CLI编辑或删除密钥空间、表和流的标签。然后，您可以激活这些用户定义的标签，以便它们出现在 AWS 账单与成本管理 控制台上以进行成本分配跟踪。有关更多信息，请参阅 [使用标签为 Amazon Keyspaces 创建成本分配报告](CostAllocationReports.md)。 对于批量编辑，您还可以使用控制台中的标签编辑器。有关更多信息，请参阅 *AWS Resource Groups 用户指南*中的[使用标签编辑器](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html)。 有关标签结构的信息，请参阅 [在 Amazon Keyspaces 中使用标签标注资源的限制](TaggingRestrictions.md)。 **Topics** + [ # 创建新键空间时添加标签 ](Tagging.Operations.new.keyspace.md) + [ # 向键空间添加标签 ](Tagging.Operations.existing.keyspace.md) + [ # 从键空间中删除标签 ](Tagging.Operations.existing.keyspace.drop.md) + [ # 查看键空间的标签 ](Tagging.Operations.view.keyspace.md) + [ # 创建新表时添加标签 ](Tagging.Operations.new.table.md) + [ # 向表添加标签 ](Tagging.Operations.existing.table.md) + [ # 从表中删除标签 ](Tagging.Operations.existing.table.drop.md) + [ # 查看表的标签 ](Tagging.Operations.view.table.md) + [ # 创建表时向新直播添加标签 ](Tagging.Operations.new.table.stream.md) + [ # 为现有表的新数据流添加标签 ](Tagging.Operations.new.stream.md) + [ # 向直播添加新标签 ](Tagging.Operations.existing.stream.md) + [ # 从直播中删除标签 ](Tagging.Operations.existing.stream.drop.md) + [ # 查看直播的标签 ](Tagging.Operations.view.stream.md) # 创建新键空间时添加标签 在创建新的密钥空间时，您可以使用 Amazon Keyspaces 控制台、CQL 或添加标签。 AWS CLI ------ #### [ Console ] **使用控制台创建新键空间时设置标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择 **Keyspaces (键空间)**，然后选择 **Create keyspace (创建键空间)**。 1. 在 **Create keyspace (创建键空间)** 页面上，提供键空间的名称。 1. 在**标签**下选择**添加新标签**，并输入键和值。 1. 选择 **Create keyspace (创建键空间)**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 在创建新键空间时设置标签** + 以下示例创建一个带有标签的新键空间： ``` CREATE KEYSPACE mykeyspace WITH TAGS = {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **使用创建新密钥空间时设置标签 AWS CLI** + 以下语句创建一个带有标签的新键空间。 ``` aws keyspaces create-keyspace --keyspace-name 'myKeyspace' --tags 'key=key1,value=val1' 'key=key2,value=val2' ``` ------ # 向键空间添加标签 以下示例演示了如何在 Amazon Keyspaces 中向键空间添加标签。 ------ #### [ Console ] **使用控制台向现有键空间添加标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择 **Keyspaces (键空间)**。 1. 从列表中选择一个键空间。然后选择**标签**选项卡，您可以在其中查看键空间的标签。 1. 选择**管理标签**即可添加、编辑或删除标签。 1. 选择**保存更改**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 向现有键空间添加标签** + ``` ALTER KEYSPACE mykeyspace ADD TAGS {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **使用向现有密钥空间添加标签 AWS CLI** + 以下示例说明了如何向现有键空间添加新标签。 ``` aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/' --tags 'key=key3,value=val3' 'key=key4,value=val4' ``` ------ # 从键空间中删除标签 ------ #### [ Console ] **使用控制台从现有键空间中删除标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择 **Keyspaces (键空间)**。 1. 从列表中选择一个键空间。然后选择**标签**选项卡，您可以在其中查看键空间的标签。 1. 选择**管理标签**，然后删除不再需要的标签。 1. 选择**保存更改**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 从现有键空间中删除标签** + ``` ALTER KEYSPACE mykeyspace DROP TAGS {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **使用从现有密钥空间中删除标签 AWS CLI** + 以下语句可从键空间中删除指定的标签。 ``` aws keyspaces untag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/' --tags 'key=key3,value=val3' 'key=key4,value=val4' ``` ------ # 查看键空间的标签 以下示例说明了如何使用控制台、CQL 或 AWS CLI读取标签。 ------ #### [ Console ] **使用 Amazon Keyspaces 控制台查看键空间的标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择 **Keyspaces (键空间)**。 1. 从列表中选择一个键空间。然后选择**标签**选项卡，您可以在其中查看键空间的标签。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 查看键空间的标签** 要读取附加到键空间的标签，请使用以下 CQL 语句。 ``` SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause; ``` `WHERE` 子句必需，且必须为以下格式之一： + `keyspace_name = 'mykeyspace' AND resource_type = 'keyspace'` + `resource_id = arn` + 以下语句显示键空间是否具有标签。 ``` SELECT * FROM system_schema_mcs.tags WHERE keyspace_name = 'mykeyspace' AND resource_type = 'keyspace'; ``` 查询的输出如下所示。 ``` resource_id | keyspace_name | resource_name | resource_type | tags -----------------------------------------------------------------+---------------+---------------+---------------+------ arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/ | mykeyspace | mykeyspace | keyspace | {'key1': 'val1', 'key2': 'val2'} ``` ------ #### [ CLI ] **使用查看密钥空间的标签 AWS CLI** + 本示例说明了如何列出指定资源的标签。 ``` aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/' ``` 最后一个命令的输出如下所示。 ``` { "tags": [ { "key": "key1", "value": "val1" }, { "key": "key2", "value": "val2" }, { "key": "key3", "value": "val3" }, { "key": "key4", "value": "val4" } ] } ``` ------ # 创建新表时添加标签 在创建新表时，您可以使用 Amazon Keyspaces 控制台、CQL 或向新表添加标签。 AWS CLI ------ #### [ Console ] **使用（控制台）在创建新表时添加标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择**表**，然后选择**创建表**。 1. 在**创建表**页面的**表详细信息**部分中，选择一个键空间，并为表提供名称。 1. 在**架构**部分，为您的表创建架构。 1. 在**表设置**部分，选择**自定义设置**。 1. 继续前往**表标签 - *可选***部分，然后选择**添加新标签**，以创建新标签。 1. 选择**创建表**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 在创建新表时添加标签** + 以下示例创建带有标签的新表。 ``` CREATE TABLE mytable(...) WITH TAGS = {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **使用创建新表时添加标签 AWS CLI** + 以下示例说明了如何创建带有标签的新表。该命令在已存在的键空间 *myKeyspace* 中创建了表 *myTable*。请注意，为了便于阅读，该命令已分成不同的行。 ``` aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable' --schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]' --tags 'key=key1,value=val1' 'key=key2,value=val2' ``` ------ # 向表添加标签 您可以在 Amazon Keyspaces 中使用控制台、CQL 或 AWS CLI向现有表添加标签。 ------ #### [ Console ] **使用 Amazon Keyspaces 控制台向表添加标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择**表**。 1. 从列表中选择一个表，然后选择**标签**选项卡。 1. 选择**管理标签**以向表添加标签。 1. 选择**保存更改**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 向表添加标签** + 以下语句展示了如何向现有表添加标签。 ``` ALTER TABLE mykeyspace.mytable ADD TAGS {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **使用向表格添加标签 AWS CLI** + 以下示例说明了如何向现有表添加新标签。 ``` aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable' --tags 'key=key3,value=val3' 'key=key4,value=val4' ``` ------ # 从表中删除标签 ------ #### [ Console ] **使用 Amazon Keyspaces 控制台从表中删除标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择**表**。 1. 从列表中选择一个表，然后选择**标签**选项卡。 1. 选择**管理标签**选项卡以从表中删除标签。 1. 选择**保存更改**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 从表中删除标签** + 以下语句展示了如何从现有表中删除标签。 ``` ALTER TABLE mytable DROP TAGS {'key3':'val3', 'key4':'val4'}; ``` ------ #### [ CLI ] **使用向表格添加标签 AWS CLI** + 以下语句可从键空间中删除指定的标签。 ``` aws keyspaces untag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable' --tags 'key=key3,value=val3' 'key=key4,value=val4' ``` ------ # 查看表的标签 以下示例说明如何使用控制台、CQL 或在 Amazon Keyspaces 中查看表的标签。 AWS CLI ------ #### [ Console ] **使用控制台查看表的标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择**表**。 1. 从列表中选择一个表，然后选择**标签**选项卡。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 查看表的标签** 要读取附加到表的标签，请使用以下 CQL 语句。 ``` SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause; ``` `WHERE` 子句必需，且必须为以下格式之一： + `keyspace_name = 'mykeyspace' AND resource_name = 'mytable'` + `resource_id = arn` + 以下查询将返回指定表的标签。 ``` SELECT * FROM system_schema_mcs.tags WHERE keyspace_name = 'mykeyspace' AND resource_name = 'mytable'; ``` 该查询的输出如下所示。 ``` resource_id | keyspace_name | resource_name | resource_type | tags ----------------------------------------------------------------------------+---------------+---------------+---------------+------ arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable| mykeyspace | mytable | table | {'key1': 'val1', 'key2': 'val2'} ``` ------ #### [ CLI ] **使用查看表格的标签 AWS CLI** + 本示例说明了如何列出指定资源的标签。 ``` aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-11T21:21:33.291cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable' ``` 最后一个命令的输出如下所示。 ``` { "tags": [ { "key": "key1", "value": "val1" }, { "key": "key2", "value": "val2" }, { "key": "key3", "value": "val3" }, { "key": "key4", "value": "val4" } ] } ``` ------ # 创建表时向新直播添加标签 使用 CQL 或标记流来创建包含流的新表时，可以 AWS CLI 为流添加标签。 **注意** Amazon Keyspaces CDC 要求存在服务相关角色 (`AWSServiceRoleForAmazonKeyspacesCDC`)，该角色代表您将来自亚马逊密钥空间 CDC 流的指标数据发布到您的`"cloudwatch:namespace": "AWS/Cassandra"` CloudWatch 账户中。将自动为您创建此角色。有关更多信息，请参阅 [在 Amazon Keyspaces CDC 直播中使用角色](using-service-linked-roles-CDC-streams.md)。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 创建新表时向流添加标签** 1. 要使用流创建新表并将表标签自动应用于流，可以使用标`'propagate_tags': 'TABLE'`志。下面是一个示例语句。 ``` CREATE TABLE mytable (pk int, ck text, PRIMARY KEY(pk)) WITH TAGS={'key1':'val1', 'key2':'val2'} AND cdc = TRUE AND CUSTOM_PROPERTIES={ 'cdc_specification': { 'view_type': 'NEW_IMAGE', 'propagate_tags': 'TABLE' } }; ``` 1. 要对直播应用新标签，你可以使用以下示例。 ``` CREATE TABLE mytable (pk int, ck text, PRIMARY KEY(pk)) WITH TAGS={'key1':'val1', 'key2':'val2'} AND cdc = TRUE AND CUSTOM_PROPERTIES={ 'cdc_specification': { 'view_type': 'NEW_IMAGE', 'tags': { 'key': 'string', 'value': 'string' }, } }; ``` ------ #### [ CLI ] **使用创建新表时向直播添加标签 AWS CLI** 1. 要创建带有流的表并将表标签自动应用于流，可以使用标`propagateTags=Table`志。下面是一个代码示例。 ``` aws keyspaces create-table \ --keyspace-name 'my_keyspace' \ --table-name 'my_table' \ --schema-definition 'allColumns=[{name=pk,type=int},{name=ck,type=text}],clusteringKeys=[{name=ck,orderBy=ASC}],partitionKeys=[{name=pk}]' \ --tags key=tag_key,value=tag_value --cdc-specification propagateTags=TABLE,status=ENABLED,viewType=NEW_IMAGE ``` 1. 要对直播应用不同的标签，你可以使用以下示例。 ``` aws keyspaces create-table \ --keyspace-name 'my_keyspace' \ --table-name 'my_table' \ --schema-definition 'allColumns=[{name=pk,type=int},{name=ck,type=text}],clusteringKeys=[{name=ck,orderBy=ASC}],partitionKeys=[{name=pk}]' \ --tags key=tag_key,value=tag_value --cdc-specification 'status=ENABLED,viewType=NEW_IMAGE,tags=[{key=tag_key, value=tag_value}]' ``` ------ # 为现有表的新数据流添加标签 在为现有表创建新直播时，可以添加标签。您可以使用该`PropagateTags`标志将表标签应用于流，也可以为直播指定新标签。您可以使用 CQL 或 AWS CLI 来标记新流。 **注意** Amazon Keyspaces CDC 要求存在服务相关角色 (`AWSServiceRoleForAmazonKeyspacesCDC`)，该角色代表您将来自亚马逊密钥空间 CDC 流的指标数据发布到您的`"cloudwatch:namespace": "AWS/Cassandra"` CloudWatch 账户中。将自动为您创建此角色。有关更多信息，请参阅 [在 Amazon Keyspaces CDC 直播中使用角色](using-service-linked-roles-CDC-streams.md)。 ------ #### [ Console ] **使用（控制台）创建新直播时添加标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择 T **ables**，然后选择要为其添加直播的表。 1. 选择 “**直播**” 选项卡。 1. 在**直播详情**部分中，选择**编辑**。 1. 选择 “**开启直播**”。 1. 选择**视图类型**并继续前往**标签**为直播创建标签。 1. 您可以选择下列选项之一： + **无标签** — 如果您不想为直播创建任何标签，请使用此选项。 + **从表中复制标签**-如果要将标签从表复制到流，请使用此选项。复制标签后，您可以为直播编辑标签。请注意，只有当表格有标签时，此选项才可用。 + **添加新标签**-通过选择 “添加**新标签”，您最多可以为直播添加 50 个标签**。 1. 选择**保存更改**。 ------ #### [ Cassandra Query Language (CQL) ] **在创建新直播时添加标签** 1. 要为现有表创建新流并将表的标签应用于流，可以使用标`'propagate_tags': 'TABLE'`志。以下语句就是一个例子。 ``` ALTER TABLE mytable WITH cdc = TRUE AND CUSTOM_PROPERTIES={ 'cdc_specification': { 'view_type': 'NEW_IMAGE', 'propagate_tags': 'TABLE' } }; ``` 1. 要为现有表创建新流并指定新标签，可以使用以下示例。 ``` ALTER TABLE mytable WITH cdc = TRUE AND CUSTOM_PROPERTIES={ 'cdc_specification': { 'view_type': 'NEW_IMAGE', 'tags': { 'key': 'string', 'value': 'string' }} }; ``` ------ #### [ CLI ] **使用创建新直播时添加标签 AWS CLI** 1. 要创建带有标签的新流，您可以使用该`propagateTags=TABLE`标志将表的标签自动应用于该流。下面是一个代码示例。 ``` aws keyspaces update-table \ --keyspace-name 'my_keyspace' \ --table-name 'my_table' \ --cdc-specification propagateTags=TABLE,status=ENABLED,viewType=NEW_IMAGE ``` 1. 要为现有表创建新流并指定新标签，可以使用以下示例。 ``` aws keyspaces update-table \ --keyspace-name 'my_keyspace' \ --table-name 'my_table' \ --cdc-specification 'status=ENABLED,viewType=NEW_IMAGE,tags=[{key=tag_key, value=tag_value}]' ``` ------ # 向直播添加新标签 您可以使用 CQL 或，向 Amazon Keyspaces 中的现有数据流添加新标签。 AWS CLI您只能为最新直播添加标签。 ------ #### [ Console ] **向现有直播添加标签（控制台）** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择 T **ables**，然后选择包含要标记的直播的表。 1. 选择 “**直播**” 选项卡。 1. 在**标签**部分中，选择**管理标签**。 1. 选择 “**添加新标签**” 以添加新标签。重复此步骤，您最多可以创建 50 个标签。 1. 选择**保存更改**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 为直播添加标签** + 以下语句显示如何向现有直播添加标签。 ``` ALTER TABLE mykeyspace.mytable ADD TAGS_FOR_CDC {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **使用向直播添加标签 AWS CLI** + 以下示例说明如何向现有直播添加新标签。 ``` aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-11T21:21:33.291' --tags 'key=key3,value=val3' 'key=key4,value=val4' ``` ------ # 从直播中删除标签 要从直播中删除标签，可以使用 CQL 或。 AWS CLI您只能删除最新直播的标签。 ------ #### [ Console ] **使用 Amazon Keyspaces 控制台从表中删除标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择**表**。 1. 从列表中选择一个表，然后选择 “**流**” 选项卡。 1. 在 “**标签**” 部分中，选择 “**管理标签**”，从表格中删除标签。 1. 在要删除的标签之后，选择**移除**。 1. 选择**保存更改**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 从直播中删除标签** + 以下语句显示如何从现有流中删除标签。 ``` ALTER TABLE mytable DROP TAGS_FOR_CDC {'key3':'val3', 'key4':'val4'}; ``` ------ #### [ CLI ] **使用从直播中删除标签 AWS CLI** + 以下语句从流中删除指定的标签。 ``` aws keyspaces untag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-11T21:21:33.291' --tags 'key=key3,value=val3' 'key=key4,value=val4' ``` ------ # 查看直播的标签 以下示例说明如何使用 CQL 或 Amazon Keyspaces 中查看直播的标签。 AWS CLI ------ #### [ Console ] **使用控制台查看直播的标签** 1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home) 1. 在导航窗格中，选择**表**。 1. 从列表中选择一个表，然后选择 “**流**” 选项卡。 1. 您可以在 “标签” 部分查看直播的**标签**。 ------ #### [ Cassandra Query Language (CQL) ] **使用 CQL 查看直播的标签** 要读取附加到流的标签，您必须在子句中指定该流的资源 ARN。`WHERE`以下 CQL 语法就是一个示例。 ``` SELECT * FROM system_schema_mcs.tags WHERE resource_id = stream_arn; ``` + 以下查询返回指定直播的标签。 ``` SELECT tags FROM system_schema_mcs.tags WHERE resource_id = 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-06T17:17:39.800'; ``` 该查询的输出如下所示。 ``` resource_id | keyspace_name | resource_name | resource_type | tags ------------------------------------------------------------------------------------------------------------------+---------------+-------------------------+---------------+---------------------- arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-04-02T23:00:07.052 | singleks | 2025-04-02T23:00:07.052 | stream | {'tagkey': 'tagval'} ``` ------ #### [ CLI ] **使用查看直播的标签 AWS CLI** + 此示例说明如何列出指定密钥空间下所有直播的标签。 ``` aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/table/my_table/stream/2025-05-11T21:21:33.291' ``` 最后一个命令的输出如下所示。 ``` { "tags": [ { "key": "key1", "value": "val1" }, { "key": "key2", "value": "val2" }, { "key": "key3", "value": "val3" }, { "key": "key4", "value": "val4" } ] } ``` ------ # 使用标签为 Amazon Keyspaces 创建成本分配报告 AWS 使用标签在成本分配报告中整理资源成本。 AWS 提供两种类型的成本分配标签： + AWS生成的标签。 AWS 为您定义、创建和应用此标签。 + 用户定义的标签。您定义、创建和应用这些标签。 您必须先分别激活两种类型的标签，然后这些标签才能显示在 Cost Explorer 中或成本分配报告上。 要激活 AWS生成的标签，请执行以下操作： 1. 登录 AWS 管理控制台 并在家中打开 Billing and Cost Management 控制台 [https://console.aws.amazon.com/billing/\$1/](https://console.aws.amazon.com/billing/home#/)。 1. 在导航窗格中，选择 **Cost Allocation Tags (成本分配标签)**。 1. 在 **AWS生成的成本分配标签**下，选择**激活**。 激活用户定义的标签： 1. 登录 AWS 管理控制台 并在家中打开 Billing and Cost Management 控制台 [https://console.aws.amazon.com/billing/\$1/](https://console.aws.amazon.com/billing/home#/)。 1. 在导航窗格中，选择 **Cost Allocation Tags (成本分配标签)**。 1. 在 **User-Defined Cost Allocation Tags (用户生成的成本分配标签)** 下，选择 **Activate (激活)**。 创建并激活标签后， AWS 生成一份成本分配报告，其中包含按有效标签分组的使用量和成本。成本分配报告包括您在每个账单周期的所有 AWS 费用。该报告包括标记资源和未标记资源，因此您可以清晰地排列资源费用。 **注意** 目前，从 Amazon Keyspaces 传出的所有数据不会在成本分配报告上按标签细分。 有关更多信息，请参阅[使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。