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

# 在 Amazon Keyspaces 中标记密钥空间、表和流
<a name="Tagging.Operations"></a>

您可以使用 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)

# 创建新键空间时添加标签
<a name="Tagging.Operations.new.keyspace"></a>

在创建新的密钥空间时，您可以使用 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'
  ```

------

# 向键空间添加标签
<a name="Tagging.Operations.existing.keyspace"></a>

以下示例演示了如何在 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'
  ```

------

# 从键空间中删除标签
<a name="Tagging.Operations.existing.keyspace.drop"></a>

------
#### [ 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'
  ```

------

# 查看键空间的标签
<a name="Tagging.Operations.view.keyspace"></a>

以下示例说明了如何使用控制台、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"
          }
      ]
  }
  ```

------

# 创建新表时添加标签
<a name="Tagging.Operations.new.table"></a>

在创建新表时，您可以使用 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'
  ```

------

# 向表添加标签
<a name="Tagging.Operations.existing.table"></a>

您可以在 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'
  ```

------

# 从表中删除标签
<a name="Tagging.Operations.existing.table.drop"></a>

------
#### [ 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'
  ```

------

# 查看表的标签
<a name="Tagging.Operations.view.table"></a>

以下示例说明如何使用控制台、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"
          }
      ]
  }
  ```

------

# 创建表时向新直播添加标签
<a name="Tagging.Operations.new.table.stream"></a>

使用 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}]'
   ```

------

# 为现有表的新数据流添加标签
<a name="Tagging.Operations.new.stream"></a>

在为现有表创建新直播时，可以添加标签。您可以使用该`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}]'
   ```

------

# 向直播添加新标签
<a name="Tagging.Operations.existing.stream"></a>

您可以使用 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'
  ```

------

# 从直播中删除标签
<a name="Tagging.Operations.existing.stream.drop"></a>

要从直播中删除标签，可以使用 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'
  ```

------

# 查看直播的标签
<a name="Tagging.Operations.view.stream"></a>

以下示例说明如何使用 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"
          }
      ]
  }
  ```

------