翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Keyspaces のクエリでクライアント側のタイムスタンプを使用する
<a name="client-side-timestamps-how-to-queries"></a>

クライアント側のタイムスタンプを有効にすると、`USING TIMESTAMP` 節の `INSERT`、`UPDATE`、および `DELETE` ステートメントにそのタイムスタンプを句とともに渡すことができます。

タイムスタンプ値は、epoch という標準基準時刻 1970 年 1 月 1 日 00:00:00 GMT からのマイクロ秒数をを表す`bigint` です。クライアントから提供されるタイムスタンプは、現在のウォールクロックタイムから過去 2 日間と未来の 5分間の範囲とします。

Amazon Keyspaces は、データの存続期間中、タイムスタンプのメタデータを保持します。`WRITETIME` 関数で、数年前に発生したタイムスタンプを検索できます。構文の詳細については、「[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 は書き込み操作にサーバー側のタイムスタンプを割り当てます。

特定の列に保存されているタイムスタンプ値を確認するには、次の例のように `WRITETIME` 関数を `SELECT` ステートメントで使用できます。

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