As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Como trabalhar com tags e rótulos para recursos do Amazon Keyspaces *Você pode rotular recursos do Amazon Keyspaces (para Apache Cassandra) usando *tags. As tags permitem categorizar recursos de diferentes maneiras, por exemplo, por finalidade, proprietário, ambiente ou outros critérios. As tags podem ajudar a fazer o seguinte: + Identificar rapidamente um recurso com base nas tags que você atribuiu a ele. + Veja AWS as contas divididas por etiquetas. + Controle o acesso aos recursos do Amazon Keyspaces com base em tags. Para ver exemplos de política do IAM usando tags, consulte [Autorização baseada em tags do Amazon Keyspaces](security_iam_service-with-iam.md#security_iam_service-with-iam-tags). A marcação é suportada por AWS serviços como Amazon Elastic Compute Cloud (Amazon EC2), Amazon Simple Storage Service (Amazon S3), Amazon Keyspaces e muito mais. Uma marcação eficiente é capaz de fornecer insights de custos, permitindo criar relatórios entre serviços que possuem uma tag específica. Para começar a usar tags, faça o seguinte: 1. Compreender [Restrições para usar tags para rotular recursos no Amazon Keyspaces](TaggingRestrictions.md). 1. Criar tags usando [Marque keyspaces, tabelas e streams no Amazon Keyspaces](Tagging.Operations.md). 1. Use [Crie relatórios de alocação de custos usando tags para Amazon Keyspaces](CostAllocationReports.md) para monitorar seus AWS custos por tag ativa. Por fim, é recomendável seguir estratégias de marcação ideais. Para obter informações, consulte [Estratégias de marcação da AWS](https://d0.awsstatic.com/aws-answers/AWS_Tagging_Strategies.pdf). # Restrições para usar tags para rotular recursos no Amazon Keyspaces Cada tag consiste em uma chave e um valor, ambos definidos por você. As seguintes restrições são aplicáveis: + Cada keyspace, tabela ou stream do Amazon Keyspaces pode ter somente uma tag com a mesma chave. Se você tentar adicionar uma tag existente (mesma chave), o valor da tag existente será atualizado para o novo valor. + As tags aplicadas a um espaço de chave não se aplicam automaticamente às tabelas dentro desse espaço de tecla. Para aplicar a mesma tag a um espaço de chaves e a todas as suas tabelas, cada recurso deve ser marcado individualmente. + As tags aplicadas a uma tabela não se aplicam automaticamente ao stream dessa tabela. Para aplicar as mesmas tags a uma tabela e ao stream durante a criação da tabela, você pode usar o `PropagateTagsOnEnable` sinalizador ao criar a tabela. Usando essa sinalização, o Amazon Keyspaces aplica as tags da tabela ao stream durante a criação do stream. Quando o stream está ativo, as alterações nas tags da tabela não se aplicam ao stream. + Quando você cria uma tabela ou espaço de chaves multirregional, todas as tags que você define durante o processo de criação são aplicadas automaticamente a todos os espaços de chaves e tabelas em todas as Regiões. Quando você altera as tags existentes usando `ALTER KEYSPACE` ou `ALTER TABLE`, a atualização é aplicada somente ao espaço de chaves ou à tabela na Região em que você está fazendo a alteração. + Um valor atua como um descritor dentro de uma categoria de tag (chave). No Amazon Keyspaces, o valor não pode estar em branco nem ser nulo. + As chaves e valores das tags diferenciam maiúsculas de minúsculas. + O comprimento máximo da chave é 128 caracteres Unicode. + O número máximo de tags que você pode atribuir a um recurso é 50. + Os caracteres permitidos são letras, espaço em branco e números, além dos seguintes caracteres especiais: `+ - = . _ : /` + O número máximo de tags por recurso é 50. + AWS- os nomes e valores das tags atribuídos recebem automaticamente o `aws:` prefixo, que você não pode atribuir. AWS-os nomes de tag atribuídos não contam para o limite de 50. Nomes de tags atribuídos pelo usuário têm o prefixo `user:` no relatório de alocação de custos. + Não é possível colocar uma data retroativa na aplicação de uma tag. # Marque keyspaces, tabelas e streams no Amazon Keyspaces Você pode adicionar, listar, editar ou excluir tags para keyspaces, tabelas e streams usando o console Amazon Keyspaces, o ou a Cassandra Query Language AWS CLI(CQL). Em seguida, você pode ativar essas tags definidas pelo usuário para que elas apareçam no Gerenciamento de Faturamento e Custos da AWS console para rastrear a alocação de custos. Para obter mais informações, consulte [Crie relatórios de alocação de custos usando tags para Amazon Keyspaces](CostAllocationReports.md). Para edição em massa, também é possível usar o Tag Editor no console. Para obter mais informações, consulte [Como trabalhar com o Tag Editor](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) no *Guia do usuário do AWS Resource Groups *. Para obter informações sobre a estrutura da tag, consulte [Restrições para usar tags para rotular recursos no Amazon Keyspaces](TaggingRestrictions.md). **Topics** + [Adicionar tags ao criar um novo espaço de chaves](Tagging.Operations.new.keyspace.md) + [Adicionar tags a um espaço de chaves](Tagging.Operations.existing.keyspace.md) + [Excluir tags de um espaço de chaves](Tagging.Operations.existing.keyspace.drop.md) + [Exibir as tags de um espaço de chaves](Tagging.Operations.view.keyspace.md) + [Adicionar tags ao criar uma tabela](Tagging.Operations.new.table.md) + [Adicionar tags a uma tabela](Tagging.Operations.existing.table.md) + [Excluir tags de uma tabela](Tagging.Operations.existing.table.drop.md) + [Exibir as tags de uma tabela](Tagging.Operations.view.table.md) + [Adicione tags a um novo stream ao criar uma tabela](Tagging.Operations.new.table.stream.md) + [Adicionar tags a um novo fluxo para uma tabela existente](Tagging.Operations.new.stream.md) + [Adicionar novas tags a um stream](Tagging.Operations.existing.stream.md) + [Excluir tags de um stream](Tagging.Operations.existing.stream.drop.md) + [Exibir as tags de um stream](Tagging.Operations.view.stream.md) # Adicionar tags ao criar um novo espaço de chaves Você pode usar o console Amazon Keyspaces, o CQL ou o AWS CLI para adicionar tags ao criar um novo keyspace. ------ #### [ Console ] **Definir uma tag ao criar um novo espaço de chaves usando o console** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, selecione **Espaços de chaves** e, em seguida, escolha **Criar espaço de chaves**. 1. Na página **Criar espaço de chaves**, forneça um nome para o espaço de chaves. 1. Em **Tags** selecione **Adicionar nova tag** e insira uma chave e um valor. 1. Selecione **Criar espaço de chaves**. ------ #### [ Cassandra Query Language (CQL) ] **Definir uma tag ao criar um novo espaço de chaves usando CQL** + O exemplo a seguir cria um novo espaço de chaves com tags. ``` CREATE KEYSPACE mykeyspace WITH TAGS = {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **Defina uma tag ao criar um novo espaço de teclas usando a AWS CLI** + A instrução a seguir cria um novo espaço de chaves com tags. ``` aws keyspaces create-keyspace --keyspace-name 'myKeyspace' --tags 'key=key1,value=val1' 'key=key2,value=val2' ``` ------ # Adicionar tags a um espaço de chaves Os exemplos a seguir mostram como adicionar tags a um espaço de chaves no Amazon Keyspaces. ------ #### [ Console ] **Adicionar uma tag a um espaço de chaves existente usando o console** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, escolha **Keyspaces**. 1. Selecione um espaço de chave na lista. Em seguida, escolha a guia **Tags**, onde você pode ver as tags do espaço de chaves. 1. Escolha **Gerenciar tags** para adicionar, editar ou excluir tags. 1. Escolha **Salvar alterações**. ------ #### [ Cassandra Query Language (CQL) ] **Adicionar uma tag a um espaço de chave existente usando CQL** + ``` ALTER KEYSPACE mykeyspace ADD TAGS {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **Adicione uma tag a um espaço de teclas existente usando a AWS CLI** + O seguinte exemplo mostra como adicionar novas tags a um espaço de chaves existente. ``` aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/' --tags 'key=key3,value=val3' 'key=key4,value=val4' ``` ------ # Excluir tags de um espaço de chaves ------ #### [ Console ] **Excluir uma etiqueta de um espaço de chave existente usando o console** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, escolha **Keyspaces**. 1. Selecione um espaço de chave na lista. Em seguida, escolha a guia **Tags**, onde você pode ver as tags do espaço de chaves. 1. Escolha **Gerenciar tags** e exclua as tags que você não precisa mais. 1. Escolha **Salvar alterações**. ------ #### [ Cassandra Query Language (CQL) ] **Excluir uma tag de um espaço de chaves existente usando CQL** + ``` ALTER KEYSPACE mykeyspace DROP TAGS {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **Exclua uma tag de um espaço de teclas existente usando a AWS CLI** + A instrução a seguir remove as tags especificadas de um espaço de chaves. ``` aws keyspaces untag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/' --tags 'key=key3,value=val3' 'key=key4,value=val4' ``` ------ # Exibir as tags de um espaço de chaves Os exemplos a seguir mostram como ler tags usando o console, o CQL ou a AWS CLI. ------ #### [ Console ] **Exibir tags de um espaço de chaves usando o console do Amazon Keyspaces** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, escolha **Keyspaces**. 1. Selecione um espaço de chave na lista. Em seguida, escolha a guia **Tags**, onde você pode ver as tags do espaço de chaves. ------ #### [ Cassandra Query Language (CQL) ] **Exibir as tags de um espaço de chaves usando o CQL** Para ler as tags anexadas a um espaço de chaves, use a instrução CQL a seguir. ``` SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause; ``` A cláusula `WHERE` é obrigatória e deve usar um dos seguintes formatos: + `keyspace_name = 'mykeyspace' AND resource_type = 'keyspace'` + `resource_id = arn` + A instrução a seguir mostra se um espaço de chaves tem tags. ``` SELECT * FROM system_schema_mcs.tags WHERE keyspace_name = 'mykeyspace' AND resource_type = 'keyspace'; ``` A saída da consulta é semelhante ao seguinte. ``` 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 ] **Visualize as tags de um espaço de teclas usando o AWS CLI** + Este exemplo mostra como listar as tags do recurso especificado. ``` aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/' ``` A saída do último comando tem a aparência a seguir. ``` { "tags": [ { "key": "key1", "value": "val1" }, { "key": "key2", "value": "val2" }, { "key": "key3", "value": "val3" }, { "key": "key4", "value": "val4" } ] } ``` ------ # Adicionar tags ao criar uma tabela Você pode usar o console Amazon Keyspaces, o CQL ou o AWS CLI para adicionar tags às novas tabelas ao criá-las. ------ #### [ Console ] **Adicionar uma tag ao criar uma tabela usando o (console)** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, selecione **Tables (Tabelas)** e **Create table (Criar tabela)**. 1. Na página **Criar tabela**, na seção **Detalhes da tabela**, selecione um espaço de chaves e forneça um nome para a tabela. 1. Na seção **Esquema**, crie o esquema para sua tabela. 1. Na seção **Configurações da tabela**, selecione **Personalizar configurações**. 1. Vá até a seção **Tags de tabela: *opcional*** e selecione **Adicionar nova tag** para criar novas tags. 1. Escolha **Create table**. ------ #### [ Cassandra Query Language (CQL) ] **Adicionar tags ao criar uma tabela usando CQL** + O exemplo a seguir cria uma nova tabela com tags. ``` CREATE TABLE mytable(...) WITH TAGS = {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **Adicione tags ao criar uma nova tabela usando a AWS CLI** + O exemplo a seguir mostra como criar uma nova tabela com tags. O comando cria uma tabela *myTable* em um espaço de chaves *myKeyspace* existente. Observe que o comando foi dividido em linhas diferentes para ajudar na legibilidade. ``` 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' ``` ------ # Adicionar tags a uma tabela Você pode adicionar tags a uma tabela existente no Amazon Keyspaces usando o console, o CQL ou a AWS CLI. ------ #### [ Console ] **Adicionar tags a uma tabela usando o console do Amazon Keyspaces** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, selecione **Tabelas**. 1. Escolha uma tabela na lista e selecione a guia **Tags**. 1. Escolha **Gerenciar tags** para adicionar tags à tabela. 1. Escolha **Salvar alterações**. ------ #### [ Cassandra Query Language (CQL) ] **Adicionar tags a uma tabela usando CQL** + A instrução a seguir mostra como adicionar tags a uma tabela existente. ``` ALTER TABLE mykeyspace.mytable ADD TAGS {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **Adicione tags a uma tabela usando o AWS CLI** + O seguinte exemplo mostra como adicionar novas tags à tabela existente. ``` 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' ``` ------ # Excluir tags de uma tabela ------ #### [ Console ] **Excluir tags de uma tabela usando o console do Amazon Keyspaces** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, selecione **Tabelas**. 1. Escolha uma tabela na lista e selecione a guia **Tags**. 1. Escolha **Gerenciar tags** para excluir tags de uma tabela. 1. Escolha **Salvar alterações**. ------ #### [ Cassandra Query Language (CQL) ] **Excluir tags de uma tabela usando CQL** + A instrução a seguir mostra como excluir tags de uma tabela existente. ``` ALTER TABLE mytable DROP TAGS {'key3':'val3', 'key4':'val4'}; ``` ------ #### [ CLI ] **Adicione tags a uma tabela usando o AWS CLI** + A instrução a seguir remove as tags especificadas de um espaço de chaves. ``` 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' ``` ------ # Exibir as tags de uma tabela Os exemplos a seguir mostram como visualizar as tags de uma tabela no Amazon Keyspaces usando o console, o CQL ou o. AWS CLI ------ #### [ Console ] **Exibir as tags de uma tabela usando o console** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, selecione **Tabelas**. 1. Escolha uma tabela na lista e selecione a guia **Tags**. ------ #### [ Cassandra Query Language (CQL) ] **Exibir as tags de uma tabela usando CQL** Para ler as tags anexadas a uma tabela, use a instrução CQL a seguir. ``` SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause; ``` A cláusula `WHERE` é obrigatória e deve usar um dos seguintes formatos: + `keyspace_name = 'mykeyspace' AND resource_name = 'mytable'` + `resource_id = arn` + A consulta a seguir retorna as tags da tabela especificada. ``` SELECT * FROM system_schema_mcs.tags WHERE keyspace_name = 'mykeyspace' AND resource_name = 'mytable'; ``` A saída dessa consulta é semelhante à seguinte. ``` 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 ] **Visualize as tags de uma tabela usando o AWS CLI** + Este exemplo mostra como listar as tags do recurso especificado. ``` 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' ``` A saída do último comando tem a aparência a seguir. ``` { "tags": [ { "key": "key1", "value": "val1" }, { "key": "key2", "value": "val2" }, { "key": "key3", "value": "val3" }, { "key": "key4", "value": "val4" } ] } ``` ------ # Adicione tags a um novo stream ao criar uma tabela Você pode adicionar tags aos streams ao criar uma nova tabela com um stream usando CQL ou AWS CLI para marcar um stream. **nota** O Amazon Keyspaces CDC exige a presença de uma função vinculada ao serviço (`AWSServiceRoleForAmazonKeyspacesCDC`) que publique dados métricos dos streams do Amazon Keyspaces CDC na sua conta em seu nome. `"cloudwatch:namespace": "AWS/Cassandra"` CloudWatch Esta função é criada automaticamente para você. Para obter mais informações, consulte [Usando funções para streams CDC do Amazon Keyspaces](using-service-linked-roles-CDC-streams.md). ------ #### [ Cassandra Query Language (CQL) ] **Adicione tags a um stream ao criar uma nova tabela usando CQL** 1. Para criar uma nova tabela com um fluxo e aplicar as tags da tabela automaticamente ao fluxo, você pode usar o `'propagate_tags': 'TABLE'` sinalizador. A instrução a seguir é um exemplo disso. ``` 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. Para aplicar novas tags ao stream, você pode usar o exemplo a seguir. ``` 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 ] **Adicione tags a um stream ao criar uma nova tabela usando o AWS CLI** 1. Para criar uma tabela com um fluxo e aplicar as tags da tabela automaticamente ao fluxo, você pode usar o `propagateTags=Table` sinalizador. O código a seguir é um exemplo disso. ``` 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. Para aplicar tags diferentes ao stream, você pode usar o exemplo a seguir. ``` 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}]' ``` ------ # Adicionar tags a um novo fluxo para uma tabela existente Você pode adicionar tags ao criar um novo fluxo para uma tabela existente. Você pode usar o `PropagateTags` sinalizador para aplicar as tags da tabela ao stream ou especificar novas tags para o stream. Você pode usar o CQL ou o AWS CLI para marcar um novo stream. **nota** O Amazon Keyspaces CDC exige a presença de uma função vinculada ao serviço (`AWSServiceRoleForAmazonKeyspacesCDC`) que publique dados métricos dos streams do Amazon Keyspaces CDC na sua conta em seu nome. `"cloudwatch:namespace": "AWS/Cassandra"` CloudWatch Esta função é criada automaticamente para você. Para obter mais informações, consulte [Usando funções para streams CDC do Amazon Keyspaces](using-service-linked-roles-CDC-streams.md). ------ #### [ Console ] **Adicione tags ao criar um novo stream usando o (console)** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, escolha **Tabelas** e, em seguida, escolha a tabela para a qual você deseja adicionar um fluxo. 1. Escolha a guia **Streams**. 1. Na seção **Detalhes do stream**, escolha **Editar**. 1. Selecione **Ativar transmissões.** 1. Selecione o **tipo de visualização** e continue até **Tags** para criar tags para o stream. 1. Você pode selecionar uma das seguintes opções: + **Sem tags** — Use essa opção se você não quiser criar nenhuma tag para o stream. + **Copiar tags da tabela** — Use essa opção se quiser copiar as tags da tabela para o stream. Depois de copiar as tags, você pode editá-las para o stream. Observe que essa opção só está disponível se a tabela tiver tags. + **Adicionar novas tags** — Você pode adicionar até 50 tags ao stream escolhendo **Adicionar nova tag**. 1. Escolha **Salvar alterações**. ------ #### [ Cassandra Query Language (CQL) ] **Adicione tags ao criar um novo stream** 1. Para criar um novo fluxo para uma tabela existente e aplicar as tags da tabela ao fluxo, você pode usar o `'propagate_tags': 'TABLE'` sinalizador. As declarações a seguir são um exemplo disso. ``` ALTER TABLE mytable WITH cdc = TRUE AND CUSTOM_PROPERTIES={ 'cdc_specification': { 'view_type': 'NEW_IMAGE', 'propagate_tags': 'TABLE' } }; ``` 1. Para criar um novo fluxo para uma tabela existente e especificar novas tags, você pode usar o exemplo a seguir. ``` ALTER TABLE mytable WITH cdc = TRUE AND CUSTOM_PROPERTIES={ 'cdc_specification': { 'view_type': 'NEW_IMAGE', 'tags': { 'key': 'string', 'value': 'string' }} }; ``` ------ #### [ CLI ] **Adicione tags ao criar um novo stream usando o AWS CLI** 1. Para criar um novo stream com tags, você pode usar o `propagateTags=TABLE` sinalizador para aplicar as tags da tabela automaticamente ao stream. O código a seguir é um exemplo disso. ``` aws keyspaces update-table \ --keyspace-name 'my_keyspace' \ --table-name 'my_table' \ --cdc-specification propagateTags=TABLE,status=ENABLED,viewType=NEW_IMAGE ``` 1. Para criar um novo fluxo para uma tabela existente e especificar novas tags, você pode usar o exemplo a seguir. ``` 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}]' ``` ------ # Adicionar novas tags a um stream Você pode adicionar novas tags a um stream existente no Amazon Keyspaces usando o CQL ou o. AWS CLI Você só pode adicionar tags ao stream mais recente. ------ #### [ Console ] **Adicionar tags a um stream existente (console)** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, escolha **Tabelas** e, em seguida, escolha a tabela com o fluxo que você deseja marcar. 1. Escolha a guia **Streams**. 1. Na seção **Tags**, escolha **Gerenciar tags**. 1. Escolha **Adicionar nova tag** para adicionar uma nova tag. Você pode criar até 50 tags repetindo essa etapa. 1. Escolha **Salvar alterações**. ------ #### [ Cassandra Query Language (CQL) ] **Adicionar tags a um stream usando CQL** + A declaração a seguir mostra como adicionar tags a um stream existente. ``` ALTER TABLE mykeyspace.mytable ADD TAGS_FOR_CDC {'key1':'val1', 'key2':'val2'}; ``` ------ #### [ CLI ] **Adicione tags a um stream usando o AWS CLI** + O exemplo a seguir mostra como adicionar novas tags a um stream existente. ``` 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' ``` ------ # Excluir tags de um stream Para excluir tags de um stream, você pode usar CQL ou o. AWS CLI Você só pode excluir as tags do stream mais recente. ------ #### [ Console ] **Excluir tags de uma tabela usando o console do Amazon Keyspaces** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, selecione **Tabelas**. 1. Escolha uma tabela na lista e escolha a guia **Streams**. 1. Na seção **Tags**, escolha **Gerenciar tags** para excluir tags da tabela. 1. Depois da tag que você deseja excluir, escolha **Remover**. 1. Escolha **Salvar alterações**. ------ #### [ Cassandra Query Language (CQL) ] **Excluir tags de um stream usando CQL** + A declaração a seguir mostra como excluir tags de um stream existente. ``` ALTER TABLE mytable DROP TAGS_FOR_CDC {'key3':'val3', 'key4':'val4'}; ``` ------ #### [ CLI ] **Exclua tags de um stream usando o AWS CLI** + A declaração a seguir remove as tags especificadas de um stream. ``` 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' ``` ------ # Exibir as tags de um stream Os exemplos a seguir mostram como visualizar as tags de um stream no Amazon Keyspaces usando CQL ou o. AWS CLI ------ #### [ Console ] **Visualize as tags de um stream usando o console** 1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home) 1. No painel de navegação, selecione **Tabelas**. 1. Escolha uma tabela na lista e escolha a guia **Streams**. 1. Você pode ver as tags do stream na seção **Tags**. ------ #### [ Cassandra Query Language (CQL) ] **Visualize as tags de um stream usando CQL** Para ler as tags anexadas a um stream, você deve especificar o ARN do recurso do stream na `WHERE` cláusula. A sintaxe CQL a seguir é um exemplo disso. ``` SELECT * FROM system_schema_mcs.tags WHERE resource_id = stream_arn; ``` + A consulta a seguir retorna as tags do fluxo especificado. ``` 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'; ``` A saída dessa consulta é semelhante à seguinte. ``` 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 ] **Visualize as tags de um stream usando o AWS CLI** + Este exemplo mostra como listar as tags de todos os fluxos no espaço de teclas especificado. ``` 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' ``` A saída do último comando tem a aparência a seguir. ``` { "tags": [ { "key": "key1", "value": "val1" }, { "key": "key2", "value": "val2" }, { "key": "key3", "value": "val3" }, { "key": "key4", "value": "val4" } ] } ``` ------ # Crie relatórios de alocação de custos usando tags para Amazon Keyspaces AWS usa tags para organizar os custos dos recursos em seu relatório de alocação de custos. AWS fornece dois tipos de etiquetas de alocação de custos: + Uma tag AWS gerada. AWS define, cria e aplica essa tag para você. + Tags definidas pelo usuário. Você define, cria e aplica essas tags. É necessário ativar os dois tipos de tags separadamente para que elas possam ser exibidas no Cost Explorer ou em um relatório de alocação de custos. Para ativar as tags AWS geradas: 1. Faça login no console Billing Console de gerenciamento da AWS and Cost Management e abra o console Billing and Cost Management [https://console.aws.amazon.com/billing/em](https://console.aws.amazon.com/billing/home#/) home\$1/. 1. No painel de navegação, escolha **Cost Allocation Tags**. 1. Em **AWS Generated Cost Allocation Tags (Etiquetas de alocação de custos geradas)**, escolha **Activate (Ativar)**. Para ativar tags definidas pelo usuário: 1. Faça login no console Billing Console de gerenciamento da AWS and Cost Management e abra o console Billing and Cost Management [https://console.aws.amazon.com/billing/em](https://console.aws.amazon.com/billing/home#/) home\$1/. 1. No painel de navegação, escolha **Cost Allocation Tags**. 1. Em **Tags de alocação de custos definidos pelo usuário**, escolha **Ativar**. Depois de criar e ativar as tags, AWS gera um relatório de alocação de custos com seu uso e custos agrupados pelas tags ativas. O relatório de alocação de custos inclui todos os AWS custos de cada período de cobrança. O relatório inclui recursos com e sem tags, para que você possa organizar claramente as cobranças de cada um deles. **nota** Atualmente, qualquer dado transferido do Amazon Keyspaces não é categorizado por tags em relatórios de alocação de custos. Para obter mais informações, consulte [Usar tags de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).