翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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 Keyspaces のコスト配分レポートを作成する](CostAllocationReports.md)、アクティブなタグあたりの AWS コストを追跡します。
最後に、最適のタグ付け手法に従うことをお勧めします。詳細については、「[AWS tagging strategies ( タグ付け戦略)](https://d0.awsstatic.com/aws-answers/AWS_Tagging_Strategies.pdf)」を参照してください。
# タグを使用して Amazon Keyspaces リソースにラベルを付ける場合の制限事項
タグはそれぞれ、1 つのキーと 1 つの値で構成されており、どちらもお客様側が定義します。以下の制限が適用されます。
+ 各 Amazon Keyspaces キースペース、テーブル、またはストリームには、同じキーを持つタグを 1 つだけ含めることができます。既存のタグ (同じキー) を追加しようとすると、既存のタグの値は新しい値に更新されます。
+ キースペースに適用されたタグは、そのキースペース内のテーブルに自動的に適用されません。キースペースとそのすべてのテーブルに同じタグを適用するには、各リソースに個別にタグを付ける必要があります。
+ テーブルに適用されたタグは、そのテーブルのストリームに自動的に適用されません。テーブルの作成時にテーブルとストリームに同じタグを適用するには、テーブルの作成時に `PropagateTagsOnEnable`フラグを使用できます。このフラグを使用すると、Amazon Keyspaces はストリームの作成中にテーブルのタグをストリームに適用します。ストリームがアクティブな場合、テーブルタグへの変更はストリームには適用されません。
+ マルチリージョンのキースペースまたはテーブルを作成すると、作成プロセス中に定義したタグは、すべてのリージョンのすべてのキースペースとテーブルに自動的に適用されます。`ALTER KEYSPACE` または `ALTER TABLE` を使用して既存のタグを変更すると、その更新は変更を行うリージョンのキースペースまたはテーブルにのみ適用されます。
+ 値はタグカテゴリ (キー) の記述子として機能します。Amazon Keyspaces では、値を空または null にすることはできません
+ タグのキーと値では、大文字と小文字が区別されます。
+ キーの最大長は Unicode 文字で 128 文字です。
+ 値の最大長は Unicode 文字で 256 文字です。
+ 使用できる文字は、文字、ホワイトスペース、数字、および特殊文字 (`+ - = . _ : /`) です。
+ リソースあたりのタグの最大数は 50 です。
+ AWSによって割り当てられたタグ名と値には、割り当てることができない`aws:`プレフィックスが自動的に割り当てられます。 AWSによって割り当てられたタグ名は、タグ制限の 50 にはカウントされません。ユーザー側で割り当てたタグ名は、`user:` というプレフィックスを付けてコスト配分レポートに表示されます。
+ 過去にさかのぼってタグを適用することはできません。
# Amazon Keyspaces のキースペース、テーブル、ストリームにタグを付ける
Amazon Keyspaces コンソール、、または Cassandra クエリ言語 (CQL) を使用して、キースペース、テーブル、ストリームのタグを追加、一覧表示、編集 AWS CLI、または削除できます。その後、これらのユーザー定義タグをアクティブ化して、コスト配分の追跡のために AWS Billing and Cost Management コンソールに表示することができます。詳細については、「[タグを使用して Amazon Keyspaces のコスト配分レポートを作成する](CostAllocationReports.md)」を参照してください。
一括編集の場合は、コンソールのタグエディタを使用することもできます。詳細については、*「AWS Resource Groups ユーザーガイド」*の[「Working with 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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで [**Keyspaces (キー空間)**] を選択し、次に [**Create keyspace (キー空間の作成)**] を選択します。
1. [**Create keyspace (キー空間の作成)**] ページで、キー空間に名前を付けます。
1. **[タグ]** で **[新しいタグの追加]** を選択し、キーと値を入力します。
1. [**Create keyspace (キースペースの作成)**] を選択します。
------
#### [ 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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで、[**Keyspaces (キー空間)**] を選択します。
1. リストからキースペースを選択します。次に、**[タグ]** を選択します。キースペースのタグが表示されます。
1. **[タグの管理]** を選択して、タグを追加、編集、または削除します。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ 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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで、[**Keyspaces (キー空間)**] を選択します。
1. リストからキースペースを選択します。次に、**[タグ]** を選択します。キースペースのタグが表示されます。
1. **[タグの管理]** を選択し、不要になったタグを削除します。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ 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 マネジメントコンソール、[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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで [**Tables (テーブル)**] を選択して、[**Create table (テーブルの作成)**] を選択します。
1. [**Table details (テーブルの詳細)**] セクションの [**Create table (テーブルの作成)**] ページで、キー空間を選択し、テーブルに名前を付けます。
1. [**Schema (スキーマ)**] セクションで、テーブルのスキーマを作成します。
1. [**Table settings (テーブルの設定)**] セクションで、[**Customize settings (設定のカスタマイズ)**] を選択します。
1. [**Table tags – *optional* (テーブルタグ - オプション)**] セクションに進み、[**Add new tag (新しいタグの追加)**] を選択して、新しいタグを作成します。
1. [**Create table (テーブルの作成)**] を選択します。
------
#### [ 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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで、[**Tables (テーブル)**] を選択します。
1. リストからテーブルを選択し、**[タグ]** タブを選択します。
1. **[タグの管理]** を選択して、テーブルにタグを追加します。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ Cassandra Query Language (CQL) ]
**CQL を使用してテーブルにタグを追加する**
+ 次のステートメントは、既存のテーブルに列タグを追加する方法を示しています。
```
ALTER TABLE mykeyspace.mytable ADD TAGS {'key1':'val1', 'key2':'val2'};
```
------
#### [ CLI ]
**を使用してテーブルにタグを追加する AWS CLI**
+ 次の例では、既存のテーブル に 5 つの新しいタグを追加する方法を示しています。
```
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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで、[**Tables (テーブル)**] を選択します。
1. リストからテーブルを選択し、**[タグ]** タブを選択します。
1. **[タグの管理]** を選択して、テーブルからタグを削除します。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ 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 マネジメントコンソール、[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"
}
]
}
```
------
# テーブルの作成時に新しいストリームにタグを追加する
CQL または を使用してストリームにタグを付けるストリームで新しいテーブルを作成するときに、ストリーム AWS CLI にタグを追加できます。
**注記**
Amazon Keyspaces CDC には、ユーザーに代わって Amazon Keyspaces CDC ストリームから CloudWatch アカウントの `"cloudwatch:namespace": "AWS/Cassandra"` にメトリクスデータを発行するサービスにリンクされたロール (`AWSServiceRoleForAmazonKeyspacesCDC`) が必要です。このロールは自動的に作成されます。詳細については、「[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 アカウントの `"cloudwatch:namespace": "AWS/Cassandra"` にメトリクスデータを発行するサービスにリンクされたロール (`AWSServiceRoleForAmazonKeyspacesCDC`) が必要です。このロールは自動的に作成されます。詳細については、「[Amazon Keyspaces CDC ストリームのロールの使用](using-service-linked-roles-CDC-streams.md)」を参照してください。
------
#### [ Console ]
**を使用して新しいストリームを作成するときにタグを追加する (コンソール）**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで、**テーブル**を選択し、ストリームを追加するテーブルを選択します。
1. **ストリーム**タブを選択します。
1. **ストリームの詳細**セクションで、**編集** を選択します。
1. **ストリームをオンにする** を選択します。
1. **表示タイプ**を選択し、**タグ**に進み、ストリームのタグを作成します。
1. 次のいずれかのオプションを選択できます。
+ **タグなし** – ストリームのタグを作成しない場合は、このオプションを使用します。
+ **テーブルからタグをコピー**する – テーブルからストリームにタグをコピーする場合は、このオプションを使用します。タグをコピーしたら、ストリームのタグを編集できます。このオプションは、テーブルにタグがある場合にのみ使用できることに注意してください。
+ **新しいタグの追加** – 新しいタグの追加を選択すると**、ストリームに最大 50 個のタグ**を追加できます。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ 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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで、**テーブル**を選択し、タグ付けするストリームを含むテーブルを選択します。
1. **ストリーム**タブを選択します。
1. **[タグ]** セクションで、**[タグを管理]** を選択します。
1. **新しいタグを追加** を選択して、新しいタグを追加します。このステップを繰り返すことで、最大 50 個のタグを作成できます。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ 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 マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで、[**Tables (テーブル)**] を選択します。
1. リストからテーブルを選択し、**ストリーム**タブを選択します。
1. **タグ**セクションで**タグの管理**を選択して、テーブルからタグを削除します。
1. 削除するタグの後に、**削除**を選択します。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ 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 マネジメントコンソール、[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 のコスト配分レポートを作成する
AWS はタグを使用してコスト配分レポートのリソースコストを整理します。 は 2 種類のコスト配分タグ AWS を提供します。
+ AWSが生成した tag. は、このタグ AWS を定義、作成、適用します。
+ ユーザー定義のタグ。これらのタグを定義、作成、適用します。
Cost Explorer またはコスト配分レポートで使用するには、事前に両方のタイプのタグを別々にアクティブ化しておく必要があります。
AWS生成されたタグをアクティブ化するには：
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/billing/home\$1/ で Billing and Cost Management コンソールを開きます。](https://console.aws.amazon.com/billing/home#/)
1. ナビゲーションペインで、**[Cost Allocation Tags]** (コスト配分タグ) を選択します。
1. [**AWS-Generated Cost Allocation Tags**] で、[**Activate**] を選択します。
ユーザー定義タグをアクティブにするには:
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/billing/home\$1/ で Billing and Cost Management コンソールを開きます。](https://console.aws.amazon.com/billing/home#/)
1. ナビゲーションペインで、**[Cost Allocation Tags]** (コスト配分タグ) を選択します。
1. **[User-Defined Cost Allocation Tags]** (ユーザー定義のコスト配分タグ) で、**[Activate]** (アクティブ化) を選択します。
タグを作成してアクティブ化すると、 は、使用量とコストをアクティブなタグ別にグループ化したコスト配分レポート AWS を生成します。コスト配分レポートには、各請求期間のすべての AWS コストが含まれます。タグ付きとタグなしのどちらのリソースもこのレポートに出力されるので、リソース別の請求額を明確に分類できます。
**注記**
現時点では、Amazon Keyspaces から転送されたデータは、コスト配分レポートのタグによって分類されません。
詳細については、[「Using cost allocation tags」](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)(コスト配分タグの使用) を参照してください。