亚马逊 Keyspaces 标记操作 - Amazon Keyspaces (for Apache Cassandra)
使用控制台将标签添加到新的或现有的键空间和表。将标签添加到新的或现有的键空间和表使用AmazonCLI使用 CQL 将标签添加到新的或现有的键空间和表。
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

亚马逊 Keyspaces 标记操作

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

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

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

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

在创建键空间表时对键空间进行标记（控制台）

  1. 登录到Amazon Web Services Management Console，然后打开亚马逊 Keyspaces 控制台https://console.aws.amazon.com/keyspaces/home.

  2. 在导航窗格中，选择 Keyspaces (键空间)，然后选择 Create keyspace (创建键空间)。

  3. 在 Create keyspace (创建键空间) 页面上，提供键空间的名称。输入标签的键和值，然后选择 Add new tag (添加新标签)。

  4. 选择 Create keyspace (创建键空间)。

在创建表时对表进行标记（控制台）

  1. 登录到Amazon Web Services Management Console，然后打开亚马逊 Keyspaces 控制台https://console.aws.amazon.com/keyspaces/home.

  2. 在导航窗格中，选择 Tables (表)，然后选择 Create table (创建表)。

  3. 在存储库的创建表中的页面表详细信息部分中，选择键空间并提供表的名称。

  4. 在架构部分中，为表创建架构。

  5. 在表设置部分，选择自定义设置.

  6. 继续浏览表格标签 —可选的部分，然后选择添加新标签来创建新标签。

  7. 选择 Create Table。

标记现有资源（控制台）

  1. 登录到Amazon Web Services Management Console，然后打开亚马逊 Keyspaces 控制台https://console.aws.amazon.com/keyspaces/home.

  2. 在导航窗格中，选择 Keyspaces (键空间) 或 Tables (表)。

  3. 在列表中选择键空间或表。然后选择 Manage tags (管理标签) 以添加、编辑或删除标签。

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

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

此部分中的示例演示如何使用AmazonCLI 将在创建键空间和表时指定标签、如何从现有资源中添加或删除标签以及如何列出标签。

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

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 子句必需，且必须为以下格式之一：

  • keyspace_name = 'mykeyspace' AND resource_type = 'keyspace'

  • keyspace_name = 'mykeyspace' AND resource_name = 'mytable'

  • 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: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'}