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

# 將標籤新增至現有資料表的新串流
<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}]'
   ```

------