

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á.

# Habilitar um fluxo CDC para uma tabela existente no Amazon Keyspaces
<a name="keyspaces-enable-cdc-alter-table"></a>

Para habilitar um fluxo CDC para uma tabela existente, você pode usar a `ALTER TABLE` instrução em CQL, o `update-table` comando com o AWS CLI, ou você pode usar o console.

Para cada linha alterada na tabela, o Amazon Keyspaces pode capturar as seguintes alterações com base nas `view_type` `cdc_specification` que você selecionar:
+ `NEW_AND_OLD_IMAGES`— ambas as versões da linha, antes e depois da alteração. Esse é o padrão.
+ `NEW_IMAGE`— a versão da linha após a alteração.
+ `OLD_IMAGE`— a versão da linha antes da alteração.
+ `KEYS_ONLY`— as chaves de partição e agrupamento da linha que foi alterada.

Para obter informações sobre como marcar um stream, consulte[Adicionar novas tags a um stream](Tagging.Operations.existing.stream.md).

**nota**  
O Amazon Keyspaces CDC exige a presença de uma função vinculada ao serviço (`AWSServiceRoleForAmazonKeyspacesCDC`) que publica dados métricos dos fluxos do CDC do Amazon Keyspaces em 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 de CDC do Amazon Keyspaces](using-service-linked-roles-CDC-streams.md).

------
#### [ Cassandra Query Language (CQL) ]

**Habilitar um fluxo (fluxo CDC) com CQL**

Você pode usar `ALTER TABLE` para ativar um fluxo para uma tabela existente.

1. O exemplo a seguir cria um fluxo que captura somente as alterações nas chaves de partição e agrupamento de uma linha alterada.

   ```
   ALTER TABLE mykeyspace.mytable
   WITH cdc = TRUE
   AND CUSTOM_PROPERTIES={'cdc_specification': {'view_type': 'KEYS_ONLY'}};
   ```

1. Para verificar as configurações de transmissão, você pode usar a seguinte declaração.

   ```
   SELECT keyspace_name, table_name, cdc, custom_properties FROM system_schema_mcs.tables WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
   ```

   A saída da declaração é semelhante a essa.

   ```
    keyspace_name | table_name | cdc  | custom_properties
   ---------------+------------+------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
       mykeyspace |    mytable | True | {'capacity_mode': {'last_update_to_pay_per_request_timestamp': '1741385897045', 'throughput_mode': 'PAY_PER_REQUEST'}, 'cdc_specification': {'latest_stream_arn': 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable/stream/2025-03-07T22:20:10.454', 'status': 'ENABLED', 'view_type': 'KEYS_ONLY'}, 'encryption_specification': {'encryption_type': 'AWS_OWNED_KMS_KEY'}, 'point_in_time_recovery': {'status': 'disabled'}}
   ```

------
#### [ CLI ]

**Crie um fluxo CDC com o AWS CLI**

1. Para criar um fluxo para uma tabela existente, você pode usar a seguinte sintaxe.

   ```
   aws keyspaces update-table \
   --keyspace-name 'mykeyspace' \
   --table-name 'mytable' \
   --cdc-specification status=ENABLED,viewType=NEW_AND_OLD_IMAGES
   ```

1. A saída desse comando mostra a `create-table` resposta padrão e é semelhante a este exemplo.

   ```
   { "resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable" }
   ```

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

**Habilite um stream CDC com o console Amazon Keyspaces**

1. Faça login no e abra Console de gerenciamento da AWS o console do Amazon Keyspaces em [ https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home).

1. No painel de navegação, escolha ** Tabelas e**, em seguida, escolha uma tabela na lista.

1. Escolha a ** guia ** Streams.

1. Escolha ** Editar ** para ativar um stream.

1. Selecione ** Ativar transmissões**.

1. Escolha o tipo ** de ** exibição do fluxo. As seguintes opções estão disponíveis: Observe que você não pode alterar o tipo de visualização de um stream após sua criação.
   + **Imagens novas e antigas ** — O Amazon Keyspaces captura as duas versões da linha, antes e depois da alteração. Esse é o padrão.
   + **Nova imagem ** — O Amazon Keyspaces captura somente a versão da linha após a alteração.
   + **Imagem antiga ** — O Amazon Keyspaces captura somente a versão da linha antes da alteração.
   + **Somente chave primária ** — O Amazon Keyspaces captura somente as colunas de partição e chave de agrupamento da linha que foi alterada.

1. Para finalizar, escolha ** Salvar alterações**.

------