Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon Keyspaces 的标签操作

您可以使用 Amazon Keyspaces（适用于 Apache Cassandra）控制台、Amazon CLI 或 Cassandra 查询语言 (CQL) 为密钥空间和表添加、列出、编辑或删除标签。然后，您可以激活这些用户定义的标签，以便在 Amazon Billing and Cost Management 控制台上显示这些标签以进行成本分配跟踪。有关更多信息，请参阅Amazon Keyspaces 成本分配报告：

对于批量编辑，您还可以使用控制台上的标签编辑器。有关更多信息，请参阅 Amazon Resource Groups 用户指南中的使用标签编辑器。

使用控制台将标签添加到新的或现有的键空间和表

您可以使用 Amazon Keyspaces 控制台在创建新键空间和表时在表中添加标签。您还可以添加、编辑或删除现有表的标签。

有关标签结构的信息，请参阅 Amazon Keyspaces 可扩展限制。

使用Amazon CLI 将标签添加到新的或现有的键空间和表

本节中的示例演示了在创建密钥空间和表时如何使用Amazon CLI 指定标签、如何向现有资源添加或删除标签以及如何列出标签。

以下示例演示如何创建带标签的新表。该命令在已经存在的密钥空间 myKeySpace 中创建表 myT able。请注意，为了提高可读性，该命令已分为不同的行。

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'

以下示例演示如何将新标签添加到现有表。

aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable' --tags 'key=key3,value=val3' 'key=key4,value=val4'

下一个示例演示如何列出指定资源的标签。

aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable'

最后一条命令的输出如下所示。

{
    "tags": [
        {
            "key": "key1",
            "value": "val1"
        },
        {
            "key": "key2",
            "value": "val2"
        },
        {
            "key": "key3",
            "value": "val3"
        },
        {
            "key": "key4",
            "value": "val4"
        }
    ]
}

使用 CQL 将标签添加到新的或现有的键空间和表

以下示例演示了在创建键空间和表时如何使用 CQL 指定标签、如何标记现有资源以及如何读取标签。

以下示例创建一个带有标签的新键空间：

CREATE KEYSPACE mykeyspace WITH TAGS = {'key1':'val1', 'key2':'val2'} ;
                

以下示例创建带有标签的新表。

CREATE TABLE mytable(...) WITH TAGS = {'key1':'val1', 'key2':'val2'};
                

在语句中使用其他命令标记资源。

CREATE KEYSPACE mykeyspace WITH REPLICATION = {'class': 'Simple Strategy'} AND TAGS = {'key1':'val1', 'key2':'val2'};
                

以下示例说明如何添加或删除现有键空间和表上的标签。

ALTER KEYSPACE mykeyspace ADD TAGS {'key1':'val1', 'key2':'val2'};

ALTER TABLE mytable DROP TAGS {'key1':'val1', 'key2':'val2'};

要读取附加到资源的标签，请使用以下 CQL 语句。

SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause;

WHERE 子句必需，且必须为以下格式之一：

示例：

以下查询显示键空间是否具有标签。

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:123456789:/keyspace/mykeyspace/      | mykeyspace    | mykeyspace    | keyspace      | {'key1': 'val1', 'key2': 'val2'}
            
        

以下查询显示表的标签。

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:123456789:/keyspace/mykeyspace/table/mytable    | mykeyspace    | mytable       | table         | {'key1': 'val1', 'key2': 'val2'}