Use carimbos de data/hora do lado do cliente em consultas no Amazon Keyspaces

Depois de ativar os carimbos de data/hora do lado do cliente, você pode passar o carimbo de data/hora em suas declaraçõesINSERT, UPDATE e DELETE com a cláusula USING TIMESTAMP.

O valor do timestamp bigint representa um número de microssegundos desde a hora base padrão conhecida como epoch: 1º de janeiro de 1970 às 00:00:00 GMT. Um carimbo de data/hora fornecido pelo cliente deve estar entre o intervalo de 2 dias no passado e 5 minutos no futuro a partir do horário atual do relógio.

O Amazon Keyspaces mantém metadados de carimbo de data/hora durante a vida útil dos dados. Você pode usar a função WRITETIME para pesquisar registros de data e hora que ocorreram anos atrás. Para obter mais informações sobre sintaxe de CQL, consulte Declarações DML (linguagem de manipulação de dados) no Amazon Keyspaces.

A instrução CQL a seguir é um exemplo de como usar um carimbo de data/hora como um 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;

Se você não especificar um carimbo de data/hora na sua consulta CQL, o Amazon Keyspaces usará o carimbo de data/hora passado pelo seu driver de cliente. Se nenhum carimbo de data/hora for fornecido pelo driver de cliente, o Amazon Keyspaces atribuirá um carimbo de data/hora do lado do servidor para sua operação de gravação.

Para ver o valor do carimbo de data/hora armazenado em uma coluna específica, você pode usar a função WRITETIME em uma instrução SELECT, conforme mostrado no exemplo a seguir.

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;