Activer un flux CDC pour une table existante dans Amazon Keyspaces - Amazon Keyspaces (pour Apache Cassandra)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Activer un flux CDC pour une table existante dans Amazon Keyspaces

Pour activer un flux CDC pour une table existante, vous pouvez utiliser l'ALTER TABLEinstruction dans CQL, la update-table commande avec le AWS CLI, ou vous pouvez utiliser la console.

Pour chaque ligne modifiée du tableau, Amazon Keyspaces peut enregistrer les modifications suivantes en fonction view_type de celle cdc_specification que vous avez sélectionnée :

  • NEW_AND_OLD_IMAGES— les deux versions de la ligne, avant et après la modification. Il s’agit de l’option par défaut.

  • NEW_IMAGE— la version de la ligne après la modification.

  • OLD_IMAGE— la version de la ligne avant la modification.

  • KEYS_ONLY— les clés de partition et de clustering de la ligne qui a été modifiée.

Pour plus d'informations sur la façon de baliser un flux, consultezAjouter de nouveaux tags à un stream.

Note

Amazon Keyspaces CDC nécessite la présence d'un rôle lié à un service (AWSServiceRoleForAmazonKeyspacesCDC) qui publie les données métriques provenant des flux Amazon Keyspaces CDC sur votre compte en votre nom"cloudwatch:namespace": "AWS/Cassandra". CloudWatch Ce rôle est créé automatiquement pour vous. Pour de plus amples informations, veuillez consulter Utilisation de rôles pour les flux CDC d'Amazon Keyspaces.

Cassandra Query Language (CQL)
Activer un flux (flux CDC) avec CQL

Vous pouvez l'utiliser ALTER TABLE pour activer un flux pour une table existante.

  1. L'exemple suivant crée un flux qui capture uniquement les modifications apportées aux clés de partition et de clustering d'une ligne modifiée.

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

  2. Pour vérifier les paramètres de diffusion, vous pouvez utiliser l'instruction suivante.

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

    Le résultat de l'instruction ressemble à ceci.

     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
Créez un flux CDC avec le AWS CLI

  1. Pour créer un flux pour une table existante, vous pouvez utiliser la syntaxe suivante.

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

  2. La sortie de cette commande montre la create-table réponse standard et ressemble à cet exemple.

    { "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/mykeyspace/table/mytable" }
Console
Activer un flux CDC avec la console Amazon Keyspaces

  1. Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.

  2. Dans le volet de navigation, choisissez Tables, puis choisissez une table dans la liste.

  3. Choisissez l'onglet Streams.

  4. Choisissez Modifier pour activer un flux.

  5. Sélectionnez Activer les streams.

  6. Choisissez le type d'affichage du flux. Les options suivantes sont disponibles. Notez que vous ne pouvez pas modifier le type de vue d'un flux une fois celui-ci créé.

    • Nouvelles et anciennes images : Amazon Keyspaces capture les deux versions de la ligne, avant et après la modification. Il s’agit de l’option par défaut.

    • Nouvelle image — Amazon Keyspaces capture uniquement la version de la ligne après la modification.

    • Ancienne image — Amazon Keyspaces capture uniquement la version de la ligne avant la modification.

    • Clé primaire uniquement : Amazon Keyspaces capture uniquement les colonnes clés de partition et de clustering de la ligne modifiée.

  7. Pour terminer, choisissez Enregistrer les modifications.