Habilitar una transmisión de CDC para una tabla existente en Amazon Keyspaces - Amazon Keyspaces (para Apache Cassandra)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Habilitar una transmisión de CDC para una tabla existente en Amazon Keyspaces

Para habilitar una transmisión de CDC para una tabla existente, puede usar la ALTER TABLE sentencia en CQL, el update-table comando junto con la AWS CLI tabla o puede usar la consola.

Para cada fila modificada de la tabla, Amazon Keyspaces puede capturar los siguientes cambios en función view_type de los cdc_specification que seleccione:

  • NEW_AND_OLD_IMAGES— ambas versiones de la fila, antes y después del cambio. Esta es la opción predeterminada.

  • NEW_IMAGE— la versión de la fila tras el cambio.

  • OLD_IMAGE— la versión de la fila anterior al cambio.

  • KEYS_ONLY— las claves de partición y agrupamiento de la fila que se ha modificado.

Para obtener información sobre cómo etiquetar una transmisión, consulteAñadir nuevas etiquetas a una transmisión.

nota

Amazon Keyspaces CDC requiere la presencia de un rol vinculado a un servicio (AWSServiceRoleForAmazonKeyspacesCDC) que publique los datos de métricas de las transmisiones de Amazon Keyspaces CDC en su cuenta "cloudwatch:namespace": "AWS/Cassandra" en su nombre. CloudWatch Este rol se crea automáticamente. Para obtener más información, consulte Uso de roles para las transmisiones de los CDC de Amazon Keyspaces.

Cassandra Query Language (CQL)
Habilite una transmisión (transmisión de CDC) con CQL

Se puede utilizar ALTER TABLE para habilitar una transmisión en una tabla existente.

  1. El siguiente ejemplo crea una secuencia que solo captura los cambios en las claves de partición y agrupamiento de una fila modificada.

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

  2. Para comprobar la configuración de la transmisión, puede utilizar la siguiente declaración.

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

    El resultado de la declaración tiene un aspecto similar al siguiente.

     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:aws-region: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
Cree una transmisión de los CDC con AWS CLI

  1. Para crear una transmisión para una tabla existente, puede usar la siguiente sintaxis.

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

  2. El resultado de ese comando muestra la create-table respuesta estándar y tiene un aspecto similar al de este ejemplo.

    { "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/mykeyspace/table/mytable" }
Console
Habilite una transmisión de CDC con la consola Amazon Keyspaces

  1. Inicia sesión en la AWS Management Console consola de Amazon Keyspaces y ábrela desde casahttps://console.aws.amazon.com/keyspaces/.

  2. En el panel de navegación, selecciona Tablas y, a continuación, selecciona una tabla de la lista.

  3. Seleccione la pestaña Streams.

  4. Seleccione Editar para activar una transmisión.

  5. Selecciona Activar transmisiones.

  6. Selecciona Ver el tipo de transmisión. Están disponibles las siguientes opciones. Ten en cuenta que no puedes cambiar el tipo de visualización de una transmisión una vez creada.

    • Imágenes nuevas y antiguas: Amazon Keyspaces captura ambas versiones de la fila, antes y después del cambio. Esta es la opción predeterminada.

    • Imagen nueva: Amazon Keyspaces captura solo la versión de la fila después del cambio.

    • Imagen antigua: Amazon Keyspaces captura solo la versión de la fila anterior al cambio.

    • Solo clave principal: Amazon Keyspaces captura solo las columnas clave de partición y agrupamiento de la fila que se ha modificado.

  7. Para terminar, selecciona Guardar cambios.