기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Keyspaces 리소스에 대한 태그 및 레이블 작업
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 Keyspace에 대한 태그를 사용하여 비용 할당 보고서 생성](CostAllocationReports.md)를 사용하여 활성 태그당 AWS 비용을 추적합니다.
끝으로, 최적화된 태깅 전략을 따르는 것이 좋습니다. 자세한 내용은 [AWS 태깅 전략](https://d0.awsstatic.com/aws-answers/AWS_Tagging_Strategies.pdf)을 참조하세요.
# 태그를 사용하여 Amazon Keyspaces의 리소스에 레이블을 지정하는 데 제한 사항이 있습니다.
각 태그는 사용자가 정의하는 키와 값으로 구성됩니다. 다음과 같은 제한 사항이 있습니다.
+ 각 Amazon Keyspaces 키스페이스, 테이블 또는 스트림에는 동일한 키를 가진 태그가 하나만 있을 수 있습니다. 기존 태그(동일한 키)를 추가하는 경우 기존 태그 값이 새 값으로 업데이트됩니다.
+ 키스페이스에 적용된 태그는 해당 키스페이스 내의 테이블에 자동으로 적용되지 않습니다. 키스페이스 및 모든 테이블에 동일한 태그를 적용하려면 각 리소스에 개별적으로 태그를 지정해야 합니다.
+ 테이블에 적용된 태그는 해당 테이블의 스트림에 자동으로 적용되지 않습니다. 테이블 생성 중에 테이블과 스트림에 동일한 태그를 적용하려면 테이블을 생성할 때 `PropagateTagsOnEnable` 플래그를 사용할 수 있습니다. Amazon Keyspaces는이 플래그를 사용하여 스트림 생성 중에 테이블의 태그를 스트림에 적용합니다. 스트림이 활성화되면 테이블 태그에 대한 변경 사항이 스트림에 적용되지 않습니다.
+ 다중 리전 키스페이스 또는 테이블을 생성하면 생성 프로세스 중에 정의한 모든 태그가 모든 리전의 모든 키스페이스와 테이블에 자동으로 적용됩니다. `ALTER KEYSPACE` 또는 `ALTER TABLE`을 사용하여 기존 태그를 변경하면 변경하려는 리전의 키스페이스 또는 테이블에만 업데이트가 적용됩니다.
+ 하나의 값은 태그 범주(키) 내에서 서술자 역할을 수행합니다. Amazon Keyspaces에서는 값이 비어 있거나 null일 수 없습니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 최대 키 길이는 유니코드 문자 128자입니다.
+ 최대 값 길이는 유니코드 문자 256자입니다.
+ 허용되는 문자는 문자, 공백, 숫자, 특수 문자(`+ - = . _ : /`)입니다.
+ 리소스당 최대 태그 수는 50개입니다.
+ AWS할당된 태그 이름과 값에는 할당할 수 없는 `aws:` 접두사가 자동으로 할당됩니다. AWS할당된 태그 이름은 태그 제한인 50에 포함되지 않습니다. 비용 할당 보고서에는 사용자가 지정한 태그 이름인 `user:` 접두사가 포함됩니다.
+ 태그를 소급해서 적용할 수 없습니다.
# Amazon Keyspaces에서 키스페이스, 테이블 및 스트림에 태그 지정
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)
# 새 키스페이스를 생성할 때 태그 추가
새 키스페이스를 생성할 때 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'
```
------
# 키스페이스에 태그 추가
다음 예제는 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'
```
------
# 키스페이스에서 태그 삭제
------
#### [ 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'
```
------
# 키스페이스의 태그 보기
다음 예제에서는 콘솔, 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"
}
]
}
```
------
# 새 테이블을 생성할 때 태그 추가
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'
```
------
# 테이블에 태그 추가
콘솔, 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'
```
------
# 테이블에서 태그 삭제
------
#### [ 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'
```
------
# 테이블의 태그 보기
다음 예제에서는 콘솔, 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"
}
]
}
```
------
# 테이블을 생성할 때 새 스트림에 태그 추가
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}]'
```
------
# 기존 테이블의 새 스트림에 태그 추가
기존 테이블에 대한 새 스트림을 생성할 때 태그를 추가할 수 있습니다. `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}]'
```
------
# 스트림에 새 태그 추가
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'
```
------
# 스트림에서 태그 삭제
스트림에서 태그를 삭제하려면 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'
```
------
# 스트림의 태그 보기
다음 예제에서는 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"
}
]
}
```
------
# Amazon Keyspace에 대한 태그를 사용하여 비용 할당 보고서 생성
AWS 는 태그를 사용하여 비용 할당 보고서에서 리소스 비용을 구성합니다.는 두 가지 유형의 비용 할당 태그를 AWS 제공합니다.
+ AWS생성 태그는이 태그를 AWS 정의, 생성 및 적용합니다.
+ 사용자 정의 태그로, 사용자가 태그를 정의, 생성 또는 적용합니다.
두 유형의 태그 모두 개별적으로 활성화해야만 Cost Explorer나 비용 할당 보고서에 표시됩니다.
AWS생성된 태그를 활성화하려면:
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/billing/home Billing and Cost Management 콘솔을 엽니다.](https://console.aws.amazon.com/billing/home#/)
1. 탐색 창에서 **비용 할당 태그**를 선택합니다.
1. **AWS-Generated Cost Allocation Tags(AWS생성 비용 할당 태그)**에서 **Activate(활성화)**를 선택합니다.
사용자 정의 태그 활성화 방법
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/billing/home Billing and Cost Management 콘솔을 엽니다.](https://console.aws.amazon.com/billing/home#/)
1. 탐색 창에서 **비용 할당 태그**를 선택합니다.
1. **사용자 정의 비용 할당 태그**에서 **활성화**를 선택합니다.
태그를 생성하고 활성화한 후는 활성 태그별로 그룹화된 사용량 및 비용이 포함된 비용 할당 보고서를 AWS 생성합니다. 비용 할당 보고서에는 각 결제 기간의 모든 AWS 비용이 포함됩니다. 보고서에 태그가 지정된 리소스와 태그가 지정되지 않은 리소스가 모두 포함되어 있어 리소스에 대한 요금을 알아보기 쉽게 정리할 수 있습니다.
**참고**
현재 Amazon Keyspaces에서 이전한 모든 데이터에 대해 비용 할당 보고서의 태그로 구분되지는 않습니다.
자세한 내용은 [비용 할당 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)을 참조하세요.