Amazon Keyspaces의 태그 지정 작업

Amazon Keyspaces(Apache Cassandra용) 콘솔, AWS CLI 또는 Cassandra 쿼리 언어(CQL)를 사용하여 키스페이스 및 테이블의 태그를 추가, 나열, 편집 또는 삭제할 수 있습니다. 이러한 사용자 정의 태그를 활성화하면 AWS Billing and Cost Management 콘솔에 표시되어 비용 할당을 추적할 수 있습니다. 자세한 내용은 Amazon Keyspace에 대한 비용 할당 보고서 섹션을 참조하세요.

일괄 편집을 위해 콘솔에서 Tag Editor를 사용할 수 있습니다. 자세한 내용은 AWS Resource Groups 사용 설명서에서 Tag Editor 작업을 참조하세요.

콘솔을 사용하여 신규 또는 기존 키스페이스 및 테이블에 태그 추가

Amazon Keyspaces 콘솔을 사용하여 생성한 신규 키스페이스 및 테이블에 태그를 추가할 수 있습니다. 기존 테이블의 태그를 추가, 편집 또는 삭제할 수도 있습니다.

키스페이스를 생성할 때 키스페이스에 태그를 지정하려면(콘솔)

1. AWS Management Console에 로그인하고 Amazon Keyspaces 콘솔(https://console.aws.amazon.com/msk/home)을 엽니다.

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

3. 키스페이스 생성 페이지에서 키스페이스의 이름을 입력합니다. 태그에 대한 키 및 값을 입력하려면 새 태그 추가를 선택합니다.

4. 키스페이스 생성을 선택합니다.

테이블을 생성할 때 테이블에 태그를 지정하려면(콘솔)

1. AWS Management Console에 로그인하고 Amazon Keyspaces 콘솔(https://console.aws.amazon.com/msk/home)을 엽니다.

2. 탐색 창에서 테이블을 선택한 다음 테이블 생성을 선택합니다.

3. 테이블 세부 정보 섹션의 테이블 생성 페이지에서 키스페이스를 선택하고 테이블의 이름을 입력합니다.

4. 스키마 섹션에서 테이블의 스키마를 생성합니다.

5. 테이블 설정 섹션에서 설정 사용자 지정을 선택합니다.

6. 테이블 태그 - 옵션 섹션으로 이동한 다음 새 태그 추가를 선택하여 새 태그를 생성합니다.

7. 테이블 생성을 선택합니다.

기존 리소스에 태그를 지정하려면(콘솔)

1. AWS Management Console에 로그인하고 Amazon Keyspaces 콘솔(https://console.aws.amazon.com/msk/home)을 엽니다.

2. 탐색 창에서 Keyspaces 또는 Tables를 선택합니다.

3. 목록에서 키스페이스 또는 테이블을 선택합니다. 그런 다음 태그 관리를 선택하여 태그를 추가, 편집 또는 삭제합니다.

태그 구조에 대한 자세한 내용은 Amazon Keyspaces에 대한 태그 지정 제한 섹션을 참조하세요.

AWS 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'

다음 예제에서는 기존 테이블에 새 태그를 추가하는 방법을 보여 줍니다.

aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable' --tags 'key=key3,value=val3' 'key=key4,value=val4'

다음 예제에서는 지정된 리소스의 태그를 나열하는 방법을 보여 줍니다.

aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable'

마지막 명령의 출력은 다음과 같습니다.

{
    "tags": [
        {
            "key": "key1",
            "value": "val1"
        },
        {
            "key": "key2",
            "value": "val2"
        },
        {
            "key": "key3",
            "value": "val3"
        },
        {
            "key": "key4",
            "value": "val4"
        }
    ]
}

CQL을 사용하여 신규 또는 기존 키스페이스 및 테이블에 태그 추가

다음 예제에서는 CQL을 사용하여 키스페이스 및 테이블 생성 시 태그를 지정하는 방법, 기존 리소스에 태그를 지정하는 방법 및 태그를 읽는 방법을 보여 줍니다.

다음 예제에서는 태그를 사용하여 새 키스페이스를 생성합니다.

CREATE KEYSPACE mykeyspace WITH TAGS = {'key1':'val1', 'key2':'val2'} ;
                

다음 예제에서는 태그를 사용하여 새 테이블을 생성합니다.

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

문의 리소스에 다른 명령을 사용하여 태그를 지정하려면

CREATE KEYSPACE mykeyspace WITH REPLICATION = {'class': 'Simple Strategy'} AND TAGS = {'key1':'val1', 'key2':'val2'};
                

다음 예제에서는 기존 키스페이스 및 테이블에 태그를 추가하거나 제거하는 방법을 보여 줍니다.

ALTER KEYSPACE mykeyspace ADD TAGS {'key1':'val1', 'key2':'val2'};

ALTER TABLE mytable DROP TAGS {'key1':'val1', 'key2':'val2'};

리소스에 첨부된 태그를 읽으려면 다음 CQL 문을 사용합니다.

SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause;

이 WHERE 절은 필수이며 다음 형식 중 하나여야 합니다.

• keyspace_name = 'mykeyspace' AND resource_type = 'keyspace'

• keyspace_name = 'mykeyspace' AND resource_name = 'mytable'

• 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:123456789:/keyspace/mykeyspace/      | mykeyspace    | mykeyspace    | keyspace      | {'key1': 'val1', 'key2': 'val2'}
            
        

다음 쿼리는 테이블의 태그를 보여 줍니다.

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:123456789:/keyspace/mykeyspace/table/mytable    | mykeyspace    | mytable       | table         | {'key1': 'val1', 'key2': 'val2'}