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

# 步驟 5：檢視文件的修訂歷史記錄
<a name="getting-started-step-5"></a>

**重要**  
支援終止通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱[將 Amazon QLDB Ledger 遷移至 Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)。

使用 VIN 修改車輛的註冊資料後` 1N4AL11D75C109151`，您可以查詢其所有已註冊擁有者的歷史記錄，以及任何其他更新的欄位。您可以透過查詢內建 來查看您插入、更新和刪除的文件的所有修訂[歷史記錄函數](working.history.md#working.history.function)。

歷史記錄函數會從資料表的*遞交檢視*傳回修訂，其中包括您的應用程式資料和相關聯的中繼資料。中繼資料確切顯示每個修訂的時間、順序，以及遞交它們的交易。

在此步驟中，您會查詢 `vehicle-registration` 分類帳中`VehicleRegistration`資料表中文件的修訂歷史記錄。

**檢視修訂歷史記錄**

1. 在 [https://console.aws.amazon.com/qldb](https://console.aws.amazon.com/qldb)：// 開啟 Amazon QLDB 主控台。

1. 在導覽窗格中，選擇 **PartiQL 編輯器**。

1. 選擇`vehicle-registration`分類帳。

1. 若要查詢文件的歷史記錄，請先尋找其唯一的 `id`。除了查詢遞交檢視之外，取得文件的另一種方法是`id`使用資料表預設使用者檢視中的`BY`關鍵字。如需進一步了解，請參閱 [使用 BY 子句查詢文件 ID](working.metadata.by-clause.md)。

   在查詢編輯器視窗中，輸入下列陳述式，然後選擇**執行**。

   ```
   SELECT r_id FROM VehicleRegistration AS r BY r_id
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

1. 接下來，您可以使用此`id`值來查詢歷史記錄函數。輸入下列陳述式，然後選擇**執行**。請務必視需要將`id`值取代為您自己的文件 ID。

   ```
   SELECT h.data.VIN, h.data.City, h.data.Owners
   FROM history(VehicleRegistration) AS h
   WHERE h.metadata.id = 'ADR2LQq48kB9neZDupQrMm' --replace with your id
   ```
**注意**  
基於本教學的目的，此歷史記錄查詢會傳回文件 ID 的所有修訂`ADR2LQq48kB9neZDupQrMm`。不過，最佳實務是，使用文件 ID 和日期範圍 （開始時間和結束時間） 來限定歷史記錄查詢。  
在 QLDB 中，每個`SELECT`查詢都會在交易中處理，並受到[交易逾時限制](limits.md#limits.fixed)。包含開始時間和結束時間的歷史記錄查詢可受益於日期範圍資格。如需詳細資訊，請參閱[歷史記錄函數](working.history.md#working.history.function)。

   歷史記錄函數會在與遞交檢視相同的結構描述中傳回文件。此範例會投影您修改過的車輛註冊資料。輸出應看起來如下列內容。  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/qldb/latest/developerguide/getting-started-step-5.html)
**注意**  
歷史記錄查詢不一定會依序傳回文件修訂。

   檢閱輸出並確認變更反映您在 中執行的動作[步驟 4：修改分類帳中的文件](getting-started-step-4.md)。

1. 然後，您可以檢查每個修訂的文件中繼資料。輸入下列陳述式，然後選擇**執行**。同樣地，請務必視需要將`id`值取代為您自己的文件 ID。

   ```
   SELECT VALUE h.metadata
   FROM history(VehicleRegistration) AS h
   WHERE h.metadata.id = 'ADR2LQq48kB9neZDupQrMm' --replace with your id
   ```

   輸出應看起來如下列內容。  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/qldb/latest/developerguide/getting-started-step-5.html)

   這些中繼資料欄位提供有關每個項目修改時間以及交易依據的詳細資訊。您可以從此資料推斷下列項目：
   + 文件由系統指派 唯一識別`id`：`ADR2LQq48kB9neZDupQrMm`。這是以 Base62-encoded字串表示的通用唯一識別碼 (UUID)。
   + `txTime` 顯示文件 （版本 `0`) 的初始修訂是在 建立`2019-05-23T19:20:360d-3Z`。
   + 每個後續交易都會建立新的修訂，其中包含相同的文件 `id`、遞增的版本編號，以及更新的 `txId`和 `txTime`。

若要在`vehicle-registration`分類帳中以密碼編譯方式驗證文件修訂，請繼續 [步驟 6：驗證分類帳中的文件](getting-started-step-6.md)。