기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Keyspaces에서 키스페이스, 테이블 및 스트림에 태그 지정
<a name="Tagging.Operations"></a>

Amazon Keyspaces 콘솔, 또는 Cassandra 쿼리 언어(CQL)를 사용하여 키스페이스, 테이블 및 스트림에 대한 태그를 추가, 나열 AWS CLI, 편집 또는 삭제할 수 있습니다. 그런 다음 이러한 사용자 정의 태그를 활성화하여 비용 할당 추적을 위해 AWS 결제 및 비용 관리 콘솔에 표시할 수 있습니다. 자세한 내용은 [Amazon Keyspace에 대한 태그를 사용하여 비용 할당 보고서 생성](CostAllocationReports.md) 단원을 참조하십시오.

 일괄 편집을 위해 콘솔에서 Tag Editor를 사용할 수 있습니다. 자세한 내용은 *AWS Resource Groups 사용 설명서*에서 [Tag Editor 작업](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. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

1. 탐색 창에서 **Keyspaces**를 선택한 다음 **키스페이스 생성**을 선택합니다.

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 Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

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. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

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. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

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. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

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>

콘솔, CQL 또는 AWS CLI를 사용하여 Amazon Keyspaces의 기존 테이블에 태그를 추가할 수 있습니다.

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

**Amazon Keyspaces 콘솔을 사용하여 테이블에 태그 추가**

1. 에 로그인 AWS Management Console하고 [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 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 Management Console하고 [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 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 Management Console하고 [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_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에서는 사용자를 대신하여 Amazon Keyspaces CDC 스트림의 지표 데이터를 CloudWatch 계정의에 게시하는 서비스 연결 역할(`AWSServiceRoleForAmazonKeyspacesCDC`)`"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에서는 사용자를 대신하여 Amazon Keyspaces CDC 스트림의 지표 데이터를 CloudWatch 계정의에 게시하는 서비스 연결 역할(`AWSServiceRoleForAmazonKeyspacesCDC`)`"cloudwatch:namespace": "AWS/Cassandra"`이 있어야 합니다. 이 역할은 자동으로 생성됩니다. 자세한 내용은 [Amazon Keyspaces CDC 스트림에 역할 사용](using-service-linked-roles-CDC-streams.md) 단원을 참조하십시오.

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

**를 사용하여 새 스트림을 생성할 때 태그 추가(콘솔)**

1. 에 로그인 AWS Management Console하고 [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 Management Console하고 [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 Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

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. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) Amazon Keyspaces 콘솔을 엽니다.

1. 탐색 창에서 **테이블**을 선택합니다.

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"
          }
      ]
  }
  ```

------