本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon Keyspaces 資源的標籤和標籤
<a name="tagging-keyspaces"></a>

 您可以使用標籤*來標記* Amazon Keyspaces （適用於 Apache Cassandra) 資源。標籤可讓您以不同的方式分類資源，例如，依用途、擁有者、環境或其他條件。標籤可協助您執行以下作業：
+  根據您指派給資源的標籤來快速識別資源。
+  請參閱依標籤細分的 AWS 帳單。
+ 根據標籤控制對 Amazon Keyspaces 資源的存取。如需使用標籤的 IAM 政策範例，請參閱 [以 Amazon Keyspaces 標籤為基礎的授權](security_iam_service-with-iam.md#security_iam_service-with-iam-tags)。

 Amazon Elastic Compute Cloud (Amazon EC2)、Amazon Simple Storage Service (Amazon S3)、Amazon Keyspaces 等 AWS 服務支援標記。有效標記可讓您跨帶有特定標籤的服務來建立報告，以提供成本深入資訊。

 若要開始使用標記，請執行以下操作：

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 中標記資源的限制
<a name="TaggingRestrictions"></a>

 每個標記皆包含由您定義的索引鍵和值。將適用以下限制：
+  每個 Amazon Keyspaces 金鑰空間、資料表或串流只能有一個具有相同金鑰的標籤。若您嘗試新增現有的標籤 (相同索引鍵)，現有標籤的值會更新為新的值。
+ 套用至金鑰空間的標籤不會自動套用至該金鑰空間內的資料表。若要將相同的標籤套用至金鑰空間及其所有資料表，每個資源都必須個別加上標籤。
+ 套用至資料表的標籤不會自動套用至該資料表的串流。若要在建立資料表期間將相同的標籤套用至資料表和串流，您可以在建立資料表時使用 `PropagateTagsOnEnable`旗標。使用此旗標，Amazon Keyspaces 會在串流建立期間將資料表的標籤套用至串流。當串流處於作用中狀態時，資料表標籤的變更不會套用至串流。
+ 當您建立多區域金鑰空間或資料表時，您在建立程序期間定義的任何標籤都會自動套用至所有區域中的所有金鑰空間和資料表。當您使用 `ALTER KEYSPACE`或 變更現有標籤時`ALTER TABLE`，更新只會套用至您進行變更之區域中的 金鑰空間或資料表。
+ 值就像標籤類別 (索引鍵) 內的描述項。在 Amazon Keyspaces 中，值不能為空或 null。
+  標籤鍵與值皆區分大小寫。
+  鍵長度上限為 128 個 Unicode 字元。
+ 值長度上限為 256 個 Unicode 字元。
+  允許的字元為字母、空格和數字，以及下列特殊字元：`+ - = . _ : /`
+  每一資源標籤數最多為 50。
+ AWS指派的標籤名稱和值會自動指派前`aws:`綴，您無法指派。 AWS指派的標籤名稱不會計入 50 的標籤限制。使用者指派的標籤名稱在成本分配報告中具有字首 `user:`。
+  標籤的套用不可回溯。

# 在 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>

您可以在建立新的金鑰空間時 AWS CLI ，使用 Amazon Keyspaces 主控台、CQL 或 新增標籤。

------
#### [ Console ]

**使用主控台建立新金鑰空間時設定標籤**

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇**金鑰空間**，然後選擇**建立金鑰空間**。

1. 在**建立金鑰空間**頁面上，提供金鑰空間的名稱。

1. 在**標籤**下選擇**新增標籤**，然後輸入索引鍵和值。

1. 選擇**建立金鑰空間**。

------
#### [ 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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **金鑰空間**。

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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **金鑰空間**。

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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **金鑰空間**。

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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **Tables** (資料表)，然後選擇 **Create table** (建立資料表)。

1. 在**資料表詳細資訊區段的建立**資料表頁面上，選取金鑰空間，並提供資料表的名稱。 ****

1. 在**結構描述**區段中，建立資料表的結構描述。

1. 在**資料表設定**區段中，選擇**自訂設定**。

1. 繼續前往**資料表標籤 – *選用***區段，然後選擇**新增標籤**以建立新標籤。

1. 選擇**建立資料表**。

------
#### [ Cassandra Query Language (CQL) ]

**使用 CQL 建立新資料表時新增標籤**
+ 下列範例會使用標籤建立新的資料表。

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

------
#### [ CLI ]

**使用 建立新資料表時新增標籤 AWS CLI**
+ 下列範例示範如何建立具有標籤的新資料表。命令會在現有的金鑰空間 myKeyspace 中建立資料表 *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'
  ```

------

# 將標籤新增至資料表
<a name="Tagging.Operations.existing.table"></a>

您可以使用主控台、CQL 或 將標籤新增至 Amazon Keyspaces 中的現有資料表 AWS CLI。

------
#### [ Console ]

**使用 Amazon Keyspaces 主控台將標籤新增至資料表**

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **Tables** (資料表)。

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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **Tables** (資料表)。

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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **Tables** (資料表)。

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`)，以代表您將指標資料從 Amazon Keyspaces CDC 串流發佈到 CloudWatch 帳戶中`"cloudwatch:namespace": "AWS/Cassandra"`的 。系統會自動建立此角色。如需詳細資訊，請參閱[使用 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`)，以代表您將指標資料從 Amazon Keyspaces CDC 串流發佈到 CloudWatch 帳戶中`"cloudwatch:namespace": "AWS/Cassandra"`的 。系統會自動建立此角色。如需詳細資訊，請參閱[使用 Amazon Keyspaces CDC 串流的角色](using-service-linked-roles-CDC-streams.md)。

------
#### [ Console ]

**使用 建立新串流時新增標籤 （主控台）**

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇**資料表**，然後選擇您要為其新增串流的資料表。

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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇**資料表**，然後選擇具有您要標記之串流的資料表。

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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **Tables** (資料表)。

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. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **Tables** (資料表)。

1. 從清單中選擇資料表，然後選擇**串流**索引標籤。

1. 您可以在標籤區段中檢視串流**的標籤**。

------
#### [ Cassandra Query Language (CQL) ]

**使用 CQL 檢視串流的標籤**

若要讀取連接至串流的標籤，您必須在 `WHERE`子句中指定串流的資源 ARN。下列 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 的標籤建立成本分配報告
<a name="CostAllocationReports"></a>

AWS 使用標籤來整理成本分配報告中的資源成本。 AWS 提供兩種類型的成本分配標籤：
+  AWS產生的 tag. AWS defines、建立和套用此標籤。
+ 使用者定義的標籤。您可以定義、建立和套用這些標籤。

您必須分別啟用這兩種標籤，它們才會顯示在 Cost Explorer 或成本分配報告中。

 若要啟用 AWS產生的標籤：

1.  登入 AWS 管理主控台 並開啟 Billing and Cost Management 主控台，網址為 [https：//https://console.aws.amazon.com/billing/home\$1/。](https://console.aws.amazon.com/billing/home#/)

1.  在導覽窗格中，選擇 **Cost Allocation Tags** (成本分配標籤)。

1.  在 **AWS-Generated Cost Allocation Tags** (AWS產生的成本分配標籤) 下，選擇 **Activate** (啟用)。

 若要啟用使用者定義的標籤：

1.  登入 AWS 管理主控台 並開啟 Billing and Cost Management 主控台，網址為 [https：//https://console.aws.amazon.com/billing/home\$1/。](https://console.aws.amazon.com/billing/home#/)

1.  在導覽窗格中，選擇 **Cost Allocation Tags** (成本分配標籤)。

1.  在 **User-Generated Cost Allocation Tags** (使用者產生的成本分配標籤) 下，選擇 **Activate** (啟用)。

 在您建立和啟用標籤之後， AWS 會產生成本分配報告，其中包含依作用中標籤分組的用量和成本。成本分配報告包含每個計費期間的所有 AWS 成本。該報告同時包含有標籤和沒標籤的資源，以便您可清楚地整理資源的費用。

**注意**  
 目前，從 Amazon Keyspaces 傳出的任何資料都不會依成本分配報告上的標籤細分。

 如需詳細資訊，請參閱[使用成本分配標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。