

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.

# Utiliser les horodatages côté client dans les requêtes dans Amazon Keyspaces
<a name="client-side-timestamps-how-to-queries"></a>

Après avoir activé les horodatages côté client, vous pouvez transmettre l'horodatage dans vos instructions`INSERT`,`UPDATE`, et avec la clause. `DELETE` `USING TIMESTAMP` 

La valeur d'horodatage `bigint` représente un nombre de microsecondes depuis l'heure de base standard connue sous le nom de epoch : 1er janvier 1970 à 00:00:00 GMT. Un horodatage fourni par le client doit se situer entre 2 jours dans le passé et 5 minutes dans le futur par rapport à l'heure actuelle de l'horloge murale.

Amazon Keyspaces conserve les métadonnées d'horodatage pendant toute la durée de vie des données. Vous pouvez utiliser cette `WRITETIME` fonction pour rechercher les horodatages survenus il y a des années. Pour plus d'informations sur la syntaxe CQL, consultez[Instructions DML (langage de manipulation de données) dans Amazon Keyspaces](cql.dml.md).

L'instruction CQL suivante est un exemple d'utilisation d'un horodatage en tant que. `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 vous ne spécifiez pas d'horodatage dans votre requête CQL, Amazon Keyspaces utilise l'horodatage transmis par le pilote de votre client. Si aucun horodatage n'est fourni par le pilote client, Amazon Keyspaces attribue un horodatage côté serveur pour votre opération d'écriture. 

Pour voir la valeur d'horodatage stockée pour une colonne spécifique, vous pouvez utiliser la `WRITETIME` fonction dans une `SELECT` instruction, comme illustré dans l'exemple suivant. 

```
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;
```