View a markdown version of this page

Acceda a los registros de las transmisiones de los CDC 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.

Acceda a los registros de las transmisiones de los CDC en Amazon Keyspaces

Para acceder a los registros de una transmisión, utilice el API Amazon Keyspaces Streams. La siguiente sección contiene ejemplos sobre cómo acceder a los registros mediante el AWS CLI.

Para conocer los permisos necesarios, consulte Configure los permisos para trabajar con las transmisiones de los CDC en Amazon Keyspaces.

Acceda a los registros de una transmisión mediante el AWS CLI
  1. Puede usar la API Amazon Keyspaces Streams para acceder a los registros de cambios de la transmisión. Para obtener más información, consulte Referencia de la API Amazon Keyspaces Streams. Para recuperar los fragmentos de la secuencia, puedes utilizar el get-stream La API, como se muestra en el siguiente ejemplo.

    aws keyspacesstreams get-stream \ --stream-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable/stream/STREAM_LABEL'

    A continuación se muestra un ejemplo de la salida.

    { "StreamArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable/stream/2023-05-11T21:21:33.291", "StreamStatus": "ENABLED", "StreamViewType": "NEW_AND_OLD_IMAGES", "CreationRequestDateTime": "<CREATION_TIME>", "KeyspaceName": "mykeyspace", "TableName": "mytable", "StreamLabel": "2023-05-11T21:21:33.291", "Shards": [ { "SequenceNumberRange": { "EndingSequenceNumber": "<END_SEQUENCE_NUMBER>", "StartingSequenceNumber": "<START_SEQUENCE_NUMBER>" }, "ShardId": "<SHARD_ID>" }, ] }
  2. Para recuperar los registros de la transmisión, empieza por obtener un iterador que te proporcione el punto de partida para acceder a los registros. Para ello, puede usar los fragmentos de la transmisión de los CDC devueltos por la API en el paso anterior. Para recopilar el iterador, puedes usar el get-shard-iterator API. Para este ejemplo, se usa un iterador del tipo TRIM_HORIZON que se recupera del último punto recortado (o principio) del fragmento.

    aws keyspacesstreams get-shard-iterator \ --stream-arn 'arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable/stream/STREAM_LABEL' \ --shard-id 'SHARD_ID' \ --shard-iterator-type 'TRIM_HORIZON'

    El resultado del comando es similar al del ejemplo siguiente.

    { "ShardIterator": "<SHARD_ITERATOR>" }
  3. Para recuperar los registros de los CDC mediante el get-records La API, puede usar el iterador devuelto en el último paso. El siguiente comando es un ejemplo de esto.

    aws keyspacesstreams get-records \ --shard-iterator 'SHARD_ITERATOR' \ --limit 100

    A continuación se muestra un ejemplo de la salida.

    { "changeRecords": [...], "nextShardIterator": "<NEXT_SHARD_ITERATOR>", "iteratorDescription": { "iteratorPosition": "BEHIND_TIP" } }

Optimice la frecuencia de sondeo con la posición del iterador

El GetRecords la respuesta incluye un iteratorDescription campo que indica la posición actual de su consumidor dentro del fragmento:

  • AT_TIP — No hay más registros disponibles actualmente. Considere reducir la frecuencia de las votaciones para optimizar los costos.

  • BEHIND_TIP — La punta del arroyo avanza continuamente. Es posible que haya registros adicionales disponibles. Continúe votando con su frecuencia normal.

BEHIND_TIP con un vacío changeRecords la lista indica que la transmisión está en progreso, pero no hay registros de clientes disponibles en esta posición. Continúe sondeando con normalidad.