最大版本數(shù)

創(chuàng)建數(shù)據(jù)表時，如果未設置最大版本數(shù)，則系統(tǒng)會使用默認值1，您也可以自定義屬性列的最大版本數(shù)。創(chuàng)建數(shù)據(jù)表后，您可以通過UpdateTable接口修改數(shù)據(jù)表的最大版本數(shù)。

超過最大版本數(shù)的數(shù)據(jù)版本為無效數(shù)據(jù)，即使系統(tǒng)還未刪除數(shù)據(jù)，用戶已無法讀取對應數(shù)據(jù)。

• 當調小最大版本數(shù)時，如果數(shù)據(jù)版本個數(shù)超過新設的最大版本數(shù)，系統(tǒng)會異步刪除較早版本的數(shù)據(jù)。

• 當調大最大版本數(shù)時，如果系統(tǒng)還未刪除超過舊的最大版本數(shù)的對應版本數(shù)據(jù)，且對應版本數(shù)據(jù)在新設的最大版本數(shù)范圍中，則對應版本的數(shù)據(jù)可以重新讀取。

版本號

為數(shù)據(jù)表配置最大版本數(shù)后，當您每次更新屬性列的值時，表格存儲均會為該值生成一個新版本，版本的值即為版本號（時間戳），單位為毫秒。

在屬性列中寫入數(shù)據(jù)時，如果未設置版本號，則系統(tǒng)會自動生成數(shù)據(jù)的版本號，您也可以自定義數(shù)據(jù)的版本號。 由于版本號的單位為毫秒，在進行TTL比較和有效版本偏差計算時，需要除以1000換算成秒。

• 當由系統(tǒng)自動生成數(shù)據(jù)的版本號時，系統(tǒng)默認將當前時間的毫秒單位時間戳（從1970-01-01 00:00:00 UTC計算起的毫秒數(shù)）作為屬性列值的版本號。

• 當自定義數(shù)據(jù)的版本號時，屬性列值的版本號需要為64位的毫秒單位時間戳且在有效版本范圍內。

使用版本號，您可以實現(xiàn)以下功能：

• 數(shù)據(jù)生命周期（TTL）

  版本號可以用于定義數(shù)據(jù)表中屬性列值的生命周期。當屬性列中數(shù)據(jù)的保留時長超過設置的TTL后，系統(tǒng)會自動異步清理對應版本號的數(shù)據(jù)。

  例如數(shù)據(jù)的版本號為1468944000000（即2016-07-20 00:00:00 UTC+8），如果設置數(shù)據(jù)表的TTL為86400（一天），則該版本號的數(shù)據(jù)會在2016-07-21 00:00:00 UTC+8過期，系統(tǒng)會自動異步刪除該版本號的數(shù)據(jù)。

• 每行數(shù)據(jù)的版本讀取

  讀取行數(shù)據(jù)時，您可以指定每列最多讀取的版本個數(shù)或者讀取的版本號范圍。更多信息，請參見讀取數(shù)據(jù)。

數(shù)據(jù)生命周期

數(shù)據(jù)生命周期是數(shù)據(jù)表的一個屬性，即數(shù)據(jù)的保存時間，單位為秒。當屬性列中數(shù)據(jù)的保留時間超過設置的TTL時，系統(tǒng)會自動異步清理超過該屬性列的數(shù)據(jù)。如果一行中所有屬性列中數(shù)據(jù)的保留時間均超過了TTL，則系統(tǒng)會自動異步清理該行數(shù)據(jù)。

例如數(shù)據(jù)表的TTL設置為86400（一天），在2016-07-21 00:00:00 UTC+8時，數(shù)據(jù)表中所有版本號小于1468944000000（除以1000換算成秒后即2016-07-20 00:00:00 UTC+8）的屬性列數(shù)據(jù)均會過期，系統(tǒng)會自動異步清理對應過期數(shù)據(jù)。

創(chuàng)建數(shù)據(jù)表時，如果未設置TTL，則系統(tǒng)會使用默認值-1（表示數(shù)據(jù)永不過期），您也可以自定義TTL。創(chuàng)建數(shù)據(jù)表后，您可以通過UpdateTable接口修改TTL。

超過TTL的過期數(shù)據(jù)為無效數(shù)據(jù)，即使系統(tǒng)還未刪除數(shù)據(jù)，用戶已無法讀取對應數(shù)據(jù)。

• 當調小TTL時，數(shù)據(jù)表中可能會有數(shù)據(jù)過期，系統(tǒng)會異步刪除對應過期數(shù)據(jù)。

• 當調大TTL時，如果系統(tǒng)還未刪除在舊的TTL之外以前版本的數(shù)據(jù)，且對應版本數(shù)據(jù)在新設的TTL中，則對應版本的數(shù)據(jù)可以重新讀取。

有效版本偏差

為了避免寫入數(shù)據(jù)時，自定義的時間戳與當前時間的偏差超過了數(shù)據(jù)表的TTL，導致寫入的數(shù)據(jù)立即過期的問題，您可以設置有效版本偏差。

有效版本偏差（Max Version Offset）是指定的數(shù)據(jù)版本號與系統(tǒng)當前時間偏差的允許最大值，單位為秒。有效版本偏差為正整數(shù)，可以大于1970-01-01 00:00:00 UTC時間到當前時間的秒數(shù)。

為了保證數(shù)據(jù)寫入成功，在寫入數(shù)據(jù)時系統(tǒng)會檢查屬性列數(shù)據(jù)的版本號。屬性列數(shù)據(jù)的有效版本范圍為[max{數(shù)據(jù)寫入時間-有效版本偏差,數(shù)據(jù)寫入時間-數(shù)據(jù)生命周期}，數(shù)據(jù)寫入時間+有效版本偏差)。只有當屬性列數(shù)據(jù)的版本號（單位為毫秒）除以1000換算為秒后在有效版本范圍時，才能成功寫入數(shù)據(jù)。

例如當數(shù)據(jù)表的有效版本偏差為86400（一天），在2016-07-21 00:00:00 UTC+8時，只能寫入版本號大于1468944000000（換算成秒后即2016-07-20 00:00:00 UTC+8）并且小于1469116800000（換算成秒后即2016-07-22 00:00:00 UTC+8）的數(shù)據(jù)。當某一行的某個屬性列數(shù)據(jù)的版本號為1468943999000（換算成秒后即2016-07-19 23:59:59 UTC+8）時，該行數(shù)據(jù)寫入失敗。

創(chuàng)建數(shù)據(jù)表時，如果未設置有效版本偏差，則系統(tǒng)會使用默認值86400，您也可以自定義數(shù)據(jù)有效版本偏差。創(chuàng)建數(shù)據(jù)表后，您可以通過UpdateTable接口修改有效版本偏差。

使用方式

創(chuàng)建數(shù)據(jù)表時，您可以配置最大版本數(shù)、數(shù)據(jù)生命周期等參數(shù)。您也可以在創(chuàng)建數(shù)據(jù)表后修改數(shù)據(jù)版本、數(shù)據(jù)生命周期等。此處以創(chuàng)建數(shù)據(jù)表后修改相應配置為例介紹。

alter -t mytable --ttl 86400 --version 1

private static void updateTable(SyncClient client) {
    //數(shù)據(jù)的過期時間，單位為秒，-1表示數(shù)據(jù)永不過期。
    int timeToLive = -1;
    //將最大版本數(shù)更新為5。
    int maxVersions = 5; 
    //將有效版本偏差更新為86400。單位為秒。
    int maxTimeDeviation=86400;
    TableOptions tableOptions = new TableOptions(timeToLive, maxVersions,maxTimeDeviation);
    //設置表名稱。
    UpdateTableRequest request = new UpdateTableRequest("<TABLE_NAME>");
    request.setTableOptionsForUpdate(tableOptions);
    client.updateTable(request);
}

計費說明

• 使用數(shù)據(jù)多版本時，會產生基于版本號與各個版本數(shù)據(jù)的額外存儲費用。

• 配置生命周期管理清理數(shù)據(jù)，不會有額外的數(shù)據(jù)清理費用。但開啟生命周期管理功能后，會在各個屬性列增加時間戳作為的版本號數(shù)據(jù)，有額外的存儲量產生。

更多信息，請參見數(shù)據(jù)存儲量。

常見問題

修改數(shù)據(jù)表生命周期時報錯[table ttl] must be bigger than or equal search index ttl