本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon Keyspaces 中的查詢中使用用戶端時間戳記
<a name="client-side-timestamps-how-to-queries"></a>

開啟用戶端時間戳記之後，您可以使用 `USING TIMESTAMP`子句在 `INSERT`、 `UPDATE`和 `DELETE`陳述式中傳遞時間戳記。

時間戳記值`bigint`代表自稱為 的標準基準時間以來的微秒數epoch：1970 年 1 月 1 日，格林威治標準時間 00：00：00。由用戶端提供的時間戳記必須介於過去 2 天到未來 5 分鐘之間，從目前的牆壁時鐘時間起算。

Amazon Keyspaces 會在資料生命週期內保留時間戳記中繼資料。您可以使用 `WRITETIME`函數來查詢過去幾年發生的時間戳記。如需 CQL 語法的詳細資訊，請參閱 [Amazon Keyspaces 中的 DML 陳述式 （資料處理語言）](cql.dml.md)。

下列 CQL 陳述式是如何使用時間戳記做為 的範例`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;
```

如果您未在 CQL 查詢中指定時間戳記，Amazon Keyspaces 會使用用戶端驅動程式傳遞的時間戳記。如果用戶端驅動程式未提供時間戳記，Amazon Keyspaces 會為您的寫入操作指派伺服器端時間戳記。

若要查看為特定資料欄存放的時間戳記值，您可以在`SELECT`陳述式中使用 `WRITETIME`函數，如下列範例所示。

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