Uso de marcas de tiempo del cliente en consultas en Amazon Keyspaces

Una vez activadas las marcas de tiempo del cliente, puede pasar la marca de tiempo en sus instrucciones INSERT, UPDATE y DELETE con la cláusula USING TIMESTAMP.

El valor de la marca de tiempo es un bigint que representa un número de microsegundos desde la hora base estándar conocida como epoch: 1 de enero de 1970 a las 00:00:00 GMT. Una marca de tiempo proporcionada por el cliente tiene que caer en el rango de 2 días en el pasado a 5 minutos en el futuro desde la hora actual del reloj de pared.

Amazon Keyspaces conserva los metadatos de marca de tiempo durante toda la vida de los datos. Puede utilizar la función WRITETIME para buscar marcas de tiempo que ocurrieron años atrás. Para obtener más información sobre la sintaxis CQL, consulte DMLdeclaraciones (lenguaje de manipulación de datos) en Amazon Keyspaces.

La siguiente instrucción CQL es un ejemplo de cómo utilizar una marca de tiempo como update_parameter.

INSERT INTO catalog.book_awards (year, award, rank, category, book_title, author, publisher)
   VALUES (2022, 'Wolf', 4, 'Non-Fiction', 'Science Update', 'Ana Carolina Silva', 'SomePublisher') 
   USING TIMESTAMP 1669069624;

Si no especifica una marca de tiempo en su consulta CQL, Amazon Keyspaces utiliza la marca de tiempo transferida por su controlador de cliente. Si el controlador de cliente no proporciona ninguna marca de tiempo, Amazon Keyspaces asigna una marca de tiempo del lado del servidor para su operación de escritura.

Para ver el valor de marca de tiempo que se almacena para una columna específica, puede utilizar la función WRITETIME en una instrucción SELECT como se muestra en el siguiente ejemplo.

SELECT year, award, rank, category, book_title, author, publisher, WRITETIME(year), WRITETIME(award), WRITETIME(rank),
  WRITETIME(category), WRITETIME(book_title), WRITETIME(author), WRITETIME(publisher) from catalog.book_awards;